Method: customers.suggestBrands

Rpc, bu müşteri için bir ön eke göre eşleşen markaların bir listesini döndürür.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
customerId

string

Zorunlu. Marka önerisi işleminin uygulanacağı müşterinin kimliği.

İstek içeriği

İstek gövdesi, aşağıdaki yapıyla birlikte veriler içerir:

JSON gösterimi 
{
  "selectedBrands": [
    string
  ],
  "brandPrefix": string
}
Alanlar
selectedBrands[]

string

İsteğe bağlı. Reklamverenler tarafından halihazırda seçilmiş olan markaların kimlikleri. Yanıt olarak hariç tutulacaktır. Bunların marka adı değil, marka kimliği olması beklenir.
brandPrefix

string

Zorunlu. Marka adının öneki.

Yanıt gövdesi

BrandSuggestionService.SuggestBrands için yanıt mesajı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "brands": [
    {
      object (BrandSuggestion)
    }
  ]
}
Alanlar
brands[]

object (BrandSuggestion)

Belirtilen ön ek için doğrulanmış markalar için marka önerileri oluşturuldu.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleye bakın.

BrandSuggestion

Marka önerisi bilgileri.

JSON gösterimi 
{
  "id": string,
  "name": string,
  "urls": [
    string
  ],
  "state": enum (BrandState)
}
Alanlar
id

string

Marka kimliği. Doğrulanmış/global kapsamlı markalar için CKG MID olur.
name

string

Markanın adı.
urls[]

string

Markayı benzersiz bir şekilde tanımlayan URL'ler.
state

enum (BrandState)

Markanın mevcut durumu.

BrandState

Farklı marka durumlarının sıralaması.

Sıralamalar
UNSPECIFIED Değer belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
ENABLED Marka doğrulandı ve dünya genelinde seçilebilir
DEPRECATED Marka, geçmişte tüm dünyada kullanılabilse de artık geçerli bir marka değil (işletme ölçütlerine göre)
UNVERIFIED Marka doğrulanmamış ve müşteri kapsamlı ancak hedefleme için müşteri (yalnızca aynısını isteyen) tarafından seçilebilir
APPROVED İşletme tarafından onaylanan ve global listeye eklenen müşteri kapsamlı (doğrulanmamış) bir markaydı. Bunun yerine, atanmış CKG MID'si kullanılmalıdır.
CANCELLED Müşteri kapsamlı (doğrulanmamış) bir markaydı ancak istek müşteri tarafından iptal edildi ve bu marka kimliği artık geçerli değil
REJECTED Müşteri kapsamlı (doğrulanmamış) bir markaydı ancak istek dahili işletme ekibi tarafından reddedildi ve bu marka kimliği artık geçerli değil