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.
Bạn có thể gọi API Google Ads bằng gRPC hoặc REST. Cả hai giao diện đều hiển thị một thiết kế theo hướng tài nguyên được chia sẻ với các API Google Cloud khác.
Bạn nên sử dụng thư viện ứng dụng chính thức của Google bất cứ khi nào có thể. Những mã này cung cấp mã đặc trưng, an toàn về loại với từng ngôn ngữ được hỗ trợ, đồng thời xử lý nhiều chi tiết giao tiếp cấp thấp với API (như
cài đặt thời gian chờ, phân trang kết quả và
xác thực). Thư viện ứng dụng cũng bao gồm một tập hợp ví dụ về mã mở rộng và các tiện ích hỗ trợ cho các thao tác phổ biến, chẳng hạn như tạo tên tài nguyên và xử lý mặt nạ trường.
Hướng dẫn này trình bày thông tin chi tiết dành riêng cho REST và giải thích những điều bạn cần biết để gọi trực tiếp giao diện REST mà không cần sử dụng thư viện ứng dụng được Google hỗ trợ. Hướng dẫn này có thể hữu ích nếu bạn đang viết mã tuỳ chỉnh của riêng mình để sử dụng trực tiếp REST hoặc sử dụng thư viện ứng dụng HTTP của bên thứ ba.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-27 UTC."],[[["\u003cp\u003eGoogle Ads API can be accessed using either gRPC or REST, with gRPC being the recommended method for interacting with the API.\u003c/p\u003e\n"],["\u003cp\u003eOfficial Google client libraries, built on gRPC (except for Perl which uses REST), are strongly encouraged for ease of use and handling low-level communication details.\u003c/p\u003e\n"],["\u003cp\u003eThis guide focuses on using the REST interface directly, primarily for users building custom solutions or using third-party HTTP client libraries.\u003c/p\u003e\n"],["\u003cp\u003eClient libraries provide benefits like idiomatic code, type safety, pagination handling, authentication, and access to code examples and utilities for common tasks.\u003c/p\u003e\n"]]],["The Google Ads API utilizes gRPC or REST interfaces, sharing a resource-oriented design. Using Google's client libraries is highly recommended for type-safe code, handling communication details like timeouts, pagination, and authentication. The official client libraries use gRPC, except for the Perl library, which uses REST. This guide details using REST directly without client libraries, useful for custom code or third-party HTTP clients. It focuses on information outside of what the official client libraries cover.\n"],null,["# REST Interface\n\n| **Key Point:** We strongly recommend using our [official client\n| libraries](/google-ads/api/docs/client-libs) wherever you can. All Google provided client libraries are implemented using gRPC, except for the [Perl\n| library](https://github.com/googleads/google-ads-perl/), which uses the REST interface. Unless you are specifically looking for details about REST, consult the [gRPC documentation](/google-ads/api/reference/rpc) for reference documentation that covers our official client libraries.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nThe Google Ads API can be called either using [gRPC](//grpc.io/) or REST. Both\ninterfaces expose a [resource-oriented design](//cloud.google.com/apis/design)\nshared with other Google Cloud APIs.\n\nWe recommend using Google's official [client libraries](/google-ads/api/docs/client-libs)\nwherever possible. They provide idiomatic, type-safe code in each supported\nlanguage and handle many low-level details of communication with the API (like\ntimeout settings, result set [pagination](/google-ads/api/rest/examples#paginated), and\n[authentication](/google-ads/api/rest/auth)). Our client libraries also include an\nextensive set of [code examples](/google-ads/api/docs/samples) and utilities that assist with\ncommon tasks, such as constructing\n[resource names](/google-ads/api/rest/design/resource-names) and handling\n[field masks](/google-ads/api/rest/common/mutate#update).\n\nThis guide presents details specific to REST and explains what you need to know\nto call the REST interface directly, without the use of a Google-supported\nclient library. This guide may be useful if you are writing your own custom code\nto use REST directly or using a third-party HTTP client library."]]
