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/v14/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ş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 (AdGroupAssetSetOperation)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean,
  "responseContentType": enum (ResponseContentType)
}
Alanlar
operations[]

object (AdGroupAssetSetOperation)

Zorunlu. Bağımsız reklam grubu öğe gruplarında gerçekleştirilecek işlemlerin listesi.
partialFailure

boolean

Doğru değerine ayarlanırsa başarılı işlemler gerçekleştirilir ve geçersiz işlemler hata döndürür. Yanlış değerine ayarlanırsa tüm işlemler, yalnızca tümü geçerliyse ve yalnızca geçerliyse tek bir işlemde gerçekleştirilir. Varsayılan değer, false (yanlış) değeridir.
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.
responseContentType

enum (ResponseContentType)

Yanıt içerik türü ayarı. Mutasyondan sonra değişken 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 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 (MutateAdGroupAssetSetResult)
    }
  ],
  "partialFailureError": {
    object (Status)
  }
}
Alanlar
results[]

object (MutateAdGroupAssetSetResult)

Değişimle ilgili tüm sonuçlar.
partialFailureError

object (Status)

Kısmi hata modundaki işlem hatalarıyla ilgili hatalar. Yalnızca kısmiFailure = true olduğunda ve işlemlerde tüm hatalar ortaya çıktığında 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ı makaleye bakın.

AdGroupAssetSetOperation

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
operation alanı. Değiştirme işlemi. operation şunlardan yalnızca biri olabilir:
create

object (AdGroupAssetSet)

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

string

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

MutateAdGroupAssetSetResult

Reklam grubu öğe grubu değişikliğinin sonucu.

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

string

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

object (AdGroupAssetSet)

Değişimden sonra yalnızca değişebilir alanlara sahip olacak şekilde değiştirilmiş reklam grubu öğesi. Bu alan yalnızca yanıtContentType, "MUTABLE_RESOURCE" olarak ayarlandığında döndürülür.