Felo API PlatformFelo API Platform
جميع endpoints الخاصة بـ DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

إعداد مهام معلومات Google My Business المباشرة

Felo API Support
MIT
الخادم:https://openapi.felo.ai
مكتبات العملاء
Shell Curl

DataForSEO

​

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO العمليات

إعداد مهام معلومات Google My Business المباشرة

​

ملف Google Business Profile واحد: الاسم والعنوان والهاتف وساعات العمل والتقييم والفئة والسمات التي يعرضها Google في اللوحة. الاستجابة مغلّفة في غلاف DataForSEO: البيانات في tasks[0].result، والنتيجة في tasks[0].status_code — ولا يزال الطلب المرفوض يعيد HTTP 200. التوأم المصطفّ هو post_dataforseo_business_google_gmb_info_submit. لما نشره المالك مؤخرًا استخدم post_dataforseo_business_google_gmb_updates_submit، ولرأي العملاء post_dataforseo_business_google_reviews_submit.

مرجع التسعير

  • القياس: تكلفة الاستجابة المُبلَّغ عنها.
  • تقدير الطلب المرجعي: 0.0054 دولار أمريكي.
  • مضاعف العميل المرجعي: 1.0. لا تُطبّقه مرة أخرى على مبلغ عميل مسوّى.

بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.

الجسم
application/json
  • النوع: array (object | null)[]
    • keyword
      النوع: string

      الكلمة المفتاحية
      حقل مطلوب
      يجب أن تشير الكلمة المفتاحية التي تحددها إلى اسم المنشأة المحلية
      يمكنك تحديد حتى 700 حرف في حقل keyword
      ستُفكّ جميع ترميزات %## (وسيُفكّ الحرف ‘+’ إلى مسافة)
      إذا كنت بحاجة إلى استخدام الحرف “%” في keyword، فحدده بالشكل “%25”؛

      يمكن استخدام هذا الحقل أيضًا لتمرير المعاملات التالية:
      cid - معرّف فريد يحدده Google للكيان التجاري؛
      place_id - معرّف الكيان التجاري في Google Maps

      مثال:
      cid:194604053573767737
      place_id:GhIJQWDl0CIeQUARxks3icF8U8A

      اعرف المزيد عن المعرّفين cid وplace_id في مقالة مركز المساعدة هذه

      اعرف المزيد عن قواعد وقيود حقلي keyword وkeywords في واجهات DataForSEO في مقالة مركز المساعدة هذه

    • language_code
      النوع: string

      رمز لغة محرك البحث
      حقل مطلوب إذا لم تحدد language_name
      إذا استخدمت هذا الحقل، فلا حاجة لتحديد language_name
      يمكنك الحصول على قائمة اللغات المتاحة مع language_code عبر إرسال طلب منفصل إلى https://api.dataforseo.com/v3/business_data/google/languages
      مثال:
      en

    • language_name
      النوع: string

      الاسم الكامل للغة محرك البحث
      حقل مطلوب إذا لم تحدد language_code
      إذا استخدمت هذا الحقل، فلا حاجة لتحديد language_code
      يمكنك الحصول على قائمة اللغات المتاحة مع language_name عبر إرسال طلب منفصل إلى https://api.dataforseo.com/v3/business_data/google/languages
      مثال:
      English

    • location_code
      النوع: integer

      رمز موقع محرك البحث
      حقل مطلوب إذا لم تحدد location_name أو location_coordinate
      إذا استخدمت هذا الحقل، فلا حاجة لتحديد location_name أو location_coordinate
      يمكنك الحصول على قائمة المواقع المتاحة مع location_code عبر إرسال طلب منفصل إلى https://api.dataforseo.com/v3/business_data/google/locations
      مثال:
      2840

    • location_coordinate
      النوع: string

      إحداثيات GPS للموقع
      حقل مطلوب إذا لم تحدد location_name أو location_code
      إذا استخدمت هذا الحقل، فلا حاجة لتحديد location_name أو location_code
      يجب تحديد معامل location_coordinate بصيغة "latitude,longitude,radius"
      الحد الأقصى لعدد الخانات العشرية لـ "latitude" و"longitude": 7
      الحد الأدنى لقيمة "radius": 199.9 (مم)
      الحد الأقصى لقيمة "radius": 199999 (مم)
      مثال:
      53.476225,-2.243572,200

    • location_name
      النوع: string

      الاسم الكامل لموقع محرك البحث
      حقل مطلوب إذا لم تحدد location_code أو location_coordinate
      إذا استخدمت هذا الحقل، فلا حاجة لتحديد location_code أو location_coordinate
      يمكنك الحصول على قائمة المواقع المتاحة مع location_name عبر إرسال طلب منفصل إلى https://api.dataforseo.com/v3/business_data/google/locations
      مثال:
      London,England,United Kingdom

    • tag
      النوع: string | null

      معرّف مهمة يحدده المستخدم
      حقل اختياري
      الحد الأقصى للأحرف هو 255
      يمكنك استخدام هذا المعامل لتمييز المهمة ومطابقتها مع النتيجة
      ستجد قيمة tag المحددة في كائن data ضمن الاستجابة

الاستجابات
  • 200
    النوع: object | null · Response36Afe1097B20_BusinessDataGoogleMyBusinessInfoLiveResponseInfo
    • cost
      النوع: number | null التنسيق: double

      إجمالي تكلفة المهام، بالدولار الأمريكي

    • status_code
      النوع: integer | null

      رمز الحالة العام يمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا

    • status_message
      النوع: string | null

      رسالة معلوماتية عامة يمكنك العثور على القائمة الكاملة للرسائل المعلوماتية العامة هنا

    • tasks
      النوع: array (object | null)[] | null

      مصفوفة المهام

      • النوع: object | null · Response36Afe1097B20_BusinessDataGoogleMyBusinessInfoLiveTaskInfo
        • cost
          النوع: number | null التنسيق: double

          إجمالي تكلفة المهام، بالدولار الأمريكي

        • data
          النوع: object | null

          يحتوي على المعاملات نفسها التي حددتها في طلب POST

          • propertyName
            النوع: object | null
        • id
          النوع: string | null

          معرّف المهمة معرّف مهمة فريد في نظامنا بصيغة UUID

        • path
          النوع: array (string | null)[] | null

          مسار URL

        • result
          النوع: array (object | null)[] | null

          مصفوفة نتائج

          • check_url
            النوع: string | null

            عنوان URL مباشر لنتائج محرك البحث
            يمكنك استخدامه للتأكد من أننا قدّمنا نتائج دقيقة

          • datetime
            النوع: string | null

            التاريخ والوقت اللذان استُلمت فيهما النتيجة
            بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”
            مثال:
            2019-11-15 12:57:46 +00:00

          • item_types
            النوع: array (string | null)[] | null

            أنواع العناصر
            أنواع نتائج محرك البحث التي تمت مصادفتها في مصفوفة items؛
            أنواع العناصر الممكنة: google_business_info

          • items
            النوع: array (object | null)[] | null

            أنواع العناصر التي تمت مصادفتها
            أنواع نتائج محرك البحث التي تمت مصادفتها في مصفوفة items؛
            أنواع العناصر الممكنة: google_business_info

            • additional_categories
              النوع: array string[] | null

              فئات أعمال إضافية
              فئات إضافية في Google My Business تصف الخدمات التي يقدمها الكيان التجاري بمزيد من التفصيل

            • address
              النوع: string | null

              عنوان الكيان التجاري

            • address_info
              النوع: object | null · Response36Afe1097B20_AddressInfo

              كائن يحتوي على مكوّنات عنوان الكيان التجاري

              • address
                النوع: string | null

                عنوان الشارع للمنشأة المحلية

              • borough
                النوع: string | null

                الوحدة الإدارية أو المنطقة التي تنتمي إليها المنشأة المحلية

              • city
                النوع: string | null

                اسم المدينة التي تقع فيها المنشأة المحلية

              • country_code
                النوع: string | null

                رمز ISO للبلد الخاص بالمنشأة المحلية

              • region
                النوع: string | null

                منطقة DMA التي تنتمي إليها المنشأة المحلية

              • zip
                النوع: string | null

                الرمز البريدي للمنشأة المحلية

            • attributes
              النوع: object | null · Response36Afe1097B20_BusinessDataAttributesInfo

              تفاصيل الخدمة في شكل فحوص يراجعها المستخدمون;
              تفاصيل خدمة كيان تجاري معروضة في شكل فحوص استنادًا إلى ملاحظات المستخدمين وcategory الخاصة بالكيان

              • available_attributes
                النوع: object | null

                السمات المتاحة
                تشير إلى السمات التي يمكن أن يقدّمها الكيان التجاري

                • propertyName
                  النوع: array (string | null)[] | null
              • unavailable_attributes
                النوع: object | null

                السمات غير المتاحة
                تشير إلى السمات التي لا يمكن أن يقدّمها الكيان التجاري

                • propertyName
                  النوع: array (string | null)[] | null
            • book_online_url
              النوع: string | null

              عنوان URL في زر 'book online' في العنصر
              عنوان URL يوجّه المستخدمين إلى صفحة الحجز أو الطلب عبر الإنترنت الخاصة بالكيان التجاري

            • category
              النوع: string | null

              فئة الأعمال
              الفئة العامة في Google My Business التي تصف الخدمات التي يقدمها الكيان التجاري على أفضل وجه

            • category_ids
              النوع: array string[] | null

              معرّفات الفئات العالمية
              معرّفات فئات عالمية لا تتغير حسب البلد المحدد

            • cid
              النوع: string | null

              معرّف العميل المحدد من Google
              معرّف فريد لمنشأة محلية
              يمكن استخدامه مع Google Reviews API للحصول على قائمة كاملة بالمراجعات
              تعرّف على المزيد حول المعرّف في مقالة مركز المساعدة هذه

            • contact_url
              النوع: string | null

              عنوان URL لصفحة الاتصال المفضلة

            • contributor_url
              النوع: string | null

              عنوان URL لملف Local Guides الخاص بالمستخدم أو الكيان، إن وُجد

            • description
              النوع: string | null

              وصف العنصر في SERP
              وصف الكيان التجاري الذي تُجمع نتائجه

            • directory
              النوع: object | null · Response36Afe1097B20_BusinessDirectoryInfo

              عناصر الدليل
              يتضمن معلومات عن الأعمال التجارية الموجودة داخل المنشأة التجارية الهدف والتي لها العنوان نفسه

              • items
                النوع: array (object | null)[] | null

                أنواع العناصر التي تمت مصادفتها
                أنواع نتائج محرك البحث التي تمت مصادفتها في مصفوفة items؛
                أنواع العناصر الممكنة: google_business_info

                • additional_categories
                  النوع: array string[] | null

                  فئات أعمال إضافية
                  فئات إضافية في Google My Business تصف الخدمات التي يقدمها الكيان التجاري بمزيد من التفصيل

                • address
                  النوع: string | null

                  عنوان الكيان التجاري

                • address_info
                  النوع: object | null · Response36Afe1097B20_AddressInfo

                  كائن يحتوي على مكوّنات عنوان الكيان التجاري

                  • address
                    النوع: string | null

                    عنوان الشارع للمنشأة المحلية

                  • borough
                    النوع: string | null

                    الوحدة الإدارية أو المنطقة التي تنتمي إليها المنشأة المحلية

                  • city
                    النوع: string | null

                    اسم المدينة التي تقع فيها المنشأة المحلية

                  • country_code
                    النوع: string | null

                    رمز ISO للبلد الخاص بالمنشأة المحلية

                  • region
                    النوع: string | null

                    منطقة DMA التي تنتمي إليها المنشأة المحلية

                  • zip
                    النوع: string | null

                    الرمز البريدي للمنشأة المحلية

                • category
                  النوع: string | null

                  فئة الأعمال
                  الفئة العامة في Google My Business التي تصف الخدمات التي يقدمها الكيان التجاري على أفضل وجه

                • category_ids
                  النوع: array string[] | null

                  معرّفات الفئات العالمية
                  معرّفات فئات عالمية لا تتغير حسب البلد المحدد

                • cid
                  النوع: string | null

                  معرّف العميل المحدد من Google
                  معرّف فريد لمنشأة محلية
                  يمكن استخدامه مع Google Reviews API للحصول على قائمة كاملة بالمراجعات
                  تعرّف على المزيد حول المعرّف في مقالة مركز المساعدة هذه

                • domain
                  النوع: string | null

                  نطاق الكيان التجاري

                • feature_id
                  النوع: string | null

                  المعرّف الفريد للعنصر في SERP
                  تعرّف على المزيد حول المعرّف في مقالة مركز المساعدة هذه

                • hotel_rating
                  النوع: string | null

                  تقييم فئة الفندق
                  تتراوح تقييمات الفئة بين 1 و5 نجوم، تعرّف على المزيد
                  إذا لم تتوفر معلومات عن تقييم فئة الفندق، ستكون القيمة null

                • is_claimed
                  النوع: boolean | null

                  يوضح ما إذا كان الكيان موثّقًا من مالكه على Google Maps

                • is_directory_item
                  النوع: boolean | null

                  المنشأة التجارية جزء من الدليل
                  يشير إلى ما إذا كانت المنشأة التجارية جزءًا من الدليل
                  إذا كانت true، فالعنصر جزء من دليل أكبر للأعمال بالعنوان نفسه (مثل مركز تجاري أو مجمع أعمال)
                  ملاحظة: إذا كانت المنشأة التجارية عنصرًا أبًا في الدليل، فستكون القيمة null

                • latitude
                  النوع: number | null

                  إحداثي خط العرض للمنشآت المحلية في google maps
                  مثال:
                  "latitude": 51.584091

                • local_justifications
                  النوع: array string[] | null

                  التبريرات المحلية من Google
                  مقتطفات نصية «تبرّر» سبب ظهور النشاط التجاري في استعلام البحث

                • longitude
                  النوع: number | null

                  إحداثي خط الطول للمنشأة المحلية في google maps
                  مثال:
                  "longitude": -0.31365919999999997

                • main_image
                  النوع: string | null

                  عنوان URL للصورة الرئيسية المضمّنة في ملف Google My Business

                • phone
                  النوع: string | null

                  رقم هاتف الكيان التجاري

                • place_id
                  النوع: string | null

                  معرّف مكان فريد
                  معرّف المكان للمنشأة المحلية المضمّنة في العنصر
                  تعرّف على المزيد حول المعرّف في مقالة مركز المساعدة هذه

                • price_level
                  النوع: string | null

                  مستوى سعر المنشأة
                  يمكن أن يأخذ القيم: inexpensive، moderate، expensive، very_expensive
                  إذا لم تتوفر معلومات عن مستوى السعر، ستكون القيمة null

                • rank_absolute
                  النوع: integer | null

                  الترتيب المطلق بين جميع العناصر

                • rank_group
                  النوع: integer | null

                  الموضع ضمن مجموعة عناصر ذات قيم type متطابقة
                  تُستبعد مواضع العناصر ذات قيم type مختلفة من rank_group

                • rating
                  النوع: object | null · Response36Afe1097B20_RatingInfo

                  تقييم العنصر
                  معدّل الشعبية المستند إلى المراجعات والمعروض في SERP

                  • rating_max
                    النوع: integer | null

                    الحد الأقصى لقيمة rating_type

                  • rating_type
                    النوع: string | null

                    نوع التقييم هنا يمكنك العثور على العناصر التالية: Max5، Percents، CustomMax

                  • value
                    النوع: number | null التنسيق: double

                    قيمة التقييم

                  • votes_count
                    النوع: integer | null التنسيق: int64

                    مقدار الملاحظات

                • rating_distribution
                  النوع: object | null

                  توزيع تقييمات الكيان التجاري يعرض الكائن عدد التقييمات من نجمة واحدة إلى 5 نجوم، كما راجعها المستخدمون

                  • propertyName
                    النوع: integer | null التنسيق: Int64
                • snippet
                  النوع: string | null

                  معلومات إضافية عن الكيان التجاري

                • title
                  النوع: string | null

                  عنوان الدليل
                  يمكن أن يأخذ القيم التالية: At this place، Directory

                • total_photos
                  النوع: string | null التنسيق: int64

                  العدد الإجمالي للصور المضمّنة في ملف Google My Business

                • type
                  النوع: string | null

                  نوع العنصر

                • url
                  النوع: string | null

                  عنوان URL لعرض القائمة

                • work_hours
                  النوع: object | null · Response36Afe1097B20_BusinessWorkHoursInfo

                  ساعات العمل
                  معلومات عن ساعات عمل المنشأة المحلية

                  • work_hours
                    النوع: object | null · Response36Afe1097B20_WorkHours

                    ساعات العمل
                    معلومات عن ساعات عمل المنشأة المحلية

                    • current_status
                      النوع: string | null

                      الحالة الحالية للمنشأة
                      يشير إلى ما إذا كانت المنشأة مفتوحة أم مغلقة

                    • timetable
                      النوع: object | null

                      الجدول الزمني لساعات العمل

                      • propertyName
                        النوع: array (object | null)[] | null

                        ساعات العمل أيام الأحد

                        • 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_id
              النوع: string | null

              المعرّف الفريد للعنصر في SERP
              تعرّف على المزيد حول المعرّف في مقالة مركز المساعدة هذه

            • hotel_rating
              النوع: number | null

              تقييم فئة الفندق
              تتراوح تقييمات الفئة بين 1 و5 نجوم، تعرّف على المزيد
              إذا لم تتوفر معلومات عن تقييم فئة الفندق، ستكون القيمة null

            • is_claimed
              النوع: boolean | null

              يوضح ما إذا كان الكيان موثّقًا من مالكه على Google Maps

            • is_directory_item
              النوع: boolean | null

              المنشأة التجارية جزء من الدليل
              يشير إلى ما إذا كانت المنشأة التجارية جزءًا من الدليل
              إذا كانت true، فالعنصر جزء من دليل أكبر للأعمال بالعنوان نفسه (مثل مركز تجاري أو مجمع أعمال)
              ملاحظة: إذا كانت المنشأة التجارية عنصرًا أبًا في الدليل، فستكون القيمة null

            • latitude
              النوع: number | null

              إحداثي خط العرض للمنشآت المحلية في google maps
              مثال:
              "latitude": 51.584091

            • local_business_links
              النوع: array (object | null)[] | null

              التفاعلات المتاحة مع النشاط التجاري
              قائمة خيارات للتفاعل مع النشاط التجاري مباشرةً من نتائج البحث

              • type
                النوع: string | null

                نوع العنصر

            • logo
              النوع: string | null

              عنوان URL للشعار المعروض في ملف Google My Business

            • longitude
              النوع: number | null

              إحداثي خط الطول للمنشأة المحلية في google maps
              مثال:
              "longitude": -0.31365919999999997

            • main_image
              النوع: string | null

              عنوان URL للصورة الرئيسية المضمّنة في ملف Google My Business

            • original_title
              النوع: string | null

              العنوان الأصلي للعنصر
              العنوان الأصلي غير المترجم من Google

            • people_also_search
              النوع: array (object | null)[] | null

              الكيانات التجارية ذات الصلة

              • cid
                النوع: string | null

                معرّف العميل المحدد من Google
                المعرّف الفريد لمنشأة محلية
                اعرف المزيد عن المعرّف في مقالة مركز المساعدة هذه

              • feature_id
                النوع: string | null

                المعرّف الفريد للعنصر في SERP
                تعرّف على المزيد حول المعرّف في مقالة مركز المساعدة هذه

              • rating
                النوع: object | null · Response36Afe1097B20_RatingInfo

                تقييم العنصر
                معدّل الشعبية المستند إلى المراجعات والمعروض في SERP

                • rating_max
                  النوع: integer | null

                  الحد الأقصى لقيمة rating_type

                • rating_type
                  النوع: string | null

                  نوع التقييم هنا يمكنك العثور على العناصر التالية: Max5، Percents، CustomMax

                • value
                  النوع: number | null التنسيق: double

                  قيمة التقييم

                • votes_count
                  النوع: integer | null التنسيق: int64

                  مقدار الملاحظات

              • title
                النوع: string | null

                عنوان العنصر في SERP
                اسم الكيان التجاري الذي تُجمع نتائجه

            • phone
              النوع: string | null

              رقم هاتف الكيان التجاري

            • place_id
              النوع: string | null

              معرّف مكان فريد
              معرّف المكان للمنشأة المحلية المضمّنة في العنصر
              تعرّف على المزيد حول المعرّف في مقالة مركز المساعدة هذه

            • place_topics
              النوع: object | null

              الكلمات المفتاحية المذكورة في مراجعات العملاء
              تحتوي على الكلمات المفتاحية الأكثر شيوعًا المرتبطة بالمنتجات/الخدمات المذكورة في مراجعات العملاء لكيان تجاري وعدد المراجعات التي تذكر كل كلمة مفتاحية
              مثال:
              "place_topics": {
              "egg roll": 48,
              "birthday": 33
              }

              • propertyName
                النوع: integer | null التنسيق: int64

                Signed 64-bit integers (long type).

            • popular_times
              النوع: object | null · Response36Afe1097B20_PopularTimes

              الأوقات الشائعة
              معلومات متعلقة بساعات ازدحام الكيان التجاري

              • popular_times_by_days
                النوع: object | null

                ساعات الذروة
                معلومات عن ساعات الازدحام في المنشأة المحلية في كل يوم من أيام الأسبوع

                • propertyName
                  النوع: array (object | null)[] | null

                  ساعات العمل أيام الأحد

                  • popular_index
                    النوع: integer | null

                    مؤشر الشعبية مؤشر شعبية نسبي مرتبط بالوقت يُقاس من 0 إلى 100؛ تعني القيمة الأعلى وقتًا أكثر ازدحامًا في اليوم

                  • time
                    النوع: object | null · Response36Afe1097B20_TimeInfo

                    الساعات بتنسيق 24 ساعة

                    • hour
                      النوع: integer | null

                      الساعات بتنسيق 24 ساعة

                    • minute
                      النوع: integer | null

                      الدقائق

            • position
              النوع: string | null

              المحاذاة في SERP

            • price_level
              النوع: string | null

              مستوى سعر المنشأة
              يمكن أن يأخذ القيم: inexpensive، moderate، expensive، very_expensive
              إذا لم تتوفر معلومات عن مستوى السعر، ستكون القيمة null

            • questions_and_answers_count
              النوع: integer | null

              Integer numbers.

            • rank_absolute
              النوع: integer | null

              الترتيب المطلق بين جميع العناصر

            • rank_group
              النوع: integer | null

              الموضع ضمن مجموعة عناصر لها قيم type متطابقة
              تُستبعد مواضع العناصر ذات قيم type المختلفة من rank_group

            • rating
              النوع: object | null · Response36Afe1097B20_RatingInfo

              تقييم العنصر
              معدّل الشعبية المستند إلى المراجعات والمعروض في SERP

              • rating_max
                النوع: integer | null

                الحد الأقصى لقيمة rating_type

              • rating_type
                النوع: string | null

                نوع التقييم هنا يمكنك العثور على العناصر التالية: Max5، Percents، CustomMax

              • value
                النوع: number | null التنسيق: double

                قيمة التقييم

              • votes_count
                النوع: integer | null التنسيق: int64

                مقدار الملاحظات

            • rating_distribution
              النوع: object | null

              توزيع تقييمات الكيان التجاري
              يعرض الكائن عدد التقييمات من نجمة واحدة إلى 5 نجوم، بحسب تقييمات المستخدمين

              • propertyName
                النوع: integer | null التنسيق: Int64
            • 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_price
                  النوع: string | null

                  سلسلة السعر في النتيجة سلسلة السعر الخام كما وردت في النتيجة

                • is_price_range
                  النوع: boolean | null

                  يُقدَّم السعر كنطاق تشير إلى ما إذا كان السعر مقدَّمًا كنطاق

                • max_value
                  النوع: number | null التنسيق: double

                  الحد الأقصى للسعر الحد الأقصى لسعر المنتج أو الخدمة كما هو مبيَّن في النتيجة

                • regular
                  النوع: number | null التنسيق: double

                  السعر العادي يشير إلى السعر العادي للمنتج أو الخدمة دون تطبيق أي خصومات

              • snippet
                النوع: string | null

                معلومات إضافية عن الكيان التجاري

              • title
                النوع: string | null

                عنوان العنصر في SERP
                اسم الكيان التجاري الذي تُجمع نتائجه

            • snippet
              النوع: string | null

              معلومات إضافية عن الكيان التجاري

            • title
              النوع: string | null

              عنوان العنصر في SERP
              اسم الكيان التجاري الذي تُجمع نتائجه

            • total_photos
              النوع: integer | null التنسيق: int64

              العدد الإجمالي للصور المضمّنة في ملف Google My Business

            • type
              النوع: string | null

              نوع العنصر

            • url
              النوع: string | null

              عنوان URL المطلق للكيان التجاري

            • work_time
              النوع: object | null · Response36Afe1097B20_BusinessWorkHoursInfo

              تفاصيل ساعات العمل
              معلومات متعلقة بساعات عمل الكيان التجاري

              • work_hours
                النوع: object | null · Response36Afe1097B20_WorkHours

                ساعات العمل
                معلومات عن ساعات عمل المنشأة المحلية

                • current_status
                  النوع: string | null

                  الحالة الحالية للمنشأة
                  يشير إلى ما إذا كانت المنشأة مفتوحة أم مغلقة

                • timetable
                  النوع: object | null

                  الجدول الزمني لساعات العمل

                  • propertyName
                    النوع: array (object | null)[] | null

                    ساعات العمل أيام الأحد

                    • 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_count
            النوع: integer | null التنسيق: int64

            أنواع العناصر
            عدد العناصر في مصفوفة items

          • keyword
            النوع: string | null

            الكلمة المفتاحية المستلمة في مصفوفة POST
            تُعاد الكلمة المفتاحية مع فك ترميز %## (سيُفكّ ترميز المحرف '+' إلى مسافة)
            سيحتوي هذا الحقل على المعامل cid إذا حددته في حقل keyword عند تعيين مهمة؛
            مثال:
            cid:2946633002421908862
            لمعرفة المزيد حول المعامل، راجع مقالة مركز المساعدة هذه

          • language_code
            النوع: string | null

            رمز اللغة في مصفوفة POST

          • location_code
            النوع: integer | null

            رمز الموقع في مصفوفة POST

          • se_domain
            النوع: string | null

            نطاق محرك البحث كما هو محدد في مصفوفة POST

        • result_count
          النوع: integer | null التنسيق: int64

          عدد العناصر في مصفوفة result

        • status_code
          النوع: integer | null

          رمز حالة المهمة ينشئه DataForSEO ويمكن أن يقع ضمن النطاق التالي: 10000-60000 يمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا

        • status_message
          النوع: string | null

          الرسالة المعلوماتية للمهمة يمكنك العثور على القائمة الكاملة للرسائل المعلوماتية العامة هنا

        • time
          النوع: string | null

          وقت التنفيذ، بالثواني

    • tasks_count
      النوع: integer | null التنسيق: int64

      عدد المهام في مصفوفة tasks

    • tasks_error
      النوع: integer | null التنسيق: int64

      عدد المهام في مصفوفة tasks التي أُعيدت مع خطأ

    • time
      النوع: string | null

      إجمالي وقت التنفيذ، بالثواني

    • version
      النوع: string | null

      الإصدار الحالي من API

    application/json
  • 400

    تعذّرت معالجة الطلب. تحقق من معاملات الطلب.

  • 401

    مطلوب مفتاح API صالح من Felo.

  • 402

    لا يمكن متابعة الطلب لأن أحد متطلبات الفوترة غير مستوفٍ.

  • 403

    الحساب غير مصرّح له بهذه العملية.

  • 429

    تم بلوغ حد الطلبات أو حد الإنفاق.

  • 502

    تعذّر على الخدمة إكمال الطلب.

  • 503

    خدمة API أو الفوترة غير متاحة مؤقتًا.

  • 504

    انتهت مهلة الخدمة أثناء معالجة الطلب.

  • default

    استجابة خطأ؛ قد تستخدم استجابات المنبع الممرَّرة تنسيقات المزوّد

    application/json
Request Example for post/v1/beta/dataforseo/business_data/google/my_business_info/live
curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/my_business_info/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_name": "New York,New York,United States",
    "keyword": "RustyBrick, Inc."
  }
]'

{
  "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]"
              ]
            }
          ]
        }
      ]
    }
  ]
}

عملية ناجحة

Setting Live Google My Business Info Tasks