Method: customers.suggestBrands

이 고객의 접두사를 기준으로 일치하는 브랜드 목록을 반환하는 Rpc입니다.

HTTP 요청

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

URL은 gRPC 트랜스코딩 구문을 사용합니다.

경로 매개변수

매개변수
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는 더 이상 유효하지 않습니다.