Google Ads API में, Mutate
, Search
, और SearchStream
सबसे ज़्यादा इस्तेमाल किए जाने वाले तरीके हैं. हालांकि, खास मकसद के लिए कई अन्य तरीके भी उपलब्ध हैं. सभी सेवाओं और उनके एपीआई के बारे में रेफ़रंस दस्तावेज़ में बताया गया है.
प्रोटोकॉल बफ़र आरपीसी से REST मैपिंग
सभी सेवा एंडपॉइंट (चाहे REST और gRPC का इस्तेमाल किया जा रहा हो) को आखिर में, सेवाओं के पैकेज की .proto फ़ाइलों में तय किया जाता है. इसके लिए, proto3 इंटरफ़ेस डेफ़िनिशन लैंग्वेज का इस्तेमाल किया जाता है.
उदाहरण: ListAccessibleCustomers
उदाहरण के लिए, customer_service.proto
फ़ाइल, स्टैंडर्ड Mutate
के अलावा ListAccessibleCustomers
तरीके को भी तय करती है. इसके google.api.http
एनोटेशन में बताया गया है कि यह तरीका एचटीटीपी से कैसे मैप होता है. यह कस्टम वर्ब listAccessibleCustomers
के साथ एचटीटीपी GET
का इस्तेमाल करता है:
rpc ListAccessibleCustomers(ListAccessibleCustomersRequest) returns (ListAccessibleCustomersResponse) { option (google.api.http) = { get: "/v21/customers:listAccessibleCustomers" }; }
यह customers.listAccessibleCustomers REST तरीके पर मैप होता है.
उदाहरण: CreateCustomerClient
customer_service.proto
का एक और उदाहरण CreateCustomerClient
तरीका है. इसके google.api.http
एनोटेशन में, कस्टम वर्ब createCustomerClient
का इस्तेमाल करके POST
एचटीटीपी के बारे में बताया गया है:
rpc CreateCustomerClient(CreateCustomerClientRequest) returns (CreateCustomerClientResponse) { option (google.api.http) = { post: "/v21/customers/{customer_id=*}:createCustomerClient" body: "*" }; option (google.api.method_signature) = "customer_id,customer_client"; }
यह customers.createCustomerClient REST तरीके पर मैप होता है.