Phương thức dịch vụ

Thiết kế của API Google Ads khác với cấu trúc REST truyền thống vì API 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, thay vì các phương thức list, get, create, update và delete truyền thống hơn. Các hành động này được thể hiện trong URL REST bằng cách sử dụng quy ước ánh xạ HTTP 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/v21/customers/1234567890/campaigns:mutate

Một lý do khiến API sử dụng các phương thức tuỳ chỉnh là để cho phép nhóm nhiều thao tác vào một yêu cầu API. Ngữ nghĩa REST nghiêm ngặt sẽ chỉ cho phép cập nhật một chiến dịch tại một thời điểm. Ví dụ: một REST truyền thống update đến một chiến dịch sẽ yêu cầu gửi một yêu cầu PATCH HTTP cho mỗi tài nguyên chiến dịch.

Để cho phép nhiều thao tác được gói lại với nhau trong một nội dung yêu cầu, 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 một lúc) từ API, API sử dụng phương thức search tuỳ chỉnh với Ngôn ngữ truy vấn Google Ads giống SQL.

Trang Phương thức phổ biến trình bày chi tiết về các phương thức được sử dụng thường xuyên nhất trong API Google Ads.