Method: customers.adGroupAssetSets.mutate

Reklam grubu öğe grupları oluşturur veya kaldırır. İşlem durumları döndürülür.

HTTP isteği

POST https://googleads.googleapis.com/v17/customers/{customerId}/adGroupAssetSets:mutate

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

Yol parametreleri

Parametreler
customerId

string

Zorunlu. Reklam grubu öğe grupları değiştirilmekte olan müşterinin kimliği.

İstek içeriği

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

JSON gösterimi 
{
  "operations": [
    {
      object (AdGroupAssetSetOperation)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean,
  "responseContentType": enum (ResponseContentType)
}
Alanlar
operations[]

object (AdGroupAssetSetOperation)

Zorunlu. Ayrı reklam grubu öğe gruplarında yapılacak işlemlerin listesi.
partialFailure

boolean

Değer true ise başarılı işlemler gerçekleştirilir ve geçersiz işlemler hata döndürür. Yanlış ise tüm işlemler yalnızca geçerli olmaları durumunda tek bir işlemde gerçekleştirilir. Varsayılan değer yanlıştır.
validateOnly

boolean

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

enum (ResponseContentType)

Yanıt içerik türü ayarı. Mutasyondan sonra değişebilir kaynağın mı yoksa yalnızca kaynak adının mı döndürüleceğini belirler.

Yanıt gövdesi

Bir reklam grubu öğe grubu mutasyonu 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 (MutateAdGroupAssetSetResult)
    }
  ],
  "partialFailureError": {
    object (Status)
  }
}
Alanlar
results[]

object (MutateAdGroupAssetSetResult)

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

object (Status)

Kısmi hata modundaki işlem hatalarıyla ilgili hatalar. Yalnızca partialFailure = true olduğunda ve tüm hatalar işlemler içinde gerçekleştiğinde döndürülür. İşlemler dışında herhangi bir hata oluşursa (ör. kimlik doğrulama hataları) RPC düzeyinde bir hata döndürürüz.

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ı makaleyi inceleyin.

AdGroupAssetSetOperation

Bir reklam grubu öğe grubunda tek bir işlem (oluşturma, kaldırma).

JSON gösterimi 
{

  // Union field operation can be only one of the following:
  "create": {
    object (AdGroupAssetSet)
  },
  "remove": string
  // End of list of possible types for union field operation.
}
Alanlar
Birleştirme alanı operation. Değişim işlemi. operation yalnızca aşağıdakilerden biri olabilir:
create

object (AdGroupAssetSet)

Oluşturma işlemi: Yeni reklam grubu öğe grubu için kaynak adı beklenmez.
remove

string

Kaldırma işlemi: Kaldırılan reklam grubu öğe grubu için şu biçimde bir kaynak adı beklenir: customers/{customerId}/adGroupAssetSets/{adGroupId}~{asset_set_id}

MutateAdGroupAssetSetResult

Reklam grubu öğe grubu için sonuç mutasyona uğradı.

JSON gösterimi 
{
  "resourceName": string,
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  }
}
Alanlar
resourceName

string

Başarılı işlemler sonucunda iade edildi.
adGroupAssetSet

object (AdGroupAssetSet)

Değişimden sonra yalnızca değiştirilebilir alanlarla ayarlanmış, değiştirilmiş reklam grubu öğesi. Alan yalnızca responseContentType "MUTABLE_RESOURCE" olarak ayarlandığında döndürülür.