API جدید Search Ads 360 Reporting اکنون در دسترس است. به گروه Google searchads-api-announcements بپیوندید تا در مورد پیشرفت‌ها و نسخه‌های آینده به‌روز باشید.
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
این صفحه با فرض آشنایی با طراحی منبع گرا و راهنمای توسعه نام منابع و آنها را با جزئیات پیاده سازی خاص Search Ads 360 Reporting API تکمیل می کند.
طراحی منبع محور
به طور کلی، Search Ads 360 Reporting API از یک طراحی منبع محور پیروی می کند که به عنوان مجموعه ای از منابع قابل آدرس دهی جداگانه ( اسم های API) مدل شده است. منابع با نام منابع خود ارجاع داده می شوند و با استفاده از مجموعه کوچکی از روش ها (همچنین به عنوان افعال یا عملیات شناخته می شوند) دستکاری می شوند.
این نام‌ها و روشهایمنابع ، همراه با پیشوند نسخه API خاص، URLهای رابط REST را تشکیل می‌دهند. به عنوان مثال، URL زیر را می توان طبق جدول زیر به این اجزای جداگانه تقسیم کرد:
همه URL های REST برای یک نسخه خاص از API (به عنوان مثال، v0 ) یک پیشوند نسخه مشترک API مشترک دارند. نام منبع و روش با هم مشخص می کند که کدام سرویس API در حال فراخوانی است.
Search Ads 360 Reporting API به شدت از روش های سفارشی استفاده می کند، برخلاف اکثر API های REST سنتی که از روش های استاندارد REST مانند list و get استفاده می کنند. Search Ads 360 Reporting API شامل دو روش سفارشی است: search و searchStream .
صفحات زیر به جزئیات بیشتری درباره نام‌های منابع ، روش‌های سرویس و قراردادهای نام‌گذاری JSON در Search Ads 360 Reporting API می‌پردازند تا نشان دهند که چگونه با هم برای تعریف نقاط پایانی رابط REST استفاده می‌شوند.
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThe Search Ads 360 Reporting API uses a resource-oriented design, where data is organized into collections of resources that can be accessed and manipulated.\u003c/p\u003e\n"],["\u003cp\u003eThe API primarily uses custom methods like \u003ccode\u003esearch\u003c/code\u003e and \u003ccode\u003esearchStream\u003c/code\u003e instead of traditional REST methods.\u003c/p\u003e\n"],["\u003cp\u003eAPI endpoints are constructed using an API version prefix, resource name, and method, which are detailed further in linked documentation.\u003c/p\u003e\n"],["\u003cp\u003eThe guide's examples demonstrate API calls using HTTP, with further instructions available for using the \u003ccode\u003ecurl\u003c/code\u003e command-line utility.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers should be familiar with Resource Oriented Design and Resource Names before using this API.\u003c/p\u003e\n"]]],["The Search Ads 360 Reporting API uses a resource-oriented design with collections of resources accessed via resource names. API calls use HTTP protocol and are structured with a version prefix, resource name, and method. This API primarily employs custom methods, specifically `search` and `searchStream`, instead of standard REST methods. URLs are constructed using the version prefix (e.g., `v0`), a resource name, and a method, defining the specific API service. Further details are available on resource names, service methods, and JSON conventions.\n"],null,["# REST Interface Design\n\nThis page assumes a familiarity with the [Resource Oriented\nDesign](https://cloud.google.com/apis/design/resources) and [Resource\nNames](https://cloud.google.com/apis/design/resource_names) developer guides and\ncomplements them with specific implementation details of the Search Ads 360 Reporting API.\n| **Key Point:** The examples throughout this guide use HTTP protocol to demonstrate how to call the API. See the [Examples](/search-ads/reporting/api/reference/rest/examples) page for how you can make these same API calls using the [`curl`](https://curl.haxx.se/) command line utility.\n\nResource-oriented design\n------------------------\n\nGenerally, the Search Ads 360 Reporting API follows a resource-oriented design, modeled as\n*collections* of individually-addressable *resources* (the *nouns* of the API).\nResources are referenced with their resource names and manipulated using a small\nset of *methods* (also known as *verbs* or *operations*).\n\nThese [resource names](/search-ads/reporting/api/reference/rest/resource-names) and [methods](/search-ads/reporting/api/reference/rest/service-methods), combined\nwith a specific *API version prefix*, comprise the URLs of the REST interface.\nFor example, the URL below can be broken down into these individual components\naccording to the following table: \n\n https://searchads360.googleapis.com/v0/customers/1234567890/searchAds360:search\n\n| API Version Prefix | Resource Name (relative) | Method |\n|------------------------------------------|--------------------------|----------|\n| `https://searchads360.googleapis.com/v0` | `customers/1234567890` | `search` |\n\nAll REST URLs for a particular version of the API (e.g., `v0`)\nshare a common API version prefix. The resource name and method together\nidentifies which API service is being called.\n\nThe Search Ads 360 Reporting API makes heavy use of *custom methods* , as opposed to most\ntraditional REST APIs that use standard REST methods such as `list` and `get`. The Search Ads 360 Reporting API\nincludes two custom methods: `search` and `searchStream`.\n\nThe following pages go into more details about the Search Ads 360 Reporting API's [resource\nnames](/search-ads/reporting/api/reference/rest/resource-names), [service methods](/search-ads/reporting/api/reference/rest/service-methods), and\n[JSON naming conventions](/search-ads/reporting/api/reference/rest/json-mappings) to illustrate how they're used\ntogether to define REST interface endpoints."]]
