Metode Lain

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

Pemetaan RPC buffering protokol ke REST

Semua endpoint layanan (baik menggunakan REST maupun gRPC) pada akhirnya ditentukan dalam file.proto paket layanan menggunakan Bahasa Definisi Antarmuka proto3.

Contoh: ListAccessibleCustomers

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

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

Hal ini dipetakan ke metode REST customers.listAccessibleCustomers.

Contoh: CreateCustomerClient

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

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

Hal ini dipetakan ke metode REST customers.createCustomerClient.