- HTTP isteği
- Yol parametreleri
- İstek metni
- Yanıt metni
- 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/v14/customers/{customerId}/customerAssetSets:mutate
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler | |
---|---|
customerId |
Zorunlu. Müşteri öğ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 ( |
Alanlar | |
---|---|
operations[] |
Zorunlu. Ayrı ayrı müşteri öğesi grupları üzerinde gerçekleştirilecek işlemlerin listesi. |
partialFailure |
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 |
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 |
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 müşteri öğ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 ( |
Alanlar | |
---|---|
results[] |
Değişimle ilgili tüm sonuçlar. |
partialFailureError |
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.
CustomerAssetSetOperation
Müşteri öğesi grubunda tek bir işlem (oluşturma, kaldırma).
JSON gösterimi |
---|
{ // Union field |
Alanlar | |
---|---|
operation alanı. Değiştirme 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ı olması gerekir: |
MutateCustomerAssetSetResult
Müşteri öğesi grubu değişikliğinin sonucu.
JSON gösterimi |
---|
{
"resourceName": string,
"customerAssetSet": {
object ( |
Alanlar | |
---|---|
resourceName |
Başarılı işlemler için iade edildi. |
customerAssetSet |
Değişimden sonra yalnızca değişebilir alanlara sahip olacak şekilde değiştirilmiş müşteri öğesi grubu. Bu alan yalnızca yanıtContentType, "MUTABLE_RESOURCE" olarak ayarlandığında döndürülür. |