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

الحصول على نتائج تحديثات Google My Business حسب id

الخادم:https://openapi.felo.ai
مكتبات العملاء

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.

مرجع التسعير

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

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

معاملات المسار
  • id
    النوع: string
    مطلوب

    معرّف المهمة
    معرّف مهمة فريد في نظامنا بصيغة UUID
    يمكنك استخدامه خلال 30 يومًا لطلب نتائج المهمة في أي وقت

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

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

    • status_code
      النوع: integer | null

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

    • status_message
      النوع: string | null

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

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

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

      • النوع: object | null · Response36Afe1097B20_BusinessDataGoogleMyBusinessUpdatesTaskGetTaskInfo
        • 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

          مصفوفة نتائج

          • business_updates_id
            النوع: string | null

            معرّف عنصر تحديثات النشاط التجاري في SERP

          • check_url
            النوع: string | null

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

          • cid
            النوع: string | null

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

          • 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_post

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

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

            • author
              النوع: string | null

              كاتب المنشور

            • images_url
              النوع: string | null

              عنوان URL لصورة مضمّنة في المنشور

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

              الروابط المضمّنة في المنشور

              • description
                النوع: string | null

                وصف عنصر النتائج

              • domain
                النوع: string | null

                النطاق الذي يشير إليه الرابط

              • snippet
                النوع: string | null

                النص المحاذي لعنوان الرابط

              • title
                النوع: string | null

                عنوان عنصر رابط معيّن

              • type
                النوع: string | null

                نوع العنصر

              • url
                النوع: string | null

                عنوان URL

              • xpath
                النوع: string | null

                XPath الخاص بالعنصر

            • position
              النوع: string | null

              محاذاة العنصر في SERP
              يمكن أن يأخذ القيم التالية: right

            • post_date
              النوع: string | null

              تاريخ نشر المنشور
              بالتنسيق التالي:
              "mm/dd/yyyy hh:mm:ss"

            • post_text
              النوع: string | null

              المحتوى الرئيسي للمنشور

            • rank_absolute
              النوع: integer | null

              الترتيب المطلق بين جميع التحديثات المدرجة
              الموضع المطلق بين جميع العناصر الموجودة

            • rank_group
              النوع: integer | null

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

            • snippet
              النوع: string | null

              محتوى إضافي للمنشور

            • timestamp
              النوع: string | null

              وقت نشر المنشور
              بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”
              مثال:
              2019-11-15 12:57:46 +00:00

            • type
              النوع: string | null

              نوع العنصر

            • url
              النوع: string | null

              عنوان URL للمنشور

            • xpath
              النوع: string | null

              XPath الخاص بالعنصر

          • 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 get/v1/beta/dataforseo/business_data/google/my_business_updates/task_get/{id}
curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/my_business_updates/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,
          "business_updates_id": null,
          "cid": null,
          "feature_id": null,
          "item_types": [
            null
          ],
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "position": null,
              "xpath": null,
              "author": null,
              "snippet": null,
              "post_text": null,
              "url": null,
              "images_url": null,
              "post_date": null,
              "timestamp": null,
              "links": [
                "[Max Depth Exceeded]"
              ]
            }
          ]
        }
      ]
    }
  ]
}
Get Google My Business Updates Results by id