API yapısı kılavuzunda açıklandığı gibi, Google Ads API'deki her üst düzey kaynağın, aşağıdakileri destekleyen, kaynak türüne özel bir hizmeti vardır:
- Kaynak ö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ılır ancak aynı kavramlar, kaynak türüne özgü diğer tüm hizmetler için de geçerlidir.
Nesneleri değiştirme
Kaynak türüne özel her hizmetin, değişim isteğini kabul eden bir mutate yöntemi vardır. Bu isteğin içeriği:
customerId- İşlemler koleksiyonu
- Mutasyondan sonra değişebilir kaynağın mı yoksa yalnızca kaynak adının mı döndürüleceğini belirleyen bir yanıt içerik türü ayarı.
Örneğin, CampaignService MutateCampaigns yöntemi şunlardan oluşan bir MutateCampaignsRequest kabul eder:
customerIdCampaignOperationnesneden oluşan koleksiyon- Tercih edilen yanıt türünü gösteren
response_content_typealanı.
İşlemler
CampaignOperation gibi bir işlem nesnesi, tek bir kaynak üzerinde gerçekleştirmek istediğiniz işlemi operation alanını ayarlayarak belirtmenize olanak tanır. Bu alan, türü kaynak türü olan aşağıdaki özelliklerden oluşan bir 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, işleminupdate_maskdeğerini de ayarlamanız gerekir. Bu değer, Google Ads API'ye güncelleme işlemi sırasında hangi özelliklerin değiştirilmesi gerektiğini bildirir. İstemci kitaplıklarımızda gösterildiği gibi her istemci kitaplığının,update_masköğesini sizin için oluşturacak bir yardımcı programı veya yardımcı yöntemi vardır. remove- Kaynağı kaldırır.
operation alanı 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 iki CampaignOperation örneği ekleyin: Birinde create, diğerinde ise remove ayarlanmış.
Toplu işleme işlemleri
Tek bir işlem yalnızca tek bir kaynağı oluşturabilir, güncelleyebilir veya kaldırabilir ancak tek bir değişiklik isteği birden fazla işlem içerebilir. Her biri tek bir işlem içeren birden çok değişken 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 CampaignOperation nesnesi içeren tek bir MutateCampaignsRequest göndermeniz gerekir.
Yanıtları değiştirme
Yanıtta ne döndürüleceği, değişiklik isteğinin response_content_type içinde neyin 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 bu kaynak nesnesinde takip değişiklikleri yapabilirsiniz.
Hataları değiştirme
Belirli bir değişiklik isteğindeki işlemlerin Google Ads hesabınıza uygulanması için istekteki her işlemin başarılı olması gerekir. Yaygın hataların bir listesi ve nasıl düzeltilecekleriyle ilgili bilgi edinmek için yaygın hatalar kılavuzunu inceleyin.
Nesneleri get ile inceleme (Kullanımdan kaldırıldı)
Nesneleri değiştirmenin yanı sıra kaynak türüne özel her hizmet, tek bir kaynağın tüm özelliklerini almak için bir get yöntemine de sahiptir.
Bu yöntem, tek özelliği resource_name olan bir alma isteğini kabul eder.
Get yöntemleri, tek bir nesnenin tüm özelliklerinin alınmasını kolaylaştırmak için Google Ads API tarafından sunulan bir kolaylıktır. Bu, API'yi öğrenmek veya hata ayıklama ya da eğitim amacıyla tek bir nesneyi incelemek için ideal bir araç olsa da uygulamanız, işleme veya raporlama amacıyla nesneleri almak için get yöntemleri kullanmamalıdır. Bunun yerine, nesnelerin yalnızca belirli özelliklerini almanıza izin verdiği, performans metriklerini almayı desteklediği ve büyük sonuç kümeleriyle akışa izin verdiği için GoogleAdsService kullanın. Uygulamanız çok sayıda alma isteği gönderirse oran sınırlamalarıyla karşılaşabilirsiniz.