Method: contentOwners.list

Retrieves a list of content owners that match the request criteria.

HTTP request

GET https://youtubepartner.googleapis.com/youtube/partner/v1/contentOwners

The URL uses gRPC Transcoding syntax.

Query parameters

Parameters
fetchMine

boolean

The fetchMine parameter restricts the result set to content owners associated with the currently authenticated API user.

id

string

The id parameter specifies a comma-separated list of YouTube content owner IDs to retrieve.

onBehalfOfContentOwner

string

The onBehalfOfContentOwner parameter identifies the content owner that the user is acting on behalf of. This parameter supports users whose accounts are associated with multiple content owners.

Request body

The request body must be empty.

Response body

A list of content owners returned in response to a contentOwners.list call.

If successful, the response body contains data with the following structure:

JSON representation
{
  "kind": string,
  "items": [
    {
      object (ContentOwner)
    }
  ]
}
Fields
kind

string

The type of the API response. For this operation, the value is youtubePartner#contentOwnerList.

items[]

object (ContentOwner)

A list of content owners that match the request criteria.

Authorization scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/youtubepartner
  • https://www.googleapis.com/auth/youtubepartner-content-owner-readonly

For more information, see the OAuth 2.0 Overview.