Method: customers.suggestBrands

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

HTTP リクエスト

POST https://googleads.googleapis.com/v15/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)

ブランドの現状。

BrandState

さまざまなブランドのステータスを列挙します。

列挙型
UNSPECIFIED 値が指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
ENABLED ブランドは確認済みで、世界中から選択可能です
DEPRECATED ブランドは過去に世界中で利用可能でしたが、現在は有効でなくなっています（ビジネスの条件に基づく）
UNVERIFIED ブランドは未確認で顧客スコープですが、ターゲティング用にブランドを選択（同じことをリクエストした顧客のみ）できます
APPROVED 顧客をスコープとする（未確認の）ブランドであり、ビジネスによって承認され、グローバル リストに追加されている。割り当てられた CKG MID を代わりに使用
CANCELLED 顧客スコープ（未確認）のブランドであったが、リクエストがお客様によってキャンセルされたため、このブランド ID は無効になりました
REJECTED 顧客スコープ（未確認）のブランドであったが、社内のビジネスチームによってリクエストが拒否されたため、このブランド ID は無効になりました