Chú ý: Bạn đang xem tài liệu về giao diện REST của API. Hầu hết các thư viện ứng dụng chính thức của chúng tôi đều sử dụng gRPC. Hãy xem
Giới thiệu về REST để biết chi tiết.
Phương thức dịch vụ
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.
Thiết kế của Google Ads API khác với cấu trúc REST truyền thống vì API này chủ yếu sử dụng các phương thức tuỳ chỉnh, chẳng hạn như search và mutate, thay vì các phương thức list, get, create, update và delete truyền thống hơn.
Những hành động này được thể hiện trong các URL REST bằng cách sử dụng quy ước ánh xạ HTTP của : để tách động từ tuỳ chỉnh khỏi phần còn lại của URL.
Ví dụ: một lệnh gọi API biến đổi chiến dịch sử dụng URL sau:
https://googleads.googleapis.com/v21/customers/1234567890/campaigns:mutate
Một lý do khiến API sử dụng các phương thức tuỳ chỉnh là để cho phép nhóm nhiều thao tác thành một yêu cầu API duy nhất. Ngữ nghĩa REST nghiêm ngặt sẽ chỉ cho phép cập nhật một chiến dịch tại một thời điểm. Ví dụ: một update REST truyền thống cho một chiến dịch sẽ yêu cầu gửi một yêu cầu HTTP PATCH cho mỗi tài nguyên chiến dịch.
Để cho phép nhiều thao tác được kết hợp với nhau trong một nội dung yêu cầu duy nhất, API Google Ads thay vào đó sẽ xác định một phương thức mutate tuỳ chỉnh cho hầu hết các tài nguyên.
Tương tự, để cho phép đọc theo lô (tìm nạp nhiều đối tượng cùng một lúc) từ API, API này sử dụng một phương thức search tuỳ chỉnh với Ngôn ngữ truy vấn Google Ads tương tự như SQL.
Trang Các phương thức phổ biến trình bày chi tiết về các phương thức thường dùng nhất trong Google Ads API.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-08-27 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-27 UTC."],[[["\u003cp\u003eThe Google Ads API utilizes custom methods like \u003ccode\u003esearch\u003c/code\u003e and \u003ccode\u003emutate\u003c/code\u003e instead of standard REST methods for efficiency and batch operations.\u003c/p\u003e\n"],["\u003cp\u003eThis approach allows for updating multiple campaigns or fetching numerous objects within a single request, unlike traditional REST.\u003c/p\u003e\n"],["\u003cp\u003eCustom methods are expressed in REST URLs using a colon to separate the verb from the rest of the URL, for example, \u003ccode\u003ehttps://googleads.googleapis.com/v18/customers/1234567890/campaigns:mutate\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eBatching operations, like updating many campaigns simultaneously, are enabled through the custom \u003ccode\u003emutate\u003c/code\u003e method, improving efficiency over individual requests.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003esearch\u003c/code\u003e method uses a SQL-like query language for batch reads, enabling retrieval of multiple objects in one API call.\u003c/p\u003e\n"]]],["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"],null,["# Service Methods\n\nThe design of the Google Ads API differs from a traditional REST architecture\nbecause it primarily uses custom methods, such as `search` and `mutate,` instead\nof the more traditional `list`, `get`, `create`, `update`, and `delete` methods.\nThese actions are expressed in REST URLs by using the [HTTP mapping](https://cloud.google.com/apis/design/custom_methods#http_mapping)\nconvention of a `:` to separate the custom verb from the rest of the URL.\n\nFor example, a campaign mutate API call uses the following URL: \n\n https://googleads.googleapis.com/v21/customers/1234567890/campaigns:mutate\n\nOne reason that the API uses custom methods is to enable batching of multiple\noperations into a single API request. Strict REST semantics would only allow\nupdating one campaign at a time. A traditional REST\n[`update`](https://cloud.google.com/apis/design/standard_methods#update) to a\ncampaign, for example, would require sending one HTTP PATCH request per campaign\nresource.\n\nTo allow many operations to be bundled together within a single request body,\nthe Google Ads API instead defines a custom `mutate` method for most resources.\nSimilarly, to enable batch reads (fetching many objects at once) from the API,\nthe API uses a custom `search` method with a SQL-like [Google Ads Query\nLanguage](/google-ads/api/docs/query/overview).\n\nThe [Common methods](/google-ads/api/rest/common/overview) page goes into detail on\nthe most frequently used methods in the Google Ads API."]]
