Hizmet Yöntemleri

Google Ads API'nin tasarımı, daha geleneksel list, get, create, update ve delete yöntemleri yerine öncelikle search ve mutate, gibi özel yöntemler kullandığından geleneksel REST mimarisinden farklıdır. Bu işlemler, özel fiili URL'nin geri kalanından ayırmak için : HTTP eşleme kuralı kullanılarak REST URL'lerinde ifade edilir.

Örneğin, kampanyayı değiştirme API çağrısı aşağıdaki URL'yi kullanır:

https://googleads.googleapis.com/v19/customers/1234567890/campaigns:mutate

API'nin özel yöntemler kullanmasının bir nedeni, birden fazla işlemin tek bir API isteğinde toplanmasını sağlamaktır. Katı REST semantikleri, aynı anda yalnızca bir kampanyanın güncellenmesine izin verir. Örneğin, bir kampanyaya yönelik geleneksel bir REST update, kampanya kaynağı başına bir HTTP PATCH isteği gönderilmesini gerektirir.

Google Ads API, birçok işlemin tek bir istek gövdesinde gruplandırılmasına izin vermek için çoğu kaynak için özel bir mutate yöntemi tanımlar. Benzer şekilde, API'den toplu okumaları (tek seferde birçok nesneyi getirme) etkinleştirmek için API, SQL benzeri bir Google Ads Sorgu Dili içeren özel bir search yöntemi kullanır.

Yaygın yöntemler sayfasında, Google Ads API'de en sık kullanılan yöntemler ayrıntılı olarak açıklanmaktadır.