API yapısı kılavuzunda belirtildiği gibi, Google Ads API'deki her üst düzey kaynağın, kaynak örneklerinin değiştirilmesini destekleyen, kaynak türüne özgü bir hizmeti vardır.
Bu kılavuzda, CampaignService kullanılarak Campaign nesnelerinin nasıl değiştirileceği gösterilmektedir ancak aynı kavramlar, kaynağa özgü diğer tüm hizmetler için de geçerlidir.
Nesneleri değiştirme
Her kaynağa özgü hizmette, bir mutasyon isteğini kabul eden bir mutate yöntemi bulunur. Bu istek şunlardan oluşur:
customerId- Bir dizi işlem
- Değiştirilebilir kaynağın mı yoksa yalnızca kaynak adının mı mutasyondan sonra döndürülmesi gerektiğini belirleyen bir yanıt içerik türü ayarı.
Örneğin, MutateCampaigns yöntemi, CampaignService aşağıdaki öğelerden oluşan bir MutateCampaignsRequest kabul eder:
customerIdCampaignOperationnesnelik koleksiyon- Tercih edilen yanıt türünü belirten
response_content_typealanı.
İşlemler
CampaignOperation gibi bir işlem nesnesi, operation alanını ayarlayarak tek bir kaynakta gerçekleştirmek istediğiniz işlemi belirtmenize olanak tanır. Bu alan, türü kaynak türü olan aşağıdaki özelliklerden oluşan bir oneof alanıdır:
create- Kaynağın yeni bir örneğini oluşturur.
update- Kaynağı,
updatekaynağının özellikleriyle eşleşecek şekilde günceller. Bu alan ayarlandığında, Google Ads API'ye güncelleme işlemi sırasında hangi özelliklerin değiştirileceğini bildirenupdate_maskişlemini de ayarlamanız gerekir. Her istemci kitaplığında, istemci kitaplıklarımızda gösterildiği gibiupdate_maskoluşturacak bir yardımcı program veya yardımcı yöntem bulunur. remove- Kaynağı kaldırır.
operation alanı bir oneof alanı olduğundan birden fazla nesneyi tek bir işlemle değiştiremezsiniz. Örneğin, bir kampanya oluşturup başka bir kampanyayı kaldırmak istiyorsanız isteğinize CampaignOperation iki örnek ekleyin: biri create ayarlanmış, diğeri ise remove ayarlanmış olsun.
Toplu işlemler
Tek bir işlem yalnızca tek bir kaynak oluşturabilir, güncelleyebilir veya kaldırabilir. Ancak tek bir mutate isteği birden fazla işlem içerebilir. Her biri tek bir işlem içeren birden fazla değiştirme isteği göndermek yerine işlemlerinizi tek bir değiştirme isteğinde birleştirmelisiniz.
Örneğin, on kampanya oluşturmak istiyorsanız on CampaignOperation nesnesi içeren tek bir MutateCampaignsRequest göndermeniz gerekir.
Yanıtları değiştirme
Yanıtın ne döndüreceği, mutate isteğinin response_content_type bölümünde gönderilenlere bağlıdır. Örneğin, MUTABLE_RESOURCE belirtilmişse yanıt yalnızca kampanyadaki değiştirilebilir alanları içerir. Ardından, bu kaynak nesnesini yeniden oluşturmak zorunda kalmadan takip eden mutasyonlar yapabilirsiniz.
Değişiklik hataları
Belirli bir değiştirme isteğindeki işlemler, yalnızca istekteki her işlem başarılı olursa Google Ads hesabınıza uygulanır. Sık karşılaşılan hataların listesi ve bu hataların nasıl giderileceği hakkında bilgi edinmek için sık karşılaşılan hatalar kılavuzuna göz atın.