الحصول على نتائج معلومات Google My Business حسب id
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
الحصول على نتائج معلومات Google My Business حسب id
يسترجع استعلام ملف Google Business Profile مصطفًّا حسب id. الاستجابة مغلّفة في غلاف DataForSEO: البيانات في tasks[0].result، والنتيجة في tasks[0].status_code — ولا يزال الطلب المرفوض يعيد HTTP 200. الاستجابة مغلّفة في غلاف DataForSEO: البيانات في tasks[0].result، والنتيجة في tasks[0].status_code — ولا يزال الطلب المرفوض يعيد HTTP 200. ⚠️ حُدّد حجم الاستجابة بـdepth أو الحد المضبوط وقت الإرسال، ولا يمكن تضييقه هنا؛ إذا كان كبيرًا جدًا، فأعد الإرسال بحجم أصغر بدلًا من الترقيم.
مرجع التسعير
- القياس: تكلفة الاستجابة المُبلَّغ عنها.
- تقدير الطلب المرجعي: 0.012 دولار أمريكي.
- مضاعف العميل المرجعي: 1.0. لا تُطبّقه مرة أخرى على مبلغ عميل مسوّى.
بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.
- النوع: object | null · Response36Afe1097B20_BusinessDataGoogleMyBusinessInfoTaskGetResponseInfo200
- النوع: number | null التنسيق: doublecost
إجمالي تكلفة المهام، بالدولار الأمريكي
- النوع: integer | nullstatus
_code رمز الحالة العام يمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا
- النوع: string | nullstatus
_message رسالة معلوماتية عامة يمكنك العثور على القائمة الكاملة للرسائل المعلوماتية العامة هنا
- النوع: array (object | null)[] | nulltasks
مصفوفة المهام
- النوع: object | null · Response36Afe1097B20_BusinessDataGoogleMyBusinessInfoTaskGetTaskInfo
- costالنوع: number | null التنسيق: double
إجمالي تكلفة المهام، بالدولار الأمريكي
- dataالنوع: object | null
يحتوي على المعاملات نفسها التي حددتها في طلب POST
- propertyالنوع: object | null
Name
- idالنوع: string | null
معرّف المهمة معرّف مهمة فريد في نظامنا بصيغة UUID
- pathالنوع: array (string | null)[] | null
مسار URL
- resultالنوع: array (object | null)[] | null
مصفوفة نتائج
- checkالنوع: string | null
_url عنوان URL مباشر لنتائج محرك البحث
يمكنك استخدامه للتأكد من أننا قدّمنا نتائج دقيقة - datetimeالنوع: string | null
التاريخ والوقت اللذان استُلمت فيهما النتيجة
بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2019-11-15 12:57:46 +00:00 - itemالنوع: array (string | null)[] | null
_types أنواع العناصر
أنواع نتائج محرك البحث التي تمت مصادفتها في مصفوفةitems؛
أنواع العناصر الممكنة:google_business_info - itemsالنوع: array (object | null)[] | null
مصفوفة عناصر الدليل
- additionalالنوع: array string[] | null
_categories فئات أعمال إضافية
فئات إضافية في Google My Business تصف الخدمات التي يقدمها الكيان التجاري بمزيد من التفصيل - addressالنوع: string | null
عنوان الكيان التجاري
- addressالنوع: object | null · Response36Afe1097B20_AddressInfo
_info كائن يحتوي على مكوّنات عنوان الكيان التجاري
- addressالنوع: string | null
عنوان الشارع للمنشأة المحلية
- boroughالنوع: string | null
الوحدة الإدارية أو المنطقة التي تنتمي إليها المنشأة المحلية
- cityالنوع: string | null
اسم المدينة التي تقع فيها المنشأة المحلية
- countryالنوع: string | null
_code رمز ISO للبلد الخاص بالمنشأة المحلية
- regionالنوع: string | null
منطقة DMA التي تنتمي إليها المنشأة المحلية
- zipالنوع: string | null
الرمز البريدي للمنشأة المحلية
- attributesالنوع: object | null · Response36Afe1097B20_BusinessDataAttributesInfo
تفاصيل الخدمة في شكل فحوص يراجعها المستخدمون;
تفاصيل خدمة كيان تجاري معروضة في شكل فحوص استنادًا إلى ملاحظات المستخدمين وcategoryالخاصة بالكيان- availableالنوع: object | null
_attributes السمات المتاحة
تشير إلى السمات التي يمكن أن يقدّمها الكيان التجاري- propertyالنوع: array (string | null)[] | null
Name
- unavailableالنوع: object | null
_attributes السمات غير المتاحة
تشير إلى السمات التي لا يمكن أن يقدّمها الكيان التجاري- propertyالنوع: array (string | null)[] | null
Name
- bookالنوع: string | null
_online _url عنوان URL في زر 'book online' في العنصر
عنوان URL يوجّه المستخدمين إلى صفحة الحجز أو الطلب عبر الإنترنت الخاصة بالكيان التجاري - categoryالنوع: string | null
فئة الأعمال
الفئة العامة في Google My Business التي تصف الخدمات التي يقدمها الكيان التجاري على أفضل وجه - categoryالنوع: array string[] | null
_ids معرّفات الفئات العالمية
معرّفات فئات عالمية لا تتغير حسب البلد المحدد - cidالنوع: string | null
- contactالنوع: string | null
_url عنوان URL لصفحة الاتصال المفضلة
- contributorالنوع: string | null
_url عنوان URL لملف Local Guides الخاص بالمستخدم أو الكيان، إن وُجد
- descriptionالنوع: string | null
وصف العنصر في SERP
وصف الكيان التجاري الذي تُجمع نتائجه - directoryالنوع: object | null · Response36Afe1097B20_BusinessDirectoryInfo
عناصر الدليل
يتضمن معلومات عن الأعمال التجارية الموجودة داخل المنشأة التجارية الهدف والتي لها العنوان نفسه- itemsالنوع: array (object | null)[] | null
أنواع العناصر التي تمت مصادفتها
أنواع نتائج محرك البحث التي تمت مصادفتها في مصفوفةitems؛
أنواع العناصر الممكنة:google_business_info- additionalالنوع: array string[] | null
_categories فئات أعمال إضافية
فئات إضافية في Google My Business تصف الخدمات التي يقدمها الكيان التجاري بمزيد من التفصيل - addressالنوع: string | null
عنوان الكيان التجاري
- addressالنوع: object | null · Response36Afe1097B20_AddressInfo
_info كائن يحتوي على مكوّنات عنوان الكيان التجاري
- addressالنوع: string | null
عنوان الشارع للمنشأة المحلية
- boroughالنوع: string | null
الوحدة الإدارية أو المنطقة التي تنتمي إليها المنشأة المحلية
- cityالنوع: string | null
اسم المدينة التي تقع فيها المنشأة المحلية
- countryالنوع: string | null
_code رمز ISO للبلد الخاص بالمنشأة المحلية
- regionالنوع: string | null
منطقة DMA التي تنتمي إليها المنشأة المحلية
- zipالنوع: string | null
الرمز البريدي للمنشأة المحلية
- categoryالنوع: string | null
فئة الأعمال
الفئة العامة في Google My Business التي تصف الخدمات التي يقدمها الكيان التجاري على أفضل وجه - categoryالنوع: array string[] | null
_ids معرّفات الفئات العالمية
معرّفات فئات عالمية لا تتغير حسب البلد المحدد - cidالنوع: string | null
- domainالنوع: string | null
نطاق الكيان التجاري
- featureالنوع: string | null
_id - hotelالنوع: string | null
_rating - isالنوع: boolean | null
_claimed يوضح ما إذا كان الكيان موثّقًا من مالكه على Google Maps
- isالنوع: boolean | null
_directory _item المنشأة التجارية جزء من الدليل
يشير إلى ما إذا كانت المنشأة التجارية جزءًا من الدليل
إذا كانتtrue، فالعنصر جزء من دليل أكبر للأعمال بالعنوان نفسه (مثل مركز تجاري أو مجمع أعمال)
ملاحظة: إذا كانت المنشأة التجارية عنصرًا أبًا في الدليل، فستكون القيمةnull - latitudeالنوع: number | null
إحداثي خط العرض للمنشآت المحلية في google maps
مثال:"latitude": 51.584091 - localالنوع: array string[] | null
_justifications التبريرات المحلية من Google
مقتطفات نصية «تبرّر» سبب ظهور النشاط التجاري في استعلام البحث - longitudeالنوع: number | null
إحداثي خط الطول للمنشأة المحلية في google maps
مثال:"longitude": -0.31365919999999997 - mainالنوع: string | null
_image عنوان URL للصورة الرئيسية المضمّنة في ملف Google My Business
- phoneالنوع: string | null
رقم هاتف الكيان التجاري
- placeالنوع: string | null
_id معرّف مكان فريد
معرّف المكان للمنشأة المحلية المضمّنة في العنصر
تعرّف على المزيد حول المعرّف في مقالة مركز المساعدة هذه - priceالنوع: string | null
_level مستوى سعر المنشأة
يمكن أن يأخذ القيم:inexpensive،moderate،expensive،very_expensive
إذا لم تتوفر معلومات عن مستوى السعر، ستكون القيمةnull - rankالنوع: integer | null
_absolute الترتيب المطلق بين جميع العناصر
- rankالنوع: integer | null
_group الموضع ضمن مجموعة عناصر ذات قيم
typeمتطابقة
تُستبعد مواضع العناصر ذات قيمtypeمختلفة منrank_group - ratingالنوع: object | null · Response36Afe1097B20_RatingInfo
تقييم العنصر
معدّل الشعبية المستند إلى المراجعات والمعروض في SERP- ratingالنوع: integer | null
_max الحد الأقصى لقيمة rating_type
- ratingالنوع: string | null
_type نوع التقييم هنا يمكنك العثور على العناصر التالية: Max5، Percents، CustomMax
- valueالنوع: number | null التنسيق: double
قيمة التقييم
- votesالنوع: integer | null التنسيق: int64
_count مقدار الملاحظات
- ratingالنوع: object | null
_distribution توزيع تقييمات الكيان التجاري يعرض الكائن عدد التقييمات من نجمة واحدة إلى 5 نجوم، كما راجعها المستخدمون
- propertyالنوع: integer | null التنسيق: Int64
Name
- snippetالنوع: string | null
معلومات إضافية عن الكيان التجاري
- titleالنوع: string | null
عنوان الدليل
يمكن أن يأخذ القيم التالية:At this place،Directory - totalالنوع: string | null التنسيق: int64
_photos العدد الإجمالي للصور المضمّنة في ملف Google My Business
- typeالنوع: string | null
نوع العنصر
- urlالنوع: string | null
عنوان URL لعرض القائمة
- workالنوع: object | null · Response36Afe1097B20_BusinessWorkHoursInfo
_hours ساعات العمل
معلومات عن ساعات عمل المنشأة المحلية- workالنوع: object | null · Response36Afe1097B20_WorkHours
_hours ساعات العمل
معلومات عن ساعات عمل المنشأة المحلية- currentالنوع: string | null
_status الحالة الحالية للمنشأة
يشير إلى ما إذا كانت المنشأة مفتوحة أم مغلقة - timetableالنوع: object | null
الجدول الزمني لساعات العمل
- propertyالنوع: array (object | null)[] | null
Name ساعات العمل أيام الأحد
- closeالنوع: object | null · Response36Afe1097B20_TimeInfo
وقت الإغلاق
- hourالنوع: integer | null
الساعات بتنسيق 24 ساعة
- minuteالنوع: integer | null
الدقائق
- openالنوع: object | null · Response36Afe1097B20_TimeInfo
وقت الفتح
- hourالنوع: integer | null
الساعات بتنسيق 24 ساعة
- minuteالنوع: integer | null
الدقائق
- titleالنوع: string | null
عنوان العنصر
نطاق نظام قائمة الطعام عبر الإنترنت
- domainالنوع: string | null
نطاق الكيان التجاري
- featureالنوع: string | null
_id - hotelالنوع: number | null
_rating - isالنوع: boolean | null
_claimed يوضح ما إذا كان الكيان موثّقًا من مالكه على Google Maps
- isالنوع: boolean | null
_directory _item المنشأة التجارية جزء من الدليل
يشير إلى ما إذا كانت المنشأة التجارية جزءًا من الدليل
إذا كانتtrue، فالعنصر جزء من دليل أكبر للأعمال بالعنوان نفسه (مثل مركز تجاري أو مجمع أعمال)
ملاحظة: إذا كانت المنشأة التجارية عنصرًا أبًا في الدليل، فستكون القيمةnull - latitudeالنوع: number | null
إحداثي خط العرض للمنشآت المحلية في google maps
مثال:"latitude": 51.584091 - localالنوع: array (object | null)[] | null
_business _links التفاعلات المتاحة مع النشاط التجاري
قائمة خيارات للتفاعل مع النشاط التجاري مباشرةً من نتائج البحث- typeالنوع: string | null
نوع العنصر
- logoالنوع: string | null
عنوان URL للشعار المعروض في ملف Google My Business
- longitudeالنوع: number | null
إحداثي خط الطول للمنشأة المحلية في google maps
مثال:"longitude": -0.31365919999999997 - mainالنوع: string | null
_image عنوان URL للصورة الرئيسية المضمّنة في ملف Google My Business
- originalالنوع: string | null
_title العنوان الأصلي للعنصر
العنوان الأصلي غير المترجم من Google - peopleالنوع: array (object | null)[] | null
_also _search الكيانات التجارية ذات الصلة
- cidالنوع: string | null
- featureالنوع: string | null
_id - ratingالنوع: object | null · Response36Afe1097B20_RatingInfo
تقييم العنصر
معدّل الشعبية المستند إلى المراجعات والمعروض في SERP- ratingالنوع: integer | null
_max الحد الأقصى لقيمة rating_type
- ratingالنوع: string | null
_type نوع التقييم هنا يمكنك العثور على العناصر التالية: Max5، Percents، CustomMax
- valueالنوع: number | null التنسيق: double
قيمة التقييم
- votesالنوع: integer | null التنسيق: int64
_count مقدار الملاحظات
- titleالنوع: string | null
عنوان العنصر في SERP
اسم الكيان التجاري الذي تُجمع نتائجه
- phoneالنوع: string | null
رقم هاتف الكيان التجاري
- placeالنوع: string | null
_id معرّف مكان فريد
معرّف المكان للمنشأة المحلية المضمّنة في العنصر
تعرّف على المزيد حول المعرّف في مقالة مركز المساعدة هذه - placeالنوع: object | null
_topics الكلمات المفتاحية المذكورة في مراجعات العملاء
تحتوي على الكلمات المفتاحية الأكثر شيوعًا المرتبطة بالمنتجات/الخدمات المذكورة في مراجعات العملاء لكيان تجاري وعدد المراجعات التي تذكر كل كلمة مفتاحية
مثال:
"place_topics": {
"egg roll": 48,
"birthday": 33
}- propertyالنوع: integer | null التنسيق: int64
Name Signed 64-bit integers (long type).
- popularالنوع: object | null · Response36Afe1097B20_PopularTimes
_times الأوقات الشائعة
معلومات متعلقة بساعات ازدحام الكيان التجاري- popularالنوع: object | null
_times _by _days ساعات الذروة
معلومات عن ساعات الازدحام في المنشأة المحلية في كل يوم من أيام الأسبوع- propertyالنوع: array (object | null)[] | null
Name ساعات العمل أيام الأحد
- popularالنوع: integer | null
_index مؤشر الشعبية مؤشر شعبية نسبي مرتبط بالوقت يُقاس من 0 إلى 100؛ تعني القيمة الأعلى وقتًا أكثر ازدحامًا في اليوم
- timeالنوع: object | null · Response36Afe1097B20_TimeInfo
الساعات بتنسيق 24 ساعة
- hourالنوع: integer | null
الساعات بتنسيق 24 ساعة
- minuteالنوع: integer | null
الدقائق
- positionالنوع: string | null
المحاذاة في SERP
- priceالنوع: string | null
_level مستوى سعر المنشأة
يمكن أن يأخذ القيم:inexpensive،moderate،expensive،very_expensive
إذا لم تتوفر معلومات عن مستوى السعر، ستكون القيمةnull - questionsالنوع: integer | null
_and _answers _count Integer numbers.
- rankالنوع: integer | null
_absolute الترتيب المطلق بين جميع العناصر
- rankالنوع: integer | null
_group الموضع ضمن مجموعة عناصر لها قيم
typeمتطابقة
تُستبعد مواضع العناصر ذات قيمtypeالمختلفة منrank_group - ratingالنوع: object | null · Response36Afe1097B20_RatingInfo
تقييم العنصر
معدّل الشعبية المستند إلى المراجعات والمعروض في SERP- ratingالنوع: integer | null
_max الحد الأقصى لقيمة rating_type
- ratingالنوع: string | null
_type نوع التقييم هنا يمكنك العثور على العناصر التالية: Max5، Percents، CustomMax
- valueالنوع: number | null التنسيق: double
قيمة التقييم
- votesالنوع: integer | null التنسيق: int64
_count مقدار الملاحظات
- ratingالنوع: object | null
_distribution توزيع تقييمات الكيان التجاري
يعرض الكائن عدد التقييمات من نجمة واحدة إلى 5 نجوم، بحسب تقييمات المستخدمين- propertyالنوع: integer | null التنسيق: Int64
Name
- servicesالنوع: array (object | null)[] | null
قائمة الخدمات التي يقدمها النشاط التجاري
- categoryالنوع: string | null
فئة الأعمال
الفئة العامة في Google My Business التي تصف الخدمات التي يقدمها الكيان التجاري على أفضل وجه - priceالنوع: object | null · Response36Afe1097B20_PriceInfo
- currencyالنوع: string | null
عملة السعر المدرج رمز ISO للعملة المطبّقة على السعر
- currentالنوع: number | null التنسيق: double
السعر الحالي يشير إلى السعر الحالي للمنتج أو الخدمة المعروضة في النتيجة
- displayedالنوع: string | null
_price سلسلة السعر في النتيجة سلسلة السعر الخام كما وردت في النتيجة
- isالنوع: boolean | null
_price _range يُقدَّم السعر كنطاق تشير إلى ما إذا كان السعر مقدَّمًا كنطاق
- maxالنوع: number | null التنسيق: double
_value الحد الأقصى للسعر الحد الأقصى لسعر المنتج أو الخدمة كما هو مبيَّن في النتيجة
- regularالنوع: number | null التنسيق: double
السعر العادي يشير إلى السعر العادي للمنتج أو الخدمة دون تطبيق أي خصومات
- snippetالنوع: string | null
معلومات إضافية عن الكيان التجاري
- titleالنوع: string | null
عنوان العنصر في SERP
اسم الكيان التجاري الذي تُجمع نتائجه
- snippetالنوع: string | null
معلومات إضافية عن الكيان التجاري
- titleالنوع: string | null
عنوان العنصر في SERP
اسم الكيان التجاري الذي تُجمع نتائجه - totalالنوع: integer | null التنسيق: int64
_photos العدد الإجمالي للصور المضمّنة في ملف Google My Business
- typeالنوع: string | null
نوع العنصر
- urlالنوع: string | null
عنوان URL المطلق للكيان التجاري
- workالنوع: object | null · Response36Afe1097B20_BusinessWorkHoursInfo
_time تفاصيل ساعات العمل
معلومات متعلقة بساعات عمل الكيان التجاري- workالنوع: object | null · Response36Afe1097B20_WorkHours
_hours ساعات العمل
معلومات عن ساعات عمل المنشأة المحلية- currentالنوع: string | null
_status الحالة الحالية للمنشأة
يشير إلى ما إذا كانت المنشأة مفتوحة أم مغلقة - timetableالنوع: object | null
الجدول الزمني لساعات العمل
- propertyالنوع: array (object | null)[] | null
Name ساعات العمل أيام الأحد
- closeالنوع: object | null · Response36Afe1097B20_TimeInfo
وقت الإغلاق
- hourالنوع: integer | null
الساعات بتنسيق 24 ساعة
- minuteالنوع: integer | null
الدقائق
- openالنوع: object | null · Response36Afe1097B20_TimeInfo
وقت الفتح
- hourالنوع: integer | null
الساعات بتنسيق 24 ساعة
- minuteالنوع: integer | null
الدقائق
- itemsالنوع: integer | null التنسيق: int64
_count أنواع العناصر
عدد العناصر في مصفوفةitems - keywordالنوع: string | null
- languageالنوع: string | null
_code رمز اللغة في مصفوفة POST
- locationالنوع: integer | null
_code رمز الموقع في مصفوفة POST
- seالنوع: string | null
_domain نطاق محرك البحث كما هو محدد في مصفوفة POST
- resultالنوع: integer | null التنسيق: int64
_count عدد العناصر في مصفوفة result
- statusالنوع: integer | null
_code رمز حالة المهمة ينشئه DataForSEO ويمكن أن يقع ضمن النطاق التالي: 10000-60000 يمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا
- statusالنوع: string | null
_message الرسالة المعلوماتية للمهمة يمكنك العثور على القائمة الكاملة للرسائل المعلوماتية العامة هنا
- timeالنوع: string | null
وقت التنفيذ، بالثواني
- النوع: integer | null التنسيق: int64tasks
_count عدد المهام في مصفوفة tasks
- النوع: integer | null التنسيق: int64tasks
_error عدد المهام في مصفوفة tasks التي أُعيدت مع خطأ
- النوع: string | nulltime
إجمالي وقت التنفيذ، بالثواني
- النوع: string | nullversion
الإصدار الحالي من API
application/json - 400
تعذّرت معالجة الطلب. تحقق من معاملات الطلب.
- 401
مطلوب مفتاح API صالح من Felo.
- 402
لا يمكن متابعة الطلب لأن أحد متطلبات الفوترة غير مستوفٍ.
- 403
الحساب غير مصرّح له بهذه العملية.
- 429
تم بلوغ حد الطلبات أو حد الإنفاق.
- 502
تعذّر على الخدمة إكمال الطلب.
- 503
خدمة API أو الفوترة غير متاحة مؤقتًا.
- 504
انتهت مهلة الخدمة أثناء معالجة الطلب.
- default
استجابة خطأ؛ قد تستخدم استجابات المنبع الممرَّرة تنسيقات المزوّد
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/my_business_info/task_get/00000000-0000-0000-0000-000000000000 \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": [
{
"keyword": null,
"se_domain": null,
"location_code": null,
"language_code": null,
"check_url": null,
"datetime": null,
"item_types": [
null
],
"items_count": null,
"items": [
{
"type": null,
"rank_group": null,
"rank_absolute": null,
"position": null,
"title": null,
"original_title": null,
"description": null,
"category": null,
"category_ids": [
"[Max Depth Exceeded]"
],
"additional_categories": [
"[Max Depth Exceeded]"
],
"cid": null,
"feature_id": null,
"address": null,
"address_info": "[Max Depth Exceeded]",
"place_id": null,
"phone": null,
"url": null,
"contact_url": null,
"contributor_url": null,
"book_online_url": null,
"domain": null,
"logo": null,
"main_image": null,
"total_photos": null,
"snippet": null,
"latitude": null,
"longitude": null,
"is_claimed": null,
"questions_and_answers_count": null,
"attributes": "[Max Depth Exceeded]",
"place_topics": null,
"rating": "[Max Depth Exceeded]",
"hotel_rating": null,
"price_level": null,
"rating_distribution": null,
"people_also_search": [
"[Max Depth Exceeded]"
],
"work_time": "[Max Depth Exceeded]",
"popular_times": "[Max Depth Exceeded]",
"local_business_links": [
"[Max Depth Exceeded]"
],
"is_directory_item": null,
"directory": "[Max Depth Exceeded]",
"services": [
"[Max Depth Exceeded]"
]
}
]
}
]
}
]
}