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