Trong khi Mutate
, Search
và SearchStream
là những phương thức phổ biến nhất
trong API Google Ads, còn có nhiều API khác phục vụ cho các mục đích cụ thể. Tất cả dịch vụ và
các API của họ được ghi lại trong
Tài liệu tham khảo về REST.
Ánh xạ RPC vùng đệm giao thức đến REST
Cuối cùng, tất cả điểm cuối của dịch vụ (cho dù có sử dụng REST và gRPC) đều được xác định trong Các tệp.proto của gói dịch vụ sử dụng Ngôn ngữ định nghĩa giao diện proto3.
Ví dụ: ListAccessibleKhách hàng
Ví dụ: tệp customer_service.proto
xác định phương thức ListAccessibleCustomers
, ngoài Mutate
chuẩn
của Google. Chú giải google.api.http
mô tả
cách phương thức này ánh xạ tới HTTP. Phương thức này sử dụng một GET
HTTP với động từ tuỳ chỉnh
listAccessibleCustomers
:
rpc ListAccessibleCustomers(ListAccessibleCustomersRequest) returns (ListAccessibleCustomersResponse) { option (google.api.http) = { get: "/v17/customers:listAccessibleCustomers" }; }
Quy tắc này ánh xạ đến customers.listAccessibleCustomers Phương thức REST.
Ví dụ: CreateCustomerClient
Một ví dụ khác từ customer_service.proto
là
phương thức CreateCustomerClient
. Chú giải google.api.http
của lớp này mô tả
HTTP POST
sử dụng động từ tuỳ chỉnh createCustomerClient
:
rpc CreateCustomerClient(CreateCustomerClientRequest) returns (CreateCustomerClientResponse) { option (google.api.http) = { post: "/v17/customers/{customer_id=*}:createCustomerClient" body: "*" }; option (google.api.method_signature) = "customer_id,customer_client"; }
Liên kết này liên kết với customers.createCustomerClient Phương thức REST.