Thiết kế của API Google Ads khác với kiến trúc REST truyền thống
vì thiết bị 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,
của phương thức list
, get
, create
, update
và delete
truyền thống.
Những hành động này được thể hiện trong URL REST bằng cách sử dụng ánh xạ HTTP
quy ước của :
để tách động từ tuỳ chỉnh khỏi phần còn lại của URL.
Ví dụ: lệnh gọi API thay đổi chiến dịch sử dụng URL sau:
https://googleads.googleapis.com/v17/customers/1234567890/campaigns:mutate
Một lý do khiến API sử dụng phương thức tuỳ chỉnh là cho phép tạo lô
hoạt động vào 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 từng chiến dịch một. Kiến trúc chuyển trạng thái đại diện (REST) truyền thống
update
thành một
chiến dịch sẽ yêu cầu gửi một yêu cầu PATCH HTTP cho mỗi chiến dịch
nguồn.
Để cho phép nhiều thao tác được nhóm lại với nhau trong một nội dung yêu cầu duy nhất,
thay vào đó, API Google Ads 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ự, để bật tính năng đọc hàng loạt (tìm nạp nhiều đối tượng cùng lúc) từ API,
API sử dụng phương thức search
tuỳ chỉnh với Truy vấn Google Ads giống như SQL
Ngôn ngữ.
Trang Các phương pháp phổ biến sẽ trình bày chi tiết về những phương thức được dùng thường xuyên nhất trong API Google Ads.