- طلب HTTP
- مَعلمات المسار
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- DrivingDirectionMetricsRequest
- NumDays
- LocationMetrics
- LocationDrivingDirectionMetrics
- TopDirectionSources
- RegionCount
تعرض تقريرًا يحتوي على إحصاءات حول مقياس واحد أو أكثر حسب الموقع الجغرافي.
طلب HTTP
POST https://mybusiness.googleapis.com/v4/{name=accounts/*}/locations:reportInsights
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
name |
اسم مورد الحساب. |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON | |
---|---|
{ "locationNames": [ string ], "basicRequest": { object ( |
الحقول | |
---|---|
locationNames[] |
مجموعة من المواقع الجغرافية لجلب إحصاءات عنها، يتم تحديدها بأسمائها. |
basicRequest |
طلب لتضمين إحصاءات المقاييس الأساسية في التقرير. |
drivingDirectionsRequest |
طلب لتضمين إحصاءات حول طلبات الحصول على اتجاهات القيادة في التقرير. |
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
رسالة الرد على Insights.ReportLocationInsights
.
تمثيل JSON | |
---|---|
{ "locationMetrics": [ { object ( |
الحقول | |
---|---|
locationMetrics[] |
مجموعة من قيم المقاييس حسب الموقع الجغرافي. |
locationDrivingDirectionMetrics[] |
هي مجموعة من القيم الخاصة بالمقاييس المتعلّقة بالاتجاهات. |
نطاقات الأذونات
يتطلب استخدام أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/plus.business.manage
https://www.googleapis.com/auth/business.manage
لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.
DrivingDirectionMetricsRequest
طلب للحصول على إحصاءات اتجاهات القيادة
تمثيل JSON | |
---|---|
{
"numDays": enum ( |
الحقول | |
---|---|
numDays |
عدد الأيام لتجميع البيانات المتعلقة بها. ستكون النتائج التي يتم عرضها متوفرة لبيانات آخر عدد من الأيام المطلوبة. القيم الصالحة هي 7 و30 و90. |
languageCode |
تمثّل هذه السمة رمز BCP 47 للغة. إذا لم يتم تقديم رمز لغة، يتم ضبط اللغة التلقائية على الإنجليزية. |
NumDays
عدد الأيام التي يمكن أن يدعم فيها هذا الطلب.
عمليات التعداد | |
---|---|
SEVEN |
7 أيام. هذه هي القيمة الافتراضية. |
THIRTY |
30 يومًا. |
NINETY |
90 يومًا. |
LocationMetrics
سلسلة من المقاييس ومقياس التفاصيل المرتبطة بموقع جغرافي على مدار نطاق زمني معيّن.
تمثيل JSON | |
---|---|
{
"locationName": string,
"timeZone": string,
"metricValues": [
{
object ( |
الحقول | |
---|---|
locationName |
اسم مورد الموقع الذي تنتمي إليه هذه القيم. |
timeZone |
المنطقة الزمنية الصادرة عن منظمة IANA (المنظمة المعنية بأرقام الإنترنت المخصصة) للموقع الجغرافي. |
metricValues[] |
قائمة بقيم المقاييس المطلوبة |
LocationDrivingDirectionMetrics
موقع جغرافي تمت فهرسته حسب المناطق التي يأتي منها الأشخاص عادةً. ويتم تسجيل ذلك من خلال حساب عدد طلبات اتجاهات القيادة إلى هذا الموقع الجغرافي الواردة من كل منطقة.
تمثيل JSON | |
---|---|
{
"locationName": string,
"topDirectionSources": [
{
object ( |
الحقول | |
---|---|
locationName |
اسم مورد الموقع الذي تنتمي إليه قيمة المقياس هذه. |
topDirectionSources[] |
طلبات اتجاهات القيادة حسب منطقة المصدر حسب الاصطلاح، يتم فرزها حسب العدد مع 10 نتائج على الأكثر. |
timeZone |
المنطقة الزمنية (أرقام تعريف المناطق الزمنية الصادرة عن IANA، مثل "أوروبا/لندن") للموقع الجغرافي. |
TopDirectionSources
أبرز المناطق التي نشأت منها طلبات الحصول على اتجاهات القيادة
تمثيل JSON | |
---|---|
{
"dayCount": integer,
"regionCounts": [
{
object ( |
الحقول | |
---|---|
dayCount |
عدد الأيام التي يتم تجميع البيانات خلالها. |
regionCounts[] |
تم ترتيب المناطق تنازليًا حسب العدد. |
RegionCount
منطقة تتضمن عدد الطلبات المرتبطة بها.
تمثيل JSON | |
---|---|
{
"latlng": {
object ( |
الحقول | |
---|---|
latlng |
مركز المنطقة. |
label |
تمثّل هذه السمة تصنيفًا يسهل على الإنسان فهمه للمنطقة. |
count |
عدد طلبات اتجاهات القيادة من هذه المنطقة. |