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:
customerId
CampaignOperation
nesneden oluşan koleksiyon- Tercih edilen yanıt türünü gösteren
response_content_type
alanı.
İş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ğı,
update
kaynağının özellikleriyle eşleşecek şekilde günceller. Bu alan ayarlandığında, işleminupdate_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ş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.