Trang này giả định rằng bạn đã nắm rõ hướng dẫn về Thiết kế theo hướng tài nguyên và Tên tài nguyên dành cho nhà phát triển, đồng thời bổ sung thông tin chi tiết về cách triển khai cụ thể của API Google Ads cho những tên này.
Thiết kế dựa trê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 tập hợp các tài nguyên có thể giải quyết 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:
https://googleads.googleapis.com/v17/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/v17
|
customers/1234567890
|
mutate
|
Tất cả URL REST cho một phiên bản cụ thể của API (ví dụ: v17) dùng chung một tiền tố phiên bản API phổ biến. Tên tài nguyên và phương thức cùng xác định dịch vụ API nào đang được gọi.
API Google Ads chủ yếu sử dụng các 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 dùng các phương thức REST tiêu chuẩn như list, get, create, update và delete. Ví dụ về các phương thức tuỳ chỉnh trong API Google Ads
bao gồm search, searchStream và mutate.
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 Google Ads để minh hoạ cách sử dụng cùng nhau để xác định điểm cuối của giao diện REST.