Mutate
, Search
, SearchStream
가 가장 일반적인 메서드이지만
Google Ads API에는 특정 목적을 위한 다른 많은 메서드가 있습니다. 모든 서비스 및
해당 API는
REST 참조 문서
프로토콜 버퍼 RPC에서 REST 매핑으로
REST 및 gRPC를 사용하는지 여부와 관계없이 모든 서비스 엔드포인트가 최종적으로 정의됨 를 서비스 패키지의.proto 파일 사용 proto3 인터페이스 정의 언어.
예: 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 메서드와 연결됩니다.