Method: customers.suggestBrands

この顧客の接頭辞に基づいて一致するブランドのリストを返す RPC です。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
customerId

string

必須。ブランド提案オペレーションを適用する顧客の ID。

リクエスト本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現 
{
  "selectedBrands": [
    string
  ],
  "brandPrefix": string
}
フィールド
selectedBrands[]

string

省略可。広告主がすでに選択したブランドの ID。レスポンスでは除外されます。ブランド名ではなくブランド ID を使用する必要があります。
brandPrefix

string

必須。ブランド名の接頭辞。

レスポンスの本文

BrandSuggestionService.SuggestBrands に対するレスポンス メッセージです。

成功すると、レスポンスの本文に次の構造のデータが含まれます。

JSON 表現 
{
  "brands": [
    {
      object (BrandSuggestion)
    }
  ]
}
フィールド
brands[]

object (BrandSuggestion)

指定されたプレフィックスに対して確認済みのブランドのブランド候補を生成しました。

承認スコープ

次の OAuth スコープが必要です。

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

詳細については、OAuth 2.0 の概要をご覧ください。

BrandSuggestion

ブランド提案の情報。

JSON 表現 
{
  "id": string,
  "name": string,
  "urls": [
    string
  ],
  "state": enum (BrandState)
}
フィールド
id

string

ブランドの ID。検証済み/グローバル スコープのブランドの場合、CKG MID になります。
name

string

ブランドの名前。
urls[]

string

ブランドを一意に識別する URL。
state

enum (BrandState)

ブランドの現状。