기타 방법

Mutate, Search, SearchStream은 Google Ads API에서 가장 일반적인 메서드 이지만 특정 용도로 사용되는 다른 메서드도 많습니다. 모든 서비스와 해당 API는 참고 문서에 설명되어 있습니다.

프로토콜 버퍼 RPC-REST 매핑

모든 서비스 엔드포인트 (REST 및 gRPC 사용 여부와 관계없이)는 궁극적으로 서비스 패키지의 .proto 파일에 proto3 인터페이스 정의 언어를 사용하여정의됩니다.

예: ListAccessibleCustomers

예를 들어 customer_service.proto 파일 은 표준 Mutate 외에 ListAccessibleCustomers 메서드를 정의합니다. google.api.http 주석은 메서드가 HTTP에 매핑되는 방식을 설명합니다. 커스텀 동사 listAccessibleCustomers와 함께 HTTP GET을 사용합니다.

rpc ListAccessibleCustomers(ListAccessibleCustomersRequest)
    returns (ListAccessibleCustomersResponse) {
  option (google.api.http) = {
    get: "/v25/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: "/v25/customers/{customer_id=*}:createCustomerClient"
    body: "*"
  };
  option (google.api.method_signature) = "customer_id,customer_client";
}

이는 customers.createCustomerClient REST 메서드에 매핑됩니다.