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ì nó chủ yếu sử dụng các phương thức tuỳ chỉnh, chẳng hạn như searchmutate, thay vì các phương thức list, get, create, updatedelete 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 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/v16/customers/1234567890/campaigns:mutate

Một lý do khiến API này sử dụng các phương thức tuỳ chỉnh là để bật tính năng tạo lô cho nhiều thao tác trong một yêu cầu API. 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. Ví dụ: một REST truyền thống update cho một chiến dịch sẽ yêu cầu gửi một yêu cầu HTTP PATCH cho mỗi tài nguyên chiến dịch.

Để cho phép nhóm nhiều thao tác lại với nhau trong một phần nội dung yêu cầu duy nhất, API Google Ads sẽ xác định 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 Các phương thức phổ biến trình bày chi tiết các phương thức thường được sử dụng nhất trong API Google Ads.