Method: locations.searchkeywords.impressions.monthly.list

खोज या मैप में किसी कारोबार को ढूंढने के लिए इस्तेमाल किए जाने वाले सर्च कीवर्ड दिखाता है. हर खोज कीवर्ड के साथ इंप्रेशन शामिल होते हैं, जिन्हें हर महीने इकट्ठा किया जाता है.

अनुरोध का उदाहरण: GET https://businessprofileperformance.googleapis.com/v1/locations/12345/searchkeywords/impressions/monthly?monthlyRange.start_month.year=2022&monthlyRange.start_month.month=1&monthlyRange.end_month.year=2022&monthlyRange.end_month.month=3

एचटीटीपी अनुरोध

GET https://businessprofileperformance.googleapis.com/v1/{parent=locations/*}/searchkeywords/impressions/monthly

यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ के पैरामीटर

पैरामीटर
parent

string

ज़रूरी है. वह जगह जिसके लिए टाइम सीरीज़ को फ़ेच किया जाना चाहिए. फ़ॉर्मैट: locations/{locationId}, जहांlocationId साफ़ तौर पर न दिखने वाला लिस्टिंग आईडी है.

क्वेरी पैरामीटर

पैरामीटर
monthlyRange

object (MonthlyRange)

ज़रूरी है. महीनों की रेंज, जिसमें सर्च कीवर्ड के इंप्रेशन को इकट्ठा करना है.
pageSize

integer

ज़रूरी नहीं. अनुरोध किए गए परिणामों की संख्या. पेज का डिफ़ॉल्ट साइज़ 100 है. पेज का साइज़ ज़्यादा से ज़्यादा 100 पर सेट किया जा सकता है.
pageToken

string (bytes format)

ज़रूरी नहीं. पेज पर नंबर वाले अगले नतीजे दिखाने वाला टोकन.

Base64 कोड में बदली गई स्ट्रिंग.

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य भाग

men.list के लिए दिए गए जवाब को दिखाता है.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

जेएसओएन के काेड में दिखाना 
{
  "searchKeywordsCounts": [
    {
      object (SearchKeywordCount)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
searchKeywordsCounts[]

object (SearchKeywordCount)

किसी कारोबार को ढूंढने के लिए इस्तेमाल किए गए खोज के लिए शब्द.
nextPageToken

string (bytes format)

पेज पर नंबर वाले आखिरी नतीजे दिखाने वाला टोकन. इसका इस्तेमाल, कीवर्ड का अगला "पेज" पाने के अनुरोध को पूरा करके किया जा सकता है. यह सिर्फ़ तब उपलब्ध होगी, जब नतीजे दिखाने के लिए और नतीजे होंगे.

Base64 कोड में बदली गई स्ट्रिंग.

अनुमति देने के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/business.manage

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.

MonthlyRange

महीने की सीमा दिखाने वाली समयसीमा (दोनों शामिल).

जेएसओएन के काेड में दिखाना 
{
  "startMonth": {
    object (Date)
  },
  "endMonth": {
    object (Date)
  }
}
फ़ील्ड
startMonth

object (Date)

ज़रूरी है. इन्क्लूसिव - सिर्फ़ साल और महीने वाले फ़ील्ड को शामिल किया जाएगा
endMonth

object (Date)

ज़रूरी है. इन्क्लूसिव - सिर्फ़ साल और महीने वाले फ़ील्ड को शामिल किया जाएगा

SearchKeywordCount

एक सर्च कीवर्ड और उसकी वैल्यू दिखाता है.

जेएसओएन के काेड में दिखाना 
{
  "searchKeyword": string,
  "insightsValue": {
    object (InsightsValue)
  }
}
फ़ील्ड
searchKeyword

string

उपयोगकर्ता की डाली गई लोअर केस वाली स्ट्रिंग.
insightsValue

object (InsightsValue)

इनमें से एक: 1) किसी महीने में कीवर्ड का इस्तेमाल करने वाले यूनीक उपयोगकर्ताओं की संख्या का योग. अनुरोध किए गए हर महीने के लिए इकट्ठा किया जाता है. 2) वह थ्रेशोल्ड जिससे पता चलता है कि असल वैल्यू इस थ्रेशोल्ड से कम है.

InsightsValue

इनसाइट की वैल्यू दिखाता है.

जेएसओएन के काेड में दिखाना 
{

  // Union field InsightsValue can be only one of the following:
  "value": string,
  "threshold": string
  // End of list of possible types for union field InsightsValue.
}
फ़ील्ड
यूनियन फ़ील्ड InsightsValue. इससे पता चलता है कि इन प्रोटो फ़ील्ड में से सिर्फ़ एक फ़ील्ड का मौजूद होना ज़रूरी है. InsightsValue इनमें से सिर्फ़ एक हो सकता है:
value

string (int64 format)

यह असल वैल्यू दिखाता है.
threshold

string (int64 format)

वह थ्रेशोल्ड दिखाता है जिससे नीचे असल वैल्यू आती है.