روش‌های خدمات

طراحی Google Ads API با معماری سنتی REST متفاوت است زیرا عمدتاً از روش‌های سفارشی مانند search و mutate, به‌جای روش‌های سنتی‌تر list، get، create، update، و delete استفاده می‌کند. این کنش‌ها در نشانی‌های وب REST بااستفاده از قرارداد نگاشت HTTP : برای جدا کردن فعل سفارشی از بقیه نشانی وب بیان می‌شوند.

برای مثال، یک فراخوانی API تغییر پویش از نشانی وب زیر استفاده می‌کند:

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

یکی از دلایلی که API از روش‌های سفارشی استفاده می‌کند، امکان دسته‌بندی چندین عملیات در یک درخواست API است. معناشناسی REST سخت‌گیرانه فقط اجازه می‌دهد یک پویش در هر زمان به‌روز شود. برای مثال، یک REST سنتی update به یک پویش، نیازمند ارسال یک درخواست HTTP PATCH برای هر منبع پویش است.

برای اینکه بتوان عملیات‌های زیادی را در یک بدنه درخواست واحد باهم بسته‌بندی کرد، Google Ads API درعوض یک روش mutate سفارشی برای اکثر منابع تعریف می‌کند. به‌طور مشابه، برای فعال کردن خواندن دسته‌ای (واکشی هم‌زمان چندین شیء) از میانای برنامه‌سازی کاربردی، میانای برنامه‌سازی کاربردی از روش سفارشی search با زبان پُرسمان Google Ads شبیه SQL استفاده می‌کند.

صفحه روش‌های رایج جزئیات بیشتری درباره رایج‌ترین روش‌های مورداستفاده در Google Ads API ارائه می‌دهد.