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

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/v22/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.