Other Methods

While Get, Mutate, Search, and SearchStream are the most common methods in the Google Ads API, there are many others for specific purposes. All services and their APIs are defined in the .proto files of the services package using the proto3 Interface Definition Language.

For example, the customer_service.proto file defines a ListAccessibleCustomers method, in addition to the standard Mutate and Get. Its google.api.http annotation describes how the method maps to HTTP. It uses an HTTP GET with the custom verb listAccessibleCustomers:

Note: This type of HTTP GET (that uses a custom verb) is not subject to the quota restriction on standard Get methods.

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

Another example from customer_service.proto is the CreateCustomerClient method. Its google.api.http annotation describes an HTTP POST using the custom verb createCustomerClient:

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