روشهای خدمات
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
طراحی Google Ads API با معماری سنتی REST متفاوت است
زیرا عمدتاً از روشهای سفارشی مانند search و mutate, بهجای
روشهای سنتیتر list، get، create، update، و delete استفاده میکند.
این کنشها در نشانیهای وب REST بااستفاده از قرارداد نگاشت HTTP: برای جدا کردن فعل سفارشی از بقیه نشانی وب بیان میشوند.
برای مثال، یک فراخوانی API تغییر پویش از نشانی وب زیر استفاده میکند:
یکی از دلایلی که API از روشهای سفارشی استفاده میکند، امکان دستهبندی چندین عملیات در یک درخواست API است. معناشناسی REST سختگیرانه فقط اجازه میدهد
یک پویش در هر زمان بهروز شود. برای مثال، یک REST سنتی
update به یک
پویش، نیازمند ارسال یک درخواست HTTP PATCH برای هر منبع پویش است.
برای اینکه بتوان عملیاتهای زیادی را در یک بدنه درخواست واحد باهم بستهبندی کرد،
Google Ads API درعوض یک روش mutate سفارشی برای اکثر منابع تعریف میکند.
بهطور مشابه، برای فعال کردن خواندن دستهای (واکشی همزمان چندین شیء) از میانای برنامهسازی کاربردی،
میانای برنامهسازی کاربردی از روش سفارشی search با زبان پُرسمان Google Ads شبیه SQL استفاده میکند.
صفحه روشهای رایج جزئیات بیشتری درباره
رایجترین روشهای مورداستفاده در Google Ads API ارائه میدهد.
تاریخ آخرین بهروزرسانی 2026-10-30 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2026-10-30 بهوقت ساعت هماهنگ جهانی."],[],["The Google Ads API uses custom methods like `search` and `mutate` instead of standard REST methods (e.g., `list`, `get`). This is indicated in URLs by a `:` separator. `Mutate` enables batching multiple operations into one request, unlike standard `update`, which handles one campaign at a time. Similarly, `search` allows fetching multiple objects in a single request, utilizing a SQL-like query language. This deviates from REST conventions to facilitate efficient batch processing and querying.\n"]]