Mutate
, Search
ve SearchStream
, Google Ads API'de en yaygın yöntemler olsa da belirli amaçlar için kullanılabilecek başka yöntemler de vardır. Tüm hizmetler ve API'leri REST referans belgelerinde açıklanmıştır.
Protokol arabellek UPÇ'den REST eşlemeleri
Tüm hizmet uç noktaları (REST ve gRPC kullanılsın veya kullanılmasın) nihayetinde proto3 Arayüz Tanımlama Dili kullanılarak hizmetler paketinin.proto dosyalarında tanımlanır.
Örnek: ListAccessibleCustomers
Örneğin, customer_service.proto
dosyası standart Mutate
yöntemine ek olarak bir ListAccessibleCustomers
yöntemi tanımlar. google.api.http
ek açıklaması, yöntemin HTTP ile nasıl eşlendiğini açıklar. Özel fiil listAccessibleCustomers
ile bir HTTP GET
kullanır:
rpc ListAccessibleCustomers(ListAccessibleCustomersRequest) returns (ListAccessibleCustomersResponse) { option (google.api.http) = { get: "/v19/customers:listAccessibleCustomers" }; }
Bu, customers.listAccessibleCustomers REST yöntemiyle eşlenir.
Örnek: CreateCustomerClient
customer_service.proto
'daki bir diğer örnek de CreateCustomerClient
yöntemidir. google.api.http
ek açıklaması, createCustomerClient
özel fiili kullanarak bir HTTP POST
'yi açıklar:
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"; }
Bu, customers.createCustomerClient REST yöntemiyle eşlenir.