Mutate
, Search
, SearchStream
가 Google Ads API에서 가장 일반적인 메서드이지만 특정 목적을 위한 다른 메서드가 많이 있습니다. 모든 서비스와 관련 API는 REST 참조 문서에 설명되어 있습니다.
프로토콜 버퍼 RPC - REST 매핑
REST 및 gRPC를 사용하든지 모든 서비스 엔드포인트는 최종적으로 proto3 인터페이스 정의 언어를 사용하여 서비스 패키지의.proto 파일에서 정의됩니다.
예: ListAccessibleCustomers
예를 들어 customer_service.proto
파일은 표준 Mutate
외에도 ListAccessibleCustomers
메서드를 정의합니다. google.api.http
주석은 메서드가 HTTP에 매핑되는 방식을 설명합니다. 이 코드는 커스텀 동사 listAccessibleCustomers
와 함께 HTTP GET
를 사용합니다.
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 메서드에 매핑됩니다.