Nesneleri Değiştirme ve İnceleme

API yapısı kılavuzunda belirtildiği gibi, Google Ads API'deki her üst düzey kaynağın, aşağıdakileri destekleyen kaynak türüne özel bir hizmeti vardır:

• Kaynağın örneklerini değiştirme
• İnceleme için kaynağın tek bir örneğini alma

Bu kılavuzda, Campaign nesnelerini değiştirmeyi ve incelemeyi göstermek için CampaignService kullanılacaktır ancak aynı kavramlar, kaynak türüne özgü diğer tüm hizmetler için geçerlidir.

Nesneleri değiştirme

Her kaynak türüne özel hizmette, bir değiştirme isteğini kabul eden bir mutate yöntemi bulunur. Bu istek şunları içerir:

• customerId
• İşlemler koleksiyonu
• Değiştirilebilir kaynağın mı yoksa yalnızca kaynak adının mı mutasyondan sonra döndürüleceğini belirleyen bir yanıt içeriği türü ayarı.

Örneğin, CampaignService sınıfının MutateCampaigns yöntemi aşağıdakilerden oluşan bir MutateCampaignsRequest kabul eder:

• customerId
• CampaignOperation nesnesi koleksiyonu
• Tercih edilen yanıt türünü belirten response_content_type alanı.

İş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ğı, update kaynağının özellikleriyle eşleşecek şekilde günceller. Bu alan ayarlandığında, işlemin update_mask değerini de ayarlamanız gerekir. Bu değer, Google Ads API'ye güncelleme işlemi sırasında hangi özelliklerin değiştirileceğini bildirir. Her istemci kitaplığında, update_mask değerini sizin için oluşturacak bir yardımcı program veya yardımcı yöntem bulunur. Bu, istemci kitaplıklarımızda gösterilmiştir.

remove

Kaynağı kaldırır.

operation alanı bir oneof alanı olduğundan birden fazla nesneyi değiştirmek için tek bir işlem kullanamazsınız. Örneğin, bir kampanya oluşturmak ve başka bir kampanyayı kaldırmak istiyorsanız isteğinize iki CampaignOperation örneği ekleyin: biri create, diğeri remove ile ayarlanmış.

Toplu işlemler

Tek bir işlem yalnızca tek bir kaynak oluşturabilir, güncelleyebilir veya kaldırabilir ancak tek bir değiştirme 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ştirmeniz gerekir.

Ö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ıtta döndürülen değer, mutasyon isteği response_content_type bölümünde gönderilene bağlıdır. Örneğin, MUTABLE_RESOURCE belirtilmişse yanıt yalnızca kampanyadaki değiştirilebilir alanları içerir. Ardından, yeniden oluşturmak zorunda kalmadan bu kaynak nesnesi üzerinde takip eden mutasyonlar yapabilirsiniz.

Değişiklik hataları

Belirli bir değiştirme isteğinde bulunan işlemler, yalnızca istekteki tüm işlemler başarılı olursa Google Ads hesabınıza uygulanır. Sık karşılaşılan hataların listesi ve bunların nasıl giderileceği için sık karşılaşılan hatalar kılavuzuna göz atın.