Method: customers.customAudiences.mutate

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

Atılan hataların listesi: AuthenticationError AuthorizationError CustomAudienceError CustomInterestError FieldError FieldMaskError HeaderError InternalError MutateError OperationAccessDeniedErrorPolicyViolationErrorQuotaErrorRequestError

HTTP isteği

POST https://googleads.googleapis.com/v14/customers/{customerId}/customAudiences:mutate

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

Yol parametreleri

Parametreler
customerId

string

Zorunlu. Özel kitleleri değiştirilen müşterinin kimliği.

İstek içeriği

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

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

object (CustomAudienceOperation)

Zorunlu. Ayrı özel kitleler üzerinde gerçekleştirilecek işlemlerin listesi.
validateOnly

boolean

Doğru değerine ayarlanırsa istek doğrulanır ancak yürütülmez. Sonuçlar değil, yalnızca hatalar döndürülür.

Yanıt gövdesi

Özel kitle değişikliği 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 (MutateCustomAudienceResult)
    }
  ]
}
Alanlar
results[]

object (MutateCustomAudienceResult)

Değişimle ilgili 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'a Genel Bakış başlıklı makaleye bakın.

CustomAudienceOperation

Özel kitle üzerinde 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 (CustomAudience)
  },
  "update": {
    object (CustomAudience)
  },
  "remove": string
  // 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, tam nitelikli alan adlarının virgülle ayrılmış bir listesidir. Örnek: "user.displayName,photo".
operation alanı. Değiştirme işlemi. operation şunlardan yalnızca biri olabilir:
create

object (CustomAudience)

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

object (CustomAudience)

Güncelleme işlemi: Özel kitlenin geçerli bir kaynak adına sahip olması beklenir.
remove

string

Kaldırma işlemi: Kaldırılan özel kitle için şu biçimde bir kaynak adı beklenir:

customers/{customerId}/customAudiences/{custom_audience_id}

MutateCustomAudienceResult

Özel kitle değişikliğinin sonucu.

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

string

Başarılı işlemler için iade edildi.