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.