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، التي تُوجد عبر keyword وlocation_code. يعيد keyword وse_domain وlocation_code وlanguage_code وcheck_url وdatetime وcid وfeature_id وitem_types. الاستجابة مغلّفة في غلاف DataForSEO: البيانات في tasks[0].result، والنتيجة في tasks[0].status_code — ولا يزال الطلب المرفوض يعيد HTTP 200.

مرجع التسعير

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

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

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

      عمق التحليل
      حقل اختياري
      عدد النتائج في SERP
      القيمة الافتراضية: 20
      الحد الأقصى: 100
      ستُحتسب رسوم حسابك لكل SERP يحتوي على ما يصل إلى 20 نتيجة؛
      قد يؤدي تعيين عمق أكبر من 20 إلى رسوم إضافية إذا أعاد محرك البحث أكثر من 20 نتيجة؛
      إذا كان العمق المحدد أعلى من عدد الأسئلة في الاستجابة، فسيُرد الفارق تلقائيًا إلى رصيد حسابك؛
      يمكن حساب التكلفة في صفحة الأسعار.

    • 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_BusinessDataGoogleQuestionsAndAnswersLiveResponseInfo
    • cost
      النوع: number | null التنسيق: double

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

    • status_code
      النوع: integer | null

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

    • status_message
      النوع: string | null

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

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

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

      • النوع: object | null · Response36Afe1097B20_BusinessDataGoogleQuestionsAndAnswersLiveTaskInfo
        • 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 مباشر لنتائج محرك البحث
            يمكنك استخدامه للتأكد من أننا قدّمنا نتائج دقيقة

          • cid
            النوع: string | null

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

          • datetime
            النوع: string | null

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

          • feature_id
            النوع: string | null

            المعرّف الفريد لميزة SERP

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

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

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

            مصفوفة عناصر
            العناصر داخل google_business_question_item

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

              مصفوفة عناصر
              العناصر داخل google_business_question_item

              • answer_id
                النوع: string | null

                معرّف الإجابة

              • answer_text
                النوع: string | null

                النص الحالي للإجابة

              • original_answer_text
                النوع: string | null

                النص الأصلي للإجابة

              • profile_image_url
                النوع: string | null

                عنوان URL لصورة ملف المستخدم الشخصي

              • profile_name
                النوع: string | null

                الاسم المعروض للمستخدم

              • profile_url
                النوع: string | null

                عنوان URL لملف المستخدم الشخصي

              • time_ago
                النوع: string | null

                الوقت المقدّر لنشر الإجابة

              • timestamp
                النوع: string | null

                الوقت الدقيق لنشر الإجابة

              • type
                النوع: string | null

                نوع العنصر

            • original_question_text
              النوع: string | null

              النص الأصلي للسؤال

            • profile_image_url
              النوع: string | null

              عنوان URL لصورة ملف المستخدم الشخصي

            • profile_name
              النوع: string | null

              الاسم المعروض للمستخدم

            • profile_url
              النوع: string | null

              عنوان URL لملف المستخدم الشخصي

            • question_id
              النوع: string | null

              معرّف السؤال

            • question_text
              النوع: string | null

              النص الحالي للسؤال

            • rank_absolute
              النوع: integer | null

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

            • rank_group
              النوع: integer | null

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

            • time_ago
              النوع: string | null

              الوقت التقديري لنشر السؤال

            • timestamp
              النوع: string | null

              الوقت الدقيق لنشر السؤال

            • type
              النوع: string | null

              نوع العنصر

            • url
              النوع: string | null

              عنوان URL للسؤال

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

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

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

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

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

              مصفوفة عناصر
              العناصر داخل google_business_question_item

              • answer_id
                النوع: string | null

                معرّف الإجابة

              • answer_text
                النوع: string | null

                النص الحالي للإجابة

              • original_answer_text
                النوع: string | null

                النص الأصلي للإجابة

              • profile_image_url
                النوع: string | null

                عنوان URL لصورة ملف المستخدم الشخصي

              • profile_name
                النوع: string | null

                الاسم المعروض للمستخدم

              • profile_url
                النوع: string | null

                عنوان URL لملف المستخدم الشخصي

              • time_ago
                النوع: string | null

                الوقت المقدّر لنشر الإجابة

              • timestamp
                النوع: string | null

                الوقت الدقيق لنشر الإجابة

              • type
                النوع: string | null

                نوع العنصر

            • original_question_text
              النوع: string | null

              النص الأصلي للسؤال

            • profile_image_url
              النوع: string | null

              عنوان URL لصورة ملف المستخدم الشخصي

            • profile_name
              النوع: string | null

              الاسم المعروض للمستخدم

            • profile_url
              النوع: string | null

              عنوان URL لملف المستخدم الشخصي

            • question_id
              النوع: string | null

              معرّف السؤال

            • question_text
              النوع: string | null

              النص الحالي للسؤال

            • rank_absolute
              النوع: integer | null

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

            • rank_group
              النوع: integer | null

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

            • time_ago
              النوع: string | null

              الوقت التقديري لنشر السؤال

            • timestamp
              النوع: string | null

              الوقت الدقيق لنشر السؤال

            • type
              النوع: string | null

              نوع العنصر

            • url
              النوع: string | null

              عنوان URL للسؤال

          • 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/questions_and_answers/live
curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/questions_and_answers/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_name": "Los Angeles,California,United States",
    "keyword": "The Last Bookstore"
  }
]'

{
  "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,
          "cid": null,
          "feature_id": null,
          "item_types": [
            null
          ],
          "items_without_answers": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "question_id": null,
              "url": null,
              "profile_image_url": null,
              "profile_url": null,
              "profile_name": null,
              "question_text": null,
              "original_question_text": null,
              "time_ago": null,
              "timestamp": null,
              "items": [
                "[Max Depth Exceeded]"
              ]
            }
          ],
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "question_id": null,
              "url": null,
              "profile_image_url": null,
              "profile_url": null,
              "profile_name": null,
              "question_text": null,
              "original_question_text": null,
              "time_ago": null,
              "timestamp": null,
              "items": [
                "[Max Depth Exceeded]"
              ]
            }
          ]
        }
      ]
    }
  ]
}

عملية ناجحة

Setting Live Google My Business Questions and Answers Tasks