Method: contentOwners.list

  • This API endpoint retrieves a list of YouTube content owners based on specified criteria.

  • The request URL uses gRPC Transcoding syntax, and the request can be filtered by parameters such as fetchMine, id, and onBehalfOfContentOwner.

  • The request body must be empty, and the HTTP method is GET.

  • The response body contains a list of content owners in JSON format, including the kind of response and the items which are the content owners.

  • Accessing this endpoint requires either the https://www.googleapis.com/auth/youtubepartner or https://www.googleapis.com/auth/youtubepartner-content-owner-readonly OAuth scope.

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.