Mutate
, Search
ve SearchStream
, Google Ads API'deki en yaygın yöntemler olsa da belirli amaçlar doğrultusunda
kullanılan birçok başka yöntem de vardır. Tüm hizmetler ve API'leri, REST referans belgelerinde açıklanmıştır.
Protokol arabelleği RPC'si ile REST eşlemeleri
Tüm hizmet uç noktaları (REST ve gRPC kullanıyor olmanız fark etmeksizin), en sonunda proto3 Arayüz Tanımlama Dili kullanılarak hizmet paketinin.proto dosyalarında tanımlanır.
Örnek: ListAccessibleCustomers
Örneğin, customer_service.proto
dosyası standart Mutate
yöntemine ek olarak bir ListAccessibleCustomers
yöntemini tanımlar. google.api.http
ek açıklaması, yöntemin HTTP ile nasıl eşlendiğini açıklar. Bu özellik, listAccessibleCustomers
özel fiili ile bir HTTP GET
kullanır:
rpc ListAccessibleCustomers(ListAccessibleCustomersRequest) returns (ListAccessibleCustomersResponse) { option (google.api.http) = { get: "/v17/customers:listAccessibleCustomers" }; }
Bu, customers.listAccessibleCustomers REST yöntemiyle eşlenir.
Örnek: CreateCustomerClient
customer_service.proto
kaynağından başka bir örnek de CreateCustomerClient
yöntemidir. google.api.http
ek açıklaması, createCustomerClient
özel fiilini kullanarak bir POST
HTTP'yi tanımlar:
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"; }
Bu, customers.createCustomerClient REST yöntemiyle eşlenir.