সতর্কতা: আপনি API এর REST ইন্টারফেসের জন্য ডকুমেন্টেশন দেখছেন। আমাদের বেশিরভাগ অফিসিয়াল ক্লায়েন্ট লাইব্রেরি জিআরপিসি ব্যবহার করে। বিস্তারিত জানার জন্য
REST ভূমিকা দেখুন।
অন্যান্য পদ্ধতি
সেভ করা পৃষ্ঠা গুছিয়ে রাখতে 'সংগ্রহ' ব্যবহার করুন
আপনার পছন্দ অনুযায়ী কন্টেন্ট সেভ করুন ও সঠিক বিভাগে রাখুন।
যদিও Mutate , Search , এবং SearchStream হল Google বিজ্ঞাপন API-এর সবচেয়ে সাধারণ পদ্ধতি, নির্দিষ্ট উদ্দেশ্যে আরও অনেকগুলি রয়েছে৷ সমস্ত পরিষেবা এবং তাদের API রেফারেন্স ডকুমেন্টেশনে নথিভুক্ত করা হয়।
প্রোটোকল বাফার RPC থেকে REST ম্যাপিং
প্রোটো3 ইন্টারফেস ডেফিনিশন ল্যাঙ্গুয়েজ ব্যবহার করে পরিষেবা প্যাকেজের .proto ফাইলগুলিতে সমস্ত পরিষেবার শেষ পয়েন্ট (REST এবং gRPC ব্যবহার করা হোক না কেন) শেষ পর্যন্ত সংজ্ঞায়িত করা হয়।
উদাহরণ: ListAccessible Customers
উদাহরণস্বরূপ, customer_service.proto ফাইলটি স্ট্যান্ডার্ড Mutate পাশাপাশি একটি ListAccessibleCustomers পদ্ধতি সংজ্ঞায়িত করে। এর google.api.http টীকা বর্ণনা করে কিভাবে পদ্ধতিটি HTTP-তে ম্যাপ করে। এটি কাস্টম ক্রিয়া তালিকার সাথে একটি HTTP GET ব্যবহার করে listAccessibleCustomers :
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 ব্যবহার করে একটি HTTP 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 পদ্ধতিতে ম্যাপ করে।
অন্য কিছু উল্লেখ না করা থাকলে, এই পৃষ্ঠার কন্টেন্ট Creative Commons Attribution 4.0 License-এর অধীনে এবং কোডের নমুনাগুলি Apache 2.0 License-এর অধীনে লাইসেন্স প্রাপ্ত। আরও জানতে, Google Developers সাইট নীতি দেখুন। Java হল Oracle এবং/অথবা তার অ্যাফিলিয়েট সংস্থার রেজিস্টার্ড ট্রেডমার্ক।
2025-08-26 UTC-তে শেষবার আপডেট করা হয়েছে।
[null,null,["2025-08-26 UTC-তে শেষবার আপডেট করা হয়েছে।"],[[["\u003cp\u003eWhile \u003ccode\u003eMutate\u003c/code\u003e, \u003ccode\u003eSearch\u003c/code\u003e, and \u003ccode\u003eSearchStream\u003c/code\u003e are commonly used, the Google Ads API offers a wide range of methods for specific tasks, all documented in the REST reference documentation.\u003c/p\u003e\n"],["\u003cp\u003eAll Google Ads API service endpoints, including REST and gRPC, are defined in .proto files using the proto3 Interface Definition Language.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003egoogle.api.http\u003c/code\u003e annotation within these .proto files details how each method maps to HTTP for RESTful interactions, including examples like \u003ccode\u003eListAccessibleCustomers\u003c/code\u003e and \u003ccode\u003eCreateCustomerClient\u003c/code\u003e.\u003c/p\u003e\n"]]],["The Google Ads API includes various methods beyond `Mutate`, `Search`, and `SearchStream`, all detailed in REST documentation. Service endpoints are defined in `.proto` files using proto3. `ListAccessibleCustomers` is a GET method, mapped using the `google.api.http` annotation in the `customer_service.proto` file, and uses custom verb `listAccessibleCustomers`. Similarly, `CreateCustomerClient`, a POST method, uses custom verb `createCustomerClient`, also defined in the same file.\n"],null,["# Other Methods\n\nWhile `Mutate`, `Search`, and `SearchStream` are the most common methods\nin the Google Ads API, there are many others for specific purposes. All services and\ntheir APIs are documented in the\n[reference documentation](/google-ads/api/reference/rpc/v21/overview).\n\nProtocol buffer RPC to REST mappings\n------------------------------------\n\nAll the service endpoints (whether using REST and gRPC) are ultimately defined\nin the\n[.proto files of the services package](https://github.com/googleapis/googleapis/tree/master/google/ads/googleads/v21/services)\nusing the\n[proto3 Interface Definition Language](//cloud.google.com/apis/design/proto3).\n\n### Example: ListAccessibleCustomers\n\nFor example, the [`customer_service.proto`](https://github.com/googleapis/googleapis/tree/master/google/ads/googleads/v21/services/customer_service.proto) file\ndefines a `ListAccessibleCustomers` method, in addition to the standard `Mutate`\n. Its [`google.api.http`](//google.aip.dev/127) annotation describes\nhow the method maps to HTTP. It uses an HTTP `GET` with the custom verb\n`listAccessibleCustomers`: \n\n```css+lasso\nrpc ListAccessibleCustomers(ListAccessibleCustomersRequest)\n returns (ListAccessibleCustomersResponse) {\n option (google.api.http) = {\n get: \"/v21/customers:listAccessibleCustomers\"\n };\n}\n```\n\nThis maps to the\n[customers.listAccessibleCustomers](/google-ads/api/reference/rpc/v21/CustomerService/ListAccessibleCustomers)\nREST method.\n\n### Example: CreateCustomerClient\n\nAnother example from [`customer_service.proto`](https://github.com/googleapis/googleapis/tree/master/google/ads/googleads/v21/services/customer_service.proto) is\nthe `CreateCustomerClient` method. Its `google.api.http` annotation describes an\nHTTP `POST` using the custom verb `createCustomerClient`: \n\n```css+lasso\nrpc CreateCustomerClient(CreateCustomerClientRequest)\n returns (CreateCustomerClientResponse) {\n option (google.api.http) = {\n post: \"/v21/customers/{customer_id=*}:createCustomerClient\"\n body: \"*\"\n };\n option (google.api.method_signature) = \"customer_id,customer_client\";\n}\n```\n\nThis maps to the [customers.createCustomerClient](/google-ads/api/reference/rpc/v21/CustomerService/CreateCustomerClient)\nREST method."]]
