Mutate
、Search
、SearchStream
は Google Ads API の最も一般的なメソッドですが、特定の目的のためのメソッドは他に多数あります。すべてのサービスとその API は、REST リファレンス ドキュメントに記載されています。
プロトコル バッファの RPC から REST へのマッピング
すべてのサービス エンドポイント(REST と gRPC のどちらを使用する場合でも)は、最終的に proto3 インターフェース定義言語を使用して、サービス パッケージの .proto ファイルで定義されます。
例: ListAccessibleCustomers
たとえば、customer_service.proto
ファイルでは、標準の Mutate
に加えて ListAccessibleCustomers
メソッドが定義されています。google.api.http
アノテーションは、このメソッドが HTTP にどのようにマッピングされるかを示しています。HTTP GET
とカスタム動詞 listAccessibleCustomers
を使用します。
rpc ListAccessibleCustomers(ListAccessibleCustomersRequest) returns (ListAccessibleCustomersResponse) { option (google.api.http) = { get: "/v17/customers:listAccessibleCustomers" }; }
これは customers.listAccessibleCustomers REST メソッドにマッピングされます。
例: CreateCustomerClient
customer_service.proto
のもう一つの例は、CreateCustomerClient
メソッドです。その google.api.http
アノテーションは、カスタム動詞 createCustomerClient
を使用して HTTP POST
を記述します。
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"; }
これは customers.createCustomerClient REST メソッドにマッピングされます。