API yapı kılavuzunda açıklandığı gibi, Google Ads API'deki her üst düzey kaynağın aşağıdakileri destekleyen, ilgili bir kaynak türüne özel hizmeti vardır:
- Kaynağın örneklerini değiştirme
- İnceleme için kaynağın tek bir örneğini alma
Bu kılavuzda, Campaign nesnelerinin değiştirilmesini ve denetlenmesini göstermek için CampaignService kullanılacaktır ancak aynı kavramlar diğer tüm kaynak türüne özel hizmetler için geçerlidir.
Nesne değiştirme
Kaynak türüne özgü her bir hizmetin, değiştirme isteğini kabul eden bir mutate yöntemi bulunur. Bu istek şunları içeriyor:
customerId- İşlemlerin bir koleksiyonu
- Değişken kaynağın mı yoksa yalnızca kaynak adının mı döndürüleceğini belirleyen yanıt içerik türü ayarı.
Örneğin, CampaignService için MutateCampaigns yöntemi şunlardan oluşan bir MutateCampaignsRequest kabul eder:
customerIdCampaignOperationnesne koleksiyonu- Tercih edilen yanıt türünü belirten
response_content_typealanı.
İşlemler
CampaignOperation gibi bir işlem nesnesi, tek bir kaynakta gerçekleştirmek istediğiniz işlemi, kaynağın operation alanını ayarlayarak belirtmenizi sağlar. Bu alan, türü kaynak türü olan aşağıdaki özelliklerden oluşan bir alandı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_masközelliğini de ayarlamanız gerekir. İstemci kitaplıklarımızda gösterildiği gibi her istemci kitaplığı,update_masköğesini sizin için oluşturacak bir yardımcı yöntem veya yardımcı yöntem içerir. 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şturup başka bir kampanyayı kaldırmak isterseniz isteğinize biri create ve diğeri remove olmak üzere iki CampaignOperation örneği ekleyin.
Toplu işlem işlemleri
Tek bir işlem yalnızca tek bir kaynağı oluşturabilir, güncelleyebilir veya kaldırabilse de 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şiklik isteğinde birleştirmeniz gerekir.
Örneğin, on kampanya oluşturmak istiyorsanız on adet CampaignOperation nesne içeren tek bir MutateCampaignsRequest göndermeniz gerekir.
Yanıtları değiştir
Yanıtta nelerin döndürüleceği, değiştirme isteğinin response_content_type öğesinde nelerin gönderildiğine bağlıdır. Örneğin, MUTABLE_RESOURCE belirtilmişse yanıt yalnızca kampanyadaki değişken alanları içerir. Daha sonra, yeniden oluşturmak zorunda kalmadan kaynak nesnesinde ek değişiklikler yapabilirsiniz.
Değişiklik hataları
Belirli bir değişiklik 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 bunları nasıl ele alacağınızı için yaygın hatalar rehberine göz atın.
Nesneleri get ile inceleme (Kullanımdan kaldırıldı)
Nesneleri değiştirmenin yanı sıra, her kaynak türüne özel hizmetin tek bir kaynağın tüm özelliklerini almak için bir get yöntemi de vardır.
Bu yöntem, tek özelliği resource_name olan bir alma isteğini kabul eder.
Alma yöntemleri, tek bir nesnenin tüm özelliklerini almayı kolaylaştırmak için Google Ads API tarafından sunulan bir kolaylıktır. Bu, API'yi öğrenmek veya bağımsız bir nesneyi hata ayıklama ya da eğitim amaçlı olarak incelemek için harika bir araç olsa da uygulamanız, nesneleri işlemek veya raporlamak üzere alma yöntemlerini kullanmamalıdır. Bunun yerine, nesnelerin yalnızca belirli özelliklerini almanıza izin verdiğinden, performans metriklerini almayı desteklediğinden ve büyük sonuç kümelerinde akışa olanak tanıdığından GoogleAdsService kullanın. Uygulamanız çok sayıda alma isteği gönderirse hız sınırlarıyla karşılaşabilirsiniz.