Method: campaigns.get

  • This webpage details how to retrieve a specific YouTube campaign using its ID.

  • The request is made using a GET HTTP request to a specific URL, including the campaign ID in the path.

  • It uses the onBehalfOfContentOwner query parameter to specify the content owner when the user manages multiple accounts.

  • The request body must be empty, and the successful response body will contain campaign details.

  • Retrieving campaigns requires authorization with the https://www.googleapis.com/auth/youtubepartner OAuth scope.

Retrieves a particular campaign for an owner.

HTTP request

GET https://youtubepartner.googleapis.com/youtube/partner/v1/campaigns/{campaignId}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
campaignId

string

The campaignId parameter specifies the YouTube campaign ID of the campaign being retrieved.

Query parameters

Parameters
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

If successful, the response body contains an instance of Campaign.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/youtubepartner

For more information, see the OAuth 2.0 Overview.