- HTTP isteği
- Yol parametreleri
- İstek gövdesi
- Yanıt gövdesi
- Yetkilendirme kapsamları
- CustomerAssetSetOperation
- MutateCustomerAssetSetResult
- Deneyin.
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/v17/customers/{customerId}/customerAssetSets:mutate
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler | |
---|---|
customerId |
Zorunlu. Müşteri öğesi grupları değiştirilen müşterinin kimliği. |
İstek içeriği
İstek gövdesi, aşağıdaki yapıya sahip verileri içerir:
JSON gösterimi |
---|
{ "operations": [ { object ( |
Alanlar | |
---|---|
operations[] |
Zorunlu. Bağımsız müşteri öğesi gruplarında gerçekleştirilecek işlemlerin listesi. |
partialFailure |
Değer true ise 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çerli olduğunda tek bir işlemde gerçekleştirilir. Varsayılan değer, false'tur. |
validateOnly |
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. |
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
Müşteri öğesi grubu değişimi 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 ( |
Alanlar | |
---|---|
results[] |
Değişim için tüm sonuçlar. |
partialFailureError |
Kısmi hata modundaki işlem hatalarıyla ilgili hatalar. Yalnızca kısmiFailure = true olduğunda ve tüm hatalar işlemlerin içinde oluştuğunda döndürülür. İşlemlerin dışında herhangi bir hata oluşursa (örneğin, 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 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.
CustomerAssetSetOperation
Müşteri öğesi grubunda tek bir işlem (oluşturma, kaldırma).
JSON gösterimi |
---|
{ // Union field |
Alanlar | |
---|---|
Birleştirme alanı operation . Değişim işlemi. operation şunlardan yalnızca biri olabilir: |
|
create |
Oluşturma işlemi: Yeni müşteri öğesi grubu için kaynak adı beklenmiyor. |
remove |
Kaldırma işlemi: Kaldırılan müşteri öğesi grubu için şu biçimde bir kaynak adı bekleniyor: |
MutateCustomerAssetSetResult
Müşteri öğesi grubunun sonucu değişir.
JSON gösterimi |
---|
{
"resourceName": string,
"customerAssetSet": {
object ( |
Alanlar | |
---|---|
resourceName |
Başarılı işlemler sonucunda iade edildi. |
customerAssetSet |
Değişimden sonra yalnızca değiştirilebilir alanlarla ayarlanmış müşteri öğesi grubu. Alan yalnızca responseContentType "MUTABLE_SOURCE" olarak ayarlandığında döndürülür. |