যদিও Mutate
, Search
, এবং SearchStream
হল Google বিজ্ঞাপন API-এর সবচেয়ে সাধারণ পদ্ধতি, নির্দিষ্ট উদ্দেশ্যে আরও অনেকগুলি রয়েছে৷ সমস্ত পরিষেবা এবং তাদের APIগুলি REST রেফারেন্স ডকুমেন্টেশনে নথিভুক্ত করা হয়েছে৷
প্রোটোকল বাফার RPC থেকে REST ম্যাপিং
প্রোটো3 ইন্টারফেস ডেফিনিশন ল্যাঙ্গুয়েজ ব্যবহার করে পরিষেবা প্যাকেজের .proto ফাইলগুলিতে সমস্ত পরিষেবার শেষ পয়েন্ট (REST এবং gRPC ব্যবহার করা হোক না কেন) শেষ পর্যন্ত সংজ্ঞায়িত করা হয়।
উদাহরণ: ListAccessible Customers
উদাহরণস্বরূপ, customer_service.proto
ফাইলটি স্ট্যান্ডার্ড Mutate
পাশাপাশি একটি ListAccessibleCustomers
পদ্ধতি সংজ্ঞায়িত করে। এর google.api.http
টীকা বর্ণনা করে কিভাবে পদ্ধতিটি HTTP-তে ম্যাপ করে। এটি কাস্টম ক্রিয়া listAccessibleCustomers
সাথে একটি HTTP GET
ব্যবহার করে AccessibleCustomers:
rpc ListAccessibleCustomers(ListAccessibleCustomersRequest) returns (ListAccessibleCustomersResponse) { option (google.api.http) = { get: "/v17/customers:listAccessibleCustomers" }; }
এটি customers.listAccessibleCustomers REST পদ্ধতিতে ম্যাপ করে।
উদাহরণ: CreateCustomerClient
customer_service.proto
থেকে আরেকটি উদাহরণ হল CreateCustomerClient
পদ্ধতি। এর google.api.http
টীকাটি কাস্টম ক্রিয়া createCustomerClient
ব্যবহার করে একটি HTTP POST
বর্ণনা করে:
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"; }
এটি customers.createCustomerClient REST পদ্ধতিতে ম্যাপ করে।