روش های خدمات

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

به عنوان مثال، یک تماس API جهش یافته کمپین از URL زیر استفاده می کند:

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

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

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

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