Method: customers.customInterests.mutate

Özel ilgi alanları oluşturur veya bunları günceller. İşlem durumları döndürülür.

Atılan hataların listesi: AuthenticationError AuthorizationError CriterionError CustomInterestError HeaderError InternalError MutateError PolicyViolationError QuotaError RequestError StringLengthError

HTTP isteği

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

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

Yol parametreleri

Parametreler
customerId

string

Zorunlu. Özel ilgi alanları değiştirilen müşterinin kimliği.

İstek içeriği

İstek metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "operations": [
    {
      object (CustomInterestOperation)
    }
  ],
  "validateOnly": boolean
}
Alanlar
operations[]

object (CustomInterestOperation)

Zorunlu. Ayrı özel ilgi alanlarında yapılacak işlemlerin listesi.
validateOnly

boolean

True (doğru) ise istek doğrulanır ancak yürütülmez. Yalnızca hatalar döndürülür, sonuç döndürülmez.

Yanıt gövdesi

Özel ilgi alanı değiştirme işlemi için yanıt mesajı.

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

JSON gösterimi 
{
  "results": [
    {
      object (MutateCustomInterestResult)
    }
  ]
}
Alanlar
results[]

object (MutateCustomInterestResult)

Değişim için tüm sonuçlar.

Yetkilendirme kapsamları

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

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

Daha fazla bilgi için OAuth 2.0 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.

CustomInterestOperation

Özel bir ilgi alanında tek bir işlem (oluşturma, güncelleme).

JSON gösterimi 
{
  "updateMask": string,

  // Union field operation can be only one of the following:
  "create": {
    object (CustomInterest)
  },
  "update": {
    object (CustomInterest)
  }
  // End of list of possible types for union field operation.
}
Alanlar
updateMask

string (FieldMask format)

Bir güncellemede hangi kaynak alanlarının değiştirileceğini belirleyen FieldMask.

Bu, alanların tam nitelikli adlarının virgülle ayrılmış bir listesidir. Örnek: "user.displayName,photo".
Birleştirme alanı operation. Değiştirme işlemi. operation şunlardan yalnızca biri olabilir:
create

object (CustomInterest)

Oluşturma işlemi: Yeni özel ilgi alanı için kaynak adı beklenmiyor.
update

object (CustomInterest)

Güncelleme işlemi: Özel ilgi alanının geçerli bir kaynak adına sahip olması gerekir.

MutateCustomInterestResult

Özel ilgi alanı mutasyonu sonucu.

JSON gösterimi 
{
  "resourceName": string
}
Alanlar
resourceName

string

Başarılı işlemler için döndürülür.