احتیاط: شما در حال مشاهده اسناد رابط REST API هستید. اکثر کتابخانه های مشتری رسمی ما از gRPC استفاده می کنند. برای جزئیات بیشتر به مقدمه REST مراجعه کنید.
با مجموعهها، منظم بمانید
ذخیره و دستهبندی محتوا براساس اولویتهای شما.
این صفحه با فرض آشنایی با طراحی منبع گرا و راهنمای توسعه نام منابع و آنها را با جزئیات پیاده سازی خاص API Google Ads تکمیل می کند.
طراحی منبع محور
به طور کلی، Google Ads API از یک طراحی منبع گرا پیروی می کند که به عنوان مجموعه ای از منابع قابل آدرس دهی جداگانه ( اسم های API) مدل شده است. منابع با نام منابع خود ارجاع داده می شوند و با استفاده از مجموعه کوچکی از روش ها (همچنین به عنوان افعال یا عملیات شناخته می شوند) دستکاری می شوند.
این نام‌ها و روشهایمنابع ، همراه با پیشوند نسخه API خاص، URLهای رابط REST را تشکیل می‌دهند. به عنوان مثال، URL زیر را می توان طبق جدول زیر به این اجزای جداگانه تقسیم کرد:
همه URL های REST برای یک نسخه خاص از API (به عنوان مثال، v19 ) یک پیشوند نسخه مشترک API مشترک دارند. نام منبع و روش با هم مشخص می کند که کدام سرویس API در حال فراخوانی است.
Google Ads API به شدت از روش های سفارشی استفاده می کند، برخلاف اکثر API های REST سنتی که از روش های استاندارد REST مانند list ، get ، create ، update و delete استفاده می کنند. نمونه‌هایی از روش‌های سفارشی در Google Ads API عبارتند از search ، searchStream و mutate .
تاریخ آخرین بهروزرسانی 2025-03-12 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","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"]],["تاریخ آخرین بهروزرسانی 2025-03-12 بهوقت ساعت هماهنگ جهانی."],[[["This guide provides Google Ads API implementation details, assuming familiarity with Resource Oriented Design and Resource Names."],["The Google Ads API uses a resource-oriented design with resources organized into collections and accessed using resource names and methods."],["REST URLs in the API consist of an API version prefix, resource name, and method, with custom methods often used."],["Refer to linked resources for further details on resource names, service methods, and JSON naming conventions within the Google Ads API."],["Examples in the guide use HTTP; see the Examples page for `curl` usage."]]],[]]
