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:
customerId
CampaignOperation
nesne koleksiyonu- Tercih edilen yanıt türünü belirten
response_content_type
alanı.
İş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ğı,
update
kaynağı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.