ReachPlanService

Reach Plan Service gives users information about audience size that can be reached through advertisement on YouTube. In particular, GenerateReachForecast provides estimated number of people of specified demographics that can be reached by an ad in a given market by a campaign of certain duration with a defined budget.

GenerateConversionRates

rpc GenerateConversionRates(GenerateConversionRatesRequest) returns (GenerateConversionRatesResponse)

Returns a collection of conversion rate suggestions for supported plannable products.

List of thrown errors: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview.

GenerateReachForecast

rpc GenerateReachForecast(GenerateReachForecastRequest) returns (GenerateReachForecastResponse)

Generates a reach forecast for a given targeting / product mix.

List of thrown errors: AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError ReachPlanError RequestError

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview.

ListPlannableLocations

rpc ListPlannableLocations(ListPlannableLocationsRequest) returns (ListPlannableLocationsResponse)

Returns the list of plannable locations (for example, countries).

List of thrown errors: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview.

ListPlannableProducts

rpc ListPlannableProducts(ListPlannableProductsRequest) returns (ListPlannableProductsResponse)

Returns the list of per-location plannable YouTube ad formats with allowed targeting.

List of thrown errors: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview.

ListPlannableUserLists

rpc ListPlannableUserLists(ListPlannableUserListsRequest) returns (ListPlannableUserListsResponse)

Returns the list of plannable user lists with their plannable status. User lists may not be plannable for a number of reasons, including: - They are less than 10 days old. - They have a membership lifespan that is less than 30 days - They have less than 10,000 or more than 700,000 users.

List of thrown errors: AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError ReachPlanError RequestError

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview.