Method: customers.googleAds.mutate

Kaynak oluşturur, günceller veya kaldırır. Bu yöntem, birden fazla kaynak türüyle atom işlemlerini destekler. Örneğin, anatomik olarak bir kampanya ve kampanya bütçesi oluşturabilir veya binlerce mutasyon işlemi gerçekleştirebilirsiniz.

Bu yöntem temel olarak bir dizi değiştirme yöntemi etrafında sarmalayıcıdır. Bu yöntemleri doğrudan çağırmak yerine sunduğu tek özellik:

  • Atomik işlemler
  • Geçici kaynak adları (aşağıda açıklanmıştır)
  • Bir dizi değişen çağrıya kıyasla gecikme biraz azaldı

Not: Yalnızca atomik işlemleri destekleyen kaynaklar dahil edildiğinden bu yöntem, bağımsız hizmetlere yapılan tüm çağrıların yerini alamaz.

Atomic İşlemlerinin Avantajları

Atomicity, hataları ele alma işlemini çok daha kolaylaştırır. Bir dizi değişiklik yaptıktan sonra değişiklik başarısız olursa, hesabınız tutarsız bir durumda olabilir. Atomik özelliği kullandığınızda, seçilen duruma doğrudan ulaşırsınız veya istek başarısız olur ve yeniden deneyebilirsiniz.

Geçici Kaynak Adları

Geçici kaynak adları, kaynak oluşturmak ve aynı istekte söz konusu kaynağa referans vermek için kullanılan özel bir kaynak adı türüdür. Örneğin, customers/123/campaignBudgets/-1 tutarında resourceName ile bir kampanya bütçesi oluşturulursa kaynak adı, aynı istekteki Campaign.budget alanında yeniden kullanılabilir. Bu sayede iki kaynak da oluşturulur ve atomik olarak birbirine bağlanır.

Geçici kaynak adı oluşturmak için sunucunun normalde ayıracağı ad bölümüne negatif bir sayı ekleyin.

Not:

  • Adın yeniden kullanılabilmesi için kaynakların geçici bir adla oluşturulması gerekir. Örneğin, değiştirme sırası tersine çevrildiğinde önceki CampaignBudget+Campaign örneği başarısız olur.
  • Geçici adlar istekler genelinde hatırlanmaz.
  • Bir istekteki geçici adların sayısıyla ilgili bir sınır yoktur.
  • Kaynak türleri farklı olsa bile her geçici ad için benzersiz bir negatif sayı kullanılmalıdır.

Gecikme

Değişimleri kaynak türüne göre gruplandırmak önemlidir. Aksi takdirde istek zaman aşımına uğrayabilir ve başarısız olabilir. Gecikme yaklaşık olarak bağımsız değişim yöntemlerine yapılan bir dizi çağrıya eşittir. Burada kaynak türündeki her değişiklik yeni bir çağrıdır. Örneğin, 10 kampanya ve ardından 10 reklam grubunun değiştirilmesi 2 arama gibi olurken 1 kampanya, 1 reklam grubu, 1 kampanya, 1 reklam grubunun değiştirilmesi 4 arama gibidir.

<br>köşeyi-4 gün web'de arama yapınAdCustomizerErrorAdErrorAdGroupAdErrorAdGroupCriterionErrorAdGroupErrorAssetErrorAuthenticationErrorAuthorizationErrorBiddingErrorCampaignBudgetErrorCampaignCriterionErrorCampaignErrorCampaignExperimentErrorCampaignSharedSetErrorCollectionSizeErrorContextErrorConversionActionErrorCriterionErrorCustomerFeedErrorDatabaseErrorDateErrorDateRangeErrorDistinctErrorExtensionFeedItemErrorExtensionSettingErrorFeedAttributeReferenceErrorFeedErrorFeedItemErrorFeedItemSetErrorFieldErrorFieldMaskErrorFunctionParsingErrorHeaderErrorImageErrorInternalErrorKeywordPlanAdGroupKeywordErrorKeywordPlanCampaignErrorKeywordPlanErrorLabelErrorListOperationErrorMediaUploadErrorMutateErrorNewResourceCreationErrorNullErrorOperationAccessDeniedErrorPolicyFindingErrorPolicyViolationErrorQuotaErrorRangeErrorRequestErrorResourceCountLimitExceededErrorSettingErrorSharedSetErrorSizeLimitErrorStringFormatErrorStringLengthErrorUrlFieldErrorUserListErrorYoutubeVideoRegistrationError

HTTP isteği

POST https://googleads.googleapis.com/v15/customers/{customerId}/googleAds:mutate

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

Yol parametreleri

Parametreler
customerId

string

Zorunlu. Kaynakları 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 
{
  "mutateOperations": [
    {
      object (MutateOperation)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean,
  "responseContentType": enum (ResponseContentType)
}
Alanlar
mutateOperations[]

object (MutateOperation)

Zorunlu. Ayrı kaynaklar ü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 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. Değişebilir kaynak yalnızca, kaynak uygun yanıt alanına sahipse döndürülür. Örneğin, MutateCampaignResult.campaign.

Yanıt gövdesi

GoogleAdsService.Mutate için yanıt mesajı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "partialFailureError": {
    object (Status)
  },
  "mutateOperationResponses": [
    {
      object (MutateOperationResponse)
    }
  ]
}
Alanlar
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.
mutateOperationResponses[]

object (MutateOperationResponse)

Değişimle ilgili tüm yanıtlar.

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.