Nesneleri değiştirme

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, Campaign nesnelerinin değiştirilmesini göstermek için CampaignService kullanılacak olsa da aynı kavramlar diğer tüm kaynağa özgü hizmetler için 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, CampaignService yönteminin MutateCampaigns işlevi, aşağıdakilerden oluşan bir MutateCampaignsRequest kabul eder:

• customerId
• CampaignOperation nesnelik koleksiyon
• 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 özellikleriyle eşleşecek şekilde günceller.

kaynak. Bu alan ayarlandığında, Google Ads API'ye güncelleme işlemi sırasında hangi özelliklerin değiştirileceğini bildiren update_mask işlemini de ayarlamanız gerekir. Her istemci kitaplığında, istemci kitaplıklarımızda gösterildiği gibi sizin için update_mask oluş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 iki CampaignOperation örneği 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 isteğin her işlemi 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.

Değişiklikleri izleme

Google Ads hesabınızdaki nesnelerde yapılan değişiklikleri izlemek veya nesnelerin mevcut durumunu almak için change_status ve change_event kaynaklarını kullanabilirsiniz.

• change_status, belirli bir dönemde hangi kaynakların değiştiğinin özetini sağlar.
• change_event, değiştirilen alanların eski ve yeni değerleri de dahil olmak üzere değişikliklerin ayrıntılı geçmişini sağlar.

Bu kaynakları sorgulamak için GoogleAdsService.SearchStream veya GoogleAdsService.Search yöntemini kullanın. GoogleAdsService ile yayın raporlama hakkında daha fazla bilgi edinin.