Các phương pháp khác

Trong khi Mutate, SearchSearchStream 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.