নতুন Search Ads 360 Reporting API এখন উপলব্ধ। আসন্ন উন্নতি এবং রিলিজ সম্পর্কে আপ টু ডেট থাকতে
searchads-api-announcements Google গ্রুপে যোগ দিন।
JSON ম্যাপিং
সেভ করা পৃষ্ঠা গুছিয়ে রাখতে 'সংগ্রহ' ব্যবহার করুন
আপনার পছন্দ অনুযায়ী কন্টেন্ট সেভ করুন ও সঠিক বিভাগে রাখুন।
Search Ads 360 Reporting API-এর REST ইন্টারফেস ব্যবহার করার সময়, আপনি অনুসন্ধান বিজ্ঞাপন 360 রিপোর্টিং API-এর .proto বর্ণনাকারী ফাইলগুলিতে সংজ্ঞায়িত একই সংস্থান এবং প্রকারের JSON উপস্থাপনা নিয়ে কাজ করছেন। JSON এনকোডিং স্কিমটি প্রোটোকল বাফার ল্যাঙ্গুয়েজ গাইডের JSON ম্যাপিং বিভাগে বর্ণিত ক্যানোনিকাল এনকোডিং স্কিম অনুসরণ করে।
সাধারণভাবে, পরিষেবাগুলিতে এবং থেকে আসা সমস্ত শীর্ষ-স্তরের বার্তাগুলি একক JSON অবজেক্ট। search প্রতিক্রিয়া হল JSON অবজেক্ট যাতে আপনার প্রশ্নের ফলাফল সেটের সাথে একটি results অ্যারে থাকে।
শনাক্তকারীগুলিকে snake_case (প্রটোকল বাফারে) থেকে JSON-এ LowerCamelCase- এ রূপান্তরিত করা হয়। Search Ads 360 কোয়েরি ভাষার প্রশ্ন পাঠানোর জন্য search বা searchStream ব্যবহার করার সময় এই নিয়মের একটি উল্লেখযোগ্য সতর্কতা। আপনি যে ইন্টারফেস ব্যবহার করছেন তা নির্বিশেষে ক্যোয়ারী ভাষা নিজেই স্নেক কেস ব্যবহার করে। যাইহোক, REST-এ একটি প্রশ্নের ফলাফল সাধারণ JSON অবজেক্ট হিসাবে ফেরত দেওয়া হয় এবং তাদের শনাক্তকারী LowerCamelCase-এ থাকে।
উদাহরণস্বরূপ, একটি অ্যাকাউন্টে সক্রিয় কীওয়ার্ডগুলির একটি তালিকা আনার জন্য একটি ক্যোয়ারী ক্যোয়ারীটির ভিতরেই স্নেক কেস ব্যবহার করে ( ad_group_criterion , adGroupCriterion নয় ):
POST /v0/customers/CUSTOMER_ID/searchAds360:searchStream HTTP/1.1
Host: searchads360.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN
{
"query": "SELECT ad_group_criterion.keyword.text
FROM ad_group_criterion
WHERE ad_group_criterion.type = 'KEYWORD'
AND ad_group_criterion.status = 'ENABLED'"
} যাইহোক, প্রতিক্রিয়া হল বস্তুগুলির একটি JSON উপস্থাপনা (যেহেতু এই অনুরোধটি searchStream ব্যবহার করে একটি JSON অ্যারেতে মোড়ানো) এবং পরিবর্তে CamelCase শনাক্তকারী adGroupCriterion ব্যবহার করে:
[
{
"results": [
{
"adGroupCriterion": {
"resourceName": "customers/1842689525/adGroupCriteria/55771861891~10003060",
"keyword": {
"text": "pay per click"
}
}
},
...
]
}
]
অন্য কিছু উল্লেখ না করা থাকলে, এই পৃষ্ঠার কন্টেন্ট Creative Commons Attribution 4.0 License-এর অধীনে এবং কোডের নমুনাগুলি Apache 2.0 License-এর অধীনে লাইসেন্স প্রাপ্ত। আরও জানতে, Google Developers সাইট নীতি দেখুন। Java হল Oracle এবং/অথবা তার অ্যাফিলিয়েট সংস্থার রেজিস্টার্ড ট্রেডমার্ক।
2025-08-29 UTC-তে শেষবার আপডেট করা হয়েছে।
[null,null,["2025-08-29 UTC-তে শেষবার আপডেট করা হয়েছে।"],[[["\u003cp\u003eThe Search Ads 360 Reporting API's REST interface uses JSON to represent the resources and types defined in its .proto descriptor files, adhering to the canonical JSON encoding scheme.\u003c/p\u003e\n"],["\u003cp\u003eTop-level messages in REST are single JSON objects, and search responses contain a \u003ccode\u003eresults\u003c/code\u003e array holding the query's result set.\u003c/p\u003e\n"],["\u003cp\u003eIdentifiers are generally transformed from snake_case in protocol buffers to lowerCamelCase in JSON, except within Search Ads 360 Query Language queries which retain snake_case.\u003c/p\u003e\n"],["\u003cp\u003eAlthough Search Ads 360 Query Language uses snake_case, the results returned via REST are standard JSON objects with lowerCamelCase identifiers.\u003c/p\u003e\n"]]],["The Search Ads 360 Reporting API's REST interface uses JSON, mirroring the structure of its .proto descriptor files. Data is exchanged as JSON objects, with `search` responses containing a `results` array. Identifiers convert from *snake_case* in protocol buffers to *lowerCamelCase* in JSON, except within the Search Ads 360 Query Language, which remains *snake_case*. Query results, however, are returned in *lowerCamelCase* format. For instance, a query uses `ad_group_criterion` while the response will be `adGroupCriterion`.\n"],null,["# JSON Mappings\n\nWhen using the Search Ads 360 Reporting API's REST interface, you're working with JSON\nrepresentations of the same resources and types defined in the Search Ads 360 Reporting API's\n[.proto descriptor](https://github.com/googleapis/googleapis/tree/13301267d983903e0eb8e3713cf6d3127ea0ca47/google/ads/searchads360/v0/) files. The JSON encoding scheme follows the\ncanonical encoding scheme described in the\n[JSON Mapping](/protocol-buffers/docs/proto3#json) section of the protocol\nbuffers *Language Guide*.\n\nIn general, all top-level messages to and from\n[services](https://github.com/googleapis/googleapis/tree/13301267d983903e0eb8e3713cf6d3127ea0ca47/google/ads/searchads360/v0/services) are single JSON objects. `search` responses are JSON objects containing a `results` array with your query's result set.\n\nIdentifiers are transformed from *snake_case* (in protocol buffers) to\n*lowerCamelCase* in JSON. One notable caveat to this rule is when using\n`search` or `searchStream` to send [Search Ads 360 Query Language](/search-ads/reporting/query/query-language) queries. The query language itself uses snake case, regardless of which\ninterface you're using. However, the results of a query in REST are returned as\nnormal JSON objects and have their identifiers in lowerCamelCase.\n\nFor example, a query to fetch a list of active keywords in an account uses\nsnake case inside the query itself (`ad_group_criterion`, not `adGroupCriterion`): \n\n```http\nPOST /v0/customers/\u003cvar translate=\"no\"\u003eCUSTOMER_ID\u003c/var\u003e/searchAds360:searchStream HTTP/1.1\nHost: searchads360.googleapis.com\nContent-Type: application/json\nAuthorization: Bearer \u003cvar translate=\"no\"\u003eACCESS_TOKEN\u003c/var\u003e\n\n{\n \"query\": \"SELECT ad_group_criterion.keyword.text\n FROM ad_group_criterion\n WHERE ad_group_criterion.type = 'KEYWORD'\n AND ad_group_criterion.status = 'ENABLED'\"\n}\n```\n\nHowever, the response is a JSON representation of the objects (wrapped in a JSON\narray since this request uses `searchStream`) and uses the camelCase identifier\n`adGroupCriterion` instead: \n\n```javascript\n[\n {\n \"results\": [\n {\n \"adGroupCriterion\": {\n \"resourceName\": \"customers/1842689525/adGroupCriteria/55771861891~10003060\",\n \"keyword\": {\n \"text\": \"pay per click\"\n }\n }\n },\n ...\n ]\n }\n]\n```"]]
