Method: customers.customerAssetSets.mutate

Müşteri öğesi grupları oluşturur veya kaldırır. İşlem durumları döndürülür.

HTTP isteği

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

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

Yol parametreleri

Parametreler
customerId

string

Zorunlu. Müşteri öğe grupları değiştirilen müşterinin kimliği.

İstek içeriği

İsteğin gövdesi, aşağıdaki yapıya sahip veriler içerir:

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

object (CustomerAssetSetOperation)

Zorunlu. Bağımsız müşteri öğe grupları üzerinde 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 hepsinin geçerli olması durumunda tek bir işlemde gerçekleştirilir. Varsayılan değer, false (yanlış) değeridir.
validateOnly

boolean

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.
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 müşteri öğesi 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 (MutateCustomerAssetSetResult)
    }
  ],
  "partialFailureError": {
    object (Status)
  }
}
Alanlar
results[]

object (MutateCustomerAssetSetResult)

Değişim için 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 tüm hatalar işlemler içinde ortaya çıktığında döndürülür. İşlemler dışında herhangi bir hata (ör. kimlik doğrulama hataları) oluşursa 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.

CustomerAssetSetOperation

Müşteri öğesi grubunda tek bir işlem (oluşturma, kaldırma).

JSON gösterimi 
{

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

object (CustomerAssetSet)

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

string

Kaldırma işlemi: Kaldırılan müşteri öğesi grubu için şu biçimde bir kaynak adı olması beklenir: customers/{customerId}/customerAssetSets/{asset_set_id}

MutateCustomerAssetSetResult

Müşteri öğesi grubu değişikliğinin sonucu.

JSON gösterimi 
{
  "resourceName": string,
  "customerAssetSet": {
    object (CustomerAssetSet)
  }
}
Alanlar
resourceName

string

Başarılı operasyonlar için iade edildi.
customerAssetSet

object (CustomerAssetSet)

Dönüştürülmüş müşteri öğesi grubu, yalnızca değişiklikten sonra değişebilir alanlara sahip olacak. Bu alan yalnızca responseContentType, "MUTABLE_RESOURCE" olarak ayarlandığında döndürülür.