Uwaga: przeglądasz dokumentację interfejsu REST interfejsu API. Większość oficjalnych bibliotek klienta używa gRPC. Więcej informacji znajdziesz we wprowadzeniu do REST.

Ta strona została przetłumaczona przez Cloud Translation API.

Inne metody

Chociaż metody Mutate, Search i SearchStream są najpopularniejszymi metodami w interfejsie Google Ads API, do określonych celów można też używać wielu innych metod. Wszystkie usługi i ich interfejsy API są opisane w dokumentacji referencyjnej REST.

Mapowania RPC Protocol Buffer na REST

Wszystkie punkty końcowe usługi (czy to za pomocą REST, czy gRPC) są ostatecznie zdefiniowane w plikach.proto pakietu usług za pomocą języka definicji interfejsu proto3.

Przykład: ListAccessibleCustomers

Przykładowo plik customer_service.proto definiuje metodę ListAccessibleCustomers oprócz standardowej metody Mutate. Jego adnotacja google.api.http opisuje, jak metoda jest mapowana na HTTP. Używa ona HTTP GET z niestandardowym czasownikiem listAccessibleCustomers:

rpc ListAccessibleCustomers(ListAccessibleCustomersRequest)
    returns (ListAccessibleCustomersResponse) {
  option (google.api.http) = {
    get: "/v19/customers:listAccessibleCustomers"
  };
}customer_service.proto

Odpowiada ona metodzie REST customers.listAccessibleCustomers.

Przykład: CreateCustomerClient

Innym przykładem z customer_service.proto jest metoda CreateCustomerClient. Jego adnotacja google.api.http opisuje HTTP POST za pomocą niestandardowego czasownika createCustomerClient:

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

Odpowiada ona metodzie REST customers.createCustomerClient.