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

Mặc dù Mutate, Search và SearchStream là các phương thức phổ biến nhất trong Google Ads API, nhưng còn nhiều phương thức khác cho các mục đích cụ thể. Tất cả các dịch vụ và API của chúng đều được ghi lại trong tài liệu tham khảo.

Ánh xạ RPC vùng đệm giao thức sang REST

Tất cả các điểm cuối dịch vụ (cho dù sử dụng REST và gRPC) đều được xác định trong các tệp.proto của gói dịch vụ bằng cách sử dụng Ngôn ngữ định nghĩa giao diện proto3.

Ví dụ: ListAccessibleCustomers

Ví dụ: tệp customer_service.proto xác định phương thức ListAccessibleCustomers, ngoài Mutate tiêu chuẩn. Chú thích google.api.http của phương thức này mô tả cách phương thức này ánh xạ sang HTTP. Phương thức này sử dụng HTTP GET với động từ tuỳ chỉnh listAccessibleCustomers:

rpc ListAccessibleCustomers(ListAccessibleCustomersRequest)
    returns (ListAccessibleCustomersResponse) {
  option (google.api.http) = {
    get: "/v26/customers:listAccessibleCustomers"
  };
}

Phương thức này ánh xạ sang phương thức REST customers.listAccessibleCustomers.

Ví dụ: CreateCustomerClient

Một ví dụ khác từ customer_service.proto là phương thức CreateCustomerClient. Chú thích google.api.http của phương thức này mô tả HTTP POST bằng cách sử dụng động từ tuỳ chỉnh createCustomerClient:

rpc CreateCustomerClient(CreateCustomerClientRequest)
    returns (CreateCustomerClientResponse) {
  option (google.api.http) = {
    post: "/v26/customers/{customer_id=*}:createCustomerClient"
    body: "*"
  };
  option (google.api.method_signature) = "customer_id,customer_client";
}

Phương thức này ánh xạ sang phương thức REST customers.createCustomerClient.