Google Ads API'nin tasarımı, geleneksel bir REST mimarisinden farklıdır. Bunun nedeni, daha geleneksel olan list
, get
, create
, update
ve delete
yöntemleri yerine öncelikle search
ve mutate,
gibi özel yöntemleri kullanması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, bir kampanya değiştirme API çağrısında aşağıdaki URL kullanılır:
https://googleads.googleapis.com/v21/customers/1234567890/campaigns:mutate
API'nin özel yöntemler kullanmasının bir nedeni, birden fazla işlemin tek bir API isteğinde toplu olarak gönderilmesini sağlamaktır. Katı REST semantiği, aynı anda yalnızca bir kampanyanın güncellenmesine izin verirdi. Örneğin, bir kampanyaya yönelik geleneksel bir REST
update
işlemi için kampanya kaynağı başına bir HTTP PATCH isteği gönderilmesi gerekir.
Google Ads API, birçok işlemin tek bir istek gövdesinde birlikte paketlenmesine izin vermek için çoğu kaynak için özel bir mutate
yöntemi tanımlar.
Benzer şekilde, API'den toplu okuma (aynı anda birçok nesne getirme) işlemini etkinleştirmek için API, SQL benzeri bir Google Ads sorgu dili ile özel bir search
yöntemi kullanır.
Sık kullanılan yöntemler sayfasında, Google Ads API'de en sık kullanılan yöntemler ayrıntılı olarak açıklanmaktadır.