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.

مَعلمات المسار

المعلمات
parent

string

مطلوب. الموقع الذي يجب استرجاع السلسلة الزمنية له. التنسيق: location/{locationId} حيث يكون locationId رقم تعريف بطاقة بيانات غير مبهم.

معامِلات طلب البحث

المعلمات
monthlyRange

object (MonthlyRange)

مطلوب. النطاق بالأشهر لتجميع مرّات ظهور الكلمات الرئيسية للإعلان على شبكة البحث
pageSize

integer

اختياريّ. عدد النتائج المطلوبة. يبلغ حجم الصفحة التلقائي 100. يمكن ضبط حجم الصفحة على 100 صفحة كحد أقصى.
pageToken

string (bytes format)

اختياريّ. رمز مميز يشير إلى النتيجة التالية المقسّمة إلى صفحات والتي سيتم عرضها.

سلسلة بترميز base64.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

يمثل الرد الخاص بالقائمة الشهرية.

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل 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.

MonthlyRange

النطاق الزمني الذي يشير إلى نطاق أشهر (كلاهما شاملاً).

تمثيل JSON 
{
  "startMonth": {
    object (Date)
  },
  "endMonth": {
    object (Date)
  }
}
الحقول
startMonth

object (Date)

مطلوب. شامل - سيتم النظر في حقلَي السنة والشهور فقط
endMonth

object (Date)

مطلوب. شامل - سيتم النظر في حقلَي السنة والشهور فقط

SearchKeywordCount

يمثل هذا النوع كلمة بحث رئيسية واحدة وقيمتها.

تمثيل 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)

يمثل الحد الذي تنخفض القيمة الفعلية دونه.