Metode Lain

Meskipun Mutate, Search, dan SearchStream adalah metode yang paling umum di Google Ads API, ada banyak metode lainnya untuk tujuan tertentu. Semua layanan dan API-nya didokumentasikan dalam dokumentasi referensi REST.

Pemetaan RPC buffering protokol ke REST

Semua endpoint layanan (baik menggunakan REST dan gRPC) pada akhirnya ditentukan dalam file.proto paket layanan menggunakan proto3 Interface Definition Language.

Contoh: ListAccessibleCustomers

Misalnya, file customer_service.proto menentukan metode ListAccessibleCustomers, selain Mutate standar. Anotasi google.api.http menjelaskan cara metode dipetakan ke HTTP. Metode ini menggunakan GET HTTP dengan kata kerja kustom listAccessibleCustomers:

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

Metode ini dipetakan ke metode REST customers.listAccessibleCustomers.

Contoh: CreateCustomerClient

Contoh lain dari customer_service.proto adalah metode CreateCustomerClient. Anotasi google.api.http-nya menjelaskan POST HTTP menggunakan kata kerja kustom createCustomerClient:

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

Ini dipetakan ke metode REST customers.createCustomerClient.