주의: 이 API의 REST 인터페이스에 대한 문서를 보고 있습니다. 대부분의 공식 클라이언트 라이브러리는 gRPC를 사용합니다. 자세한 내용은 REST 소개를 참조하세요.

이 페이지는 Cloud Translation API를 통해 번역되었습니다.

기타 방법

이 페이지의 내용
프로토콜 버퍼 RPC와 REST 매핑
- 예: ListAccessibleCustomers
- 예: CreateCustomerClient

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: "/v19/customers:listAccessibleCustomers"
  };
}customer_service.proto

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

예: CreateCustomerClient

customer_service.proto의 또 다른 예는 CreateCustomerClient 메서드입니다. google.api.http 주석은 맞춤 동사 createCustomerClient를 사용하는 HTTP POST를 설명합니다.

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

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

돌연변이

예