Metode Lain

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

RPC buffering protokol ke pemetaan REST

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

Contoh: ListAccessibleCustomers

Misalnya, file customer_service.proto menentukan metode ListAccessibleCustomers, selain Mutate standar kami. Anotasi google.api.http-nya menjelaskan bagaimana metode tersebut dipetakan ke HTTP. Fungsi ini menggunakan GET HTTP dengan kata kerja kustom listAccessibleCustomers:

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

Hal ini dipetakan ke customers.listAccessibleCustomers metode REST.

Contoh: CreateCustomerClient

Contoh lain dari customer_service.proto adalah metode CreateCustomerClient. Anotasi google.api.http-nya mendeskripsikan POST HTTP menggunakan kata kerja kustom 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";
}
customer_service.proto

Tindakan ini akan dipetakan ke objek customers.createCustomerClient metode REST.