API Báo cáo Search Ads 360 mới hiện đã ra mắt. Tham gia nhóm Google searchads-api-announcements để luôn được cập nhật về những cải tiến và bản phát hành sắp tới.
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Trang này giả định bạn đã quen thuộc với hướng dẫn dành cho nhà phát triển về Thiết kế hướng đến tài nguyên và Tên tài nguyên, đồng thời bổ sung cho các hướng dẫn đó thông tin chi tiết về cách triển khai cụ thể của API Báo cáo Search Ads 360.
Thiết kế dựa trên tài nguyên
Nhìn chung, Search Ads 360 Reporting API tuân theo thiết kế hướng đến tài nguyên, được mô hình hoá dưới dạng bộ sưu tập các tài nguyên có thể định địa chỉ riêng lẻ (danh từ của API).
Tài nguyên được tham chiếu theo tên tài nguyên và được thao tác bằng một nhóm nhỏ gồm các phương thức (còn gọi là động từ hoặc phép toán).
Những tên tài nguyên và phương thức này, được kết hợp với một tiền tố phiên bản API cụ thể, sẽ bao gồm các URL của giao diện REST.
Ví dụ: Bạn có thể chia URL dưới đây thành các thành phần riêng lẻ theo bảng sau:
Tất cả URL REST cho một phiên bản API cụ thể (ví dụ: v0) có chung một tiền tố phiên bản API. Tên tài nguyên và phương thức cùng nhau xác định dịch vụ API nào đang được gọi.
API Báo cáo Search Ads 360 sử dụng nhiều phương thức tuỳ chỉnh, trái ngược với hầu hết các API REST truyền thống sử dụng các phương thức REST chuẩn như list và get. API Báo cáo Search Ads 360 bao gồm hai phương thức tuỳ chỉnh: search và searchStream.
Các trang sau đây trình bày chi tiết hơn về tên tài nguyên, phương thức dịch vụ và quy ước đặt tên JSON của API Báo cáo Search Ads 360 để minh hoạ cách sử dụng các tên này cùng nhau nhằm xác định các điểm cuối giao diện REST.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-29 UTC."],[[["\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."]]
