Method: customers.suggestBrands

Rpc to return a list of matching brands based on a prefix for this customer.

HTTP request

POST https://googleads.googleapis.com/v16/customers/{customerId}:suggestBrands

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
customerId

string

Required. The ID of the customer onto which to apply the brand suggestion operation.

Request body

The request body contains data with the following structure:

JSON representation 
{
  "selectedBrands": [
    string
  ],
  "brandPrefix": string
}
Fields
selectedBrands[]

string

Optional. Ids of the brands already selected by advertisers. They will be excluded in response. These are expected to be brand ids not brand names.
brandPrefix

string

Required. The prefix of a brand name.

Response body

Response message for BrandSuggestionService.SuggestBrands.

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

JSON representation 
{
  "brands": [
    {
      object (BrandSuggestion)
    }
  ]
}
Fields
brands[]

object (BrandSuggestion)

Generated brand suggestions of verified brands for the given prefix.

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview.

BrandSuggestion

Information of brand suggestion.

JSON representation 
{
  "id": string,
  "name": string,
  "urls": [
    string
  ],
  "state": enum (BrandState)
}
Fields
id

string

Id for the brand. It would be CKG MID for verified/global scoped brands.
name

string

Name of the brand.
urls[]

string

Urls which uniquely identify the brand.
state

enum (BrandState)

Current state of the brand.