Hizmet Yöntemleri

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

Örneğin, bir kampanya mutate API çağrısı şu URL'yi kullanır:

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

API'nin özel yöntemler kullanmasının nedenlerinden biri, birden çok işlemi tek bir API isteğinde gruplandırmayı etkinleştirmektir. Katı REST semantiği, bir kerede yalnızca bir kampanyanın güncellenmesine olanak tanır. Örneğin, bir geleneksel REST update bir kampanya kaynağı başına bir HTTP PATCH isteği gönderilmesini gerektirir.

Google Ads API, birçok işlemin tek bir istek gövdesinde birleştirilmesine izin vermek için bunun yerine çoğu kaynak için özel bir mutate yöntemi tanımlar. Benzer şekilde API'den toplu okuma yapmak (aynı anda birçok nesneyi getirmek) için API, SQL benzeri bir Google Ads Sorgu Dili içeren özel bir search yöntemi kullanır.

Yaygın yöntemler sayfası, Google Ads API'de en sık kullanılan yöntemler hakkında ayrıntılı bilgi verir.