Trang này giả định bạn đã quen thuộc với hướng dẫn cho nhà phát triển Thiết kế hướng tài nguyên và Tên tài nguyê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.
Thiết kế theo tài nguyên
Nhìn chung, API Google Ads tuân theo thiết kế hướng tài nguyên, được mô hình hoá dưới dạng tập hợp gồm các tài nguyên có thể xác định địa chỉ riêng lẻ (danh từ của API). Tài nguyên được tham chiếu với tên tài nguyên và được điều khiển bằng một tập hợp nhỏ các phương thức (còn gọi là động từ hoặc phép toán).
Các 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ể bao gồm các URL của giao diện REST. Ví dụ: URL bên dưới có thể được chia nhỏ thành các thành phần riêng lẻ này theo bảng sau:
https://googleads.googleapis.com/v16/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/v16
|
customers/1234567890
|
mutate
|
Tất cả URL REST cho một phiên bản cụ thể của API (ví dụ: v16
) chia sẻ một tiền tố phiên bản API phổ biến. Tên và phương thức tài nguyên sẽ 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á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 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 sẽ tìm hiểu thêm thông tin chi tiết 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 nhằm xác định điểm cuối của giao diện REST.