Nesneleri Değiştirme ve İnceleme

API yapısı kılavuzunda belirtildiği gibi, Google Ads API'deki her üst düzey kaynağın, aşağıdakileri destekleyen kaynak türüne özel bir hizmeti vardır:

• Kaynağın örneklerini değiştirme
• İnceleme için kaynağın tek bir örneğini alma

Bu kılavuzda, Campaign nesnelerini değiştirmeyi ve incelemeyi göstermek için CampaignService kullanılacaktır ancak aynı kavramlar, kaynak türüne özgü diğer tüm hizmetler için geçerlidir.

Nesneleri değiştirme

Her kaynak türüne özel hizmette, bir değiştirme isteğini kabul eden bir mutate yöntemi bulunur. Bu istek şunları içerir:

• customerId
• İşlemler koleksiyonu
• Değiştirilebilir kaynağın mı yoksa yalnızca kaynak adının mı mutasyondan sonra döndürüleceğini belirleyen bir yanıt içeriği türü ayarı.

Örneğin, CampaignService sınıfının MutateCampaigns yöntemi aşağıdakilerden oluşan bir MutateCampaignsRequest kabul eder:

• customerId
• CampaignOperation nesnesi koleksiyonu
• 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 kaynağının özellikleriyle eşleşecek şekilde günceller. Bu alan ayarlandığında, işlemin update_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ştirileceğini bildirir. Her istemci kitaplığında, update_mask değerini sizin için oluşturacak bir yardımcı program veya yardımcı yöntem bulunur. Bu, istemci kitaplıklarımızda gösterilmiştir.

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şturmak ve başka bir kampanyayı kaldırmak istiyorsanız isteğinize iki CampaignOperation örneği ekleyin: biri create, diğeri remove ile ayarlanmış.

Toplu işlemler

Tek bir işlem yalnızca tek bir kaynak oluşturabilir, güncelleyebilir veya kaldırabilir ancak 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ştirme 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 döndürülen öğe, mutasyon isteği 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, yeniden oluşturmak zorunda kalmadan bu kaynak nesnesi üzerinde takip eden mutasyonlar yapabilirsiniz.

Değişiklik hataları

Belirli bir değiştirme isteğinde bulunan işlemler, yalnızca istekteki tüm işlemler başarılı olursa Google Ads hesabınıza uygulanır. Sık karşılaşılan hataların listesi ve bunların nasıl giderileceği için sık karşılaşılan hatalar kılavuzuna göz atın.

get ile nesneleri inceleme (Desteği sonlandı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 get isteğini kabul eder.

Get yöntemleri, tek bir nesnenin tüm özelliklerini almak 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 mükemmel bir araç olsa da uygulamanız, işleme veya raporlama için nesneleri almak üzere get yöntemlerini kullanmamalıdır. Bunun yerine, yalnızca nesnelerin belirli özelliklerini almanıza olanak tanıyan, performans metriklerinin alınmasını destekleyen ve büyük sonuç kümelerinde akışa izin veren GoogleAdsService işlevini kullanın. Uygulamanız çok sayıda get isteği gönderiyorsa hız sınırlarıyla karşılaşabilirsiniz.