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

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
parent

string

ضروری. مکانی که سری زمانی باید برای آن واکشی شود. قالب: مکان‌ها/{locationId} که locationId یک شناسه فهرست بدون ابهام است.

پارامترهای پرس و جو

مولفه های
monthlyRange

object ( MonthlyRange )

ضروری. محدوده در ماه ها برای جمع آوری کلمات کلیدی جستجو بر روی.

pageSize

integer

اختیاری. تعداد نتایج درخواستی اندازه صفحه پیش فرض 100 است. اندازه صفحه را می توان حداکثر تا 100 تنظیم کرد.

pageToken

string ( bytes format)

اختیاری. نشانه ای که نشان دهنده نتیجه صفحه بندی شده بعدی است که باید برگردانده شود.

رشته ای با کد base64.

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

پاسخ ماهانه.list را نشان می دهد.

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "searchKeywordsCounts": [
    {
      object (SearchKeywordCount)
    }
  ],
  "nextPageToken": string
}
زمینه های
searchKeywordsCounts[]

object ( SearchKeywordCount )

جستجوی عباراتی که برای یافتن یک کسب و کار استفاده شده است.

nextPageToken

string ( bytes format)

نشانه ای که آخرین نتیجه صفحه بندی شده را نشان می دهد. این را می توان با درخواست های موفق برای دریافت "صفحه" بعدی کلمات کلیدی استفاده کرد. تنها زمانی وجود خواهد داشت که نتایج بیشتری برای بازگشت وجود داشته باشد.

رشته ای با کد base64.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

محدوده ماهانه

محدوده زمانی که یک محدوده ماه را نشان می دهد (هر دو شامل).

نمایندگی JSON
{
  "startMonth": {
    object (Date)
  },
  "endMonth": {
    object (Date)
  }
}
زمینه های
startMonth

object ( Date )

ضروری. فراگیر - فقط فیلدهای سال و ماه در نظر گرفته خواهند شد

endMonth

object ( Date )

ضروری. فراگیر - فقط فیلدهای سال و ماه در نظر گرفته خواهند شد

Search Keyword Count

یک کلمه کلیدی جستجو و ارزش آن را نشان می دهد.

نمایندگی JSON
{
  "searchKeyword": string,
  "insightsValue": {
    object (InsightsValue)
  }
}
زمینه های
searchKeyword

string

رشته ای با حروف کوچک که کاربر وارد کرده است.

insightsValue

object ( InsightsValue )

یکی از هر دو: 1) مجموع تعداد کاربران منحصر به فردی که از کلمه کلیدی در یک ماه استفاده کرده اند، جمع آوری شده برای هر ماه درخواستی. 2) آستانه ای که نشان می دهد مقدار واقعی زیر این آستانه است.

InsightsValue

یک ارزش بینش را نشان می دهد.

نمایندگی JSON
{

  // 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)

نشان دهنده آستانه ای است که مقدار واقعی از آن پایین می آید.