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 .
    Design a Mobile Site
    View Site in Mobile | Classic
    Share by: