Trang này giả định rằng bạn đã quen thuộc với Thiết kế hướng đến tài nguyên và hướng dẫn cho nhà phát triển về Tên tài nguyên, đồng thời bổ sung cho các hướng dẫn này bằng thông tin chi tiết cụ thể về cách triển khai Google Ads API.
Thiết kế hướng đến tài nguyên
Nhìn chung, API Google Ads tuân theo một thiết kế hướng đến tài nguyên, được mô hình hoá dưới dạng các tập hợp gồm 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 bằng tên tài nguyên và được thao tác bằng một nhóm nhỏ phương thức (còn gọi là động từ hoặc thao tác).
Những tên tài nguyên và phương thức này, kết hợp với một tiền tố phiên bản API cụ thể, tạo thành các URL của giao diện REST. Ví dụ: URL bên dưới có thể được chia thành các thành phần riêng lẻ theo bảng sau:
https://googleads.googleapis.com/v21/customers/1234567890:mutate
| Tiền tố phiên bản API | Tên tài nguyên (tương đối) | Phương thức |
|---|---|---|
https://googleads.googleapis.com/v21
|
customers/1234567890
|
mutate
|
Tất cả URL REST cho một phiên bản cụ thể của API (ví dụ: v21) chia sẻ một tiền tố phiên bản API chung. 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 Google Ads sử dụng nhiều phương thức tuỳ chỉnh, không giống như hầu hết các API REST truyền thống sử dụng các phương thức REST tiêu chuẩn như list, get, create, update và delete. Các ví dụ về phương thức tuỳ chỉnh trong API Google Ads bao gồm search, searchStream và mutate.
Các trang sau đây sẽ 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 Google Ads API để minh hoạ cách các thành phần này được dùng cùng nhau để xác định các điểm cuối giao diện REST.