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: "/v17/customers:listAccessibleCustomers" }; }
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: "/v17/customers/{customer_id=*}:createCustomerClient" body: "*" }; option (google.api.method_signature) = "customer_id,customer_client"; }
Ini dipetakan ke metode REST customers.createCustomerClient.