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

إعداد مهام Google Shopping Reviews

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

DataForSEO

​

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

DataForSEO العمليات

إعداد مهام Google Shopping Reviews

​

يضع في قائمة الانتظار مراجعات منتج Google Shopping واحد، ويعيد معرّف مهمة id. عرّف المنتج بـproduct_id مع gid أو data_docid من نتيجة منتجات. هذه العائلة غير متزامنة بالكامل: يعيد الإرسال معرّف مهمة id في tasks[0].id، وتعيد أداة الجلب النتيجة فور جاهزيتها. استرجعها عبر get_dataforseo_merchant_google_reviews_fetch.

مرجع التسعير

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

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

الجسم
مطلوب
application/json
  • النوع: array object[]
    • النوع: object
      • gid
        النوع: string
        مطلوب

        معرّف المنتج العالمي على Google Shopping حقل مطلوب نوصي بتحديد gid مع data_docid وproduct_id للحصول على أفضل النتائج؛ يمكنك الحصول على هذه القيمة لمنتج معين عبر إرسال طلب منفصل إلى نقطة نهاية منتجات Google Shopping مثال: 4702526954592161872 تعرّف على المزيد حول المعامل في دليل مركز المساعدة هذا

      • data_docid
        النوع: string

        المعرّف الفريد لعنصر بيانات SERP حقل اختياري نوصي بتحديد data_docid مع product_id وgid للحصول على أفضل النتائج؛ يمكنك الحصول على هذه القيمة لعنصر معين عبر إرسال طلب منفصل إلى نقطة نهاية منتجات Google Shopping مثال: 13071766526042404278

      • depth
        النوع: integer

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

      • language_code
        النوع: string

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

      • language_name
        النوع: string

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

      • location_code
        النوع: integer

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

      • location_coordinate
        النوع: string

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

      • location_name
        النوع: string

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

      • pingback_url
        النوع: string

        عنوان URL لإشعارات المهمة المكتملة حقل اختياري عند اكتمال المهمة سنُعلمك عبر طلب GET يُرسل إلى عنوان URL الذي حددته يمكنك استخدام السلسلة ‘$id’ كمتغيّر $id و‘$tag’ كمتغيّر $tag بترميز URL. سنعيّن القيم اللازمة قبل إرسال الطلب. مثال: http://your-server.com/pingscript?id=$id http://your-server.com/pingscript?id=$id&tag=$tag ملاحظة: ستُرمّز الأحرف الخاصة في pingback_url بترميز URL؛ على سبيل المثال، سيُرمّز الحرف # إلى %23 اعرف المزيد في مركز المساعدة لدينا

      • postback_data
        النوع: string

        نوع بيانات postback_url حقل اختياري يقابل نوع البيانات الذي سيُرسل إلى خادمك القيم الممكنة: advanced

      • postback_url
        النوع: string

        عنوان URL لإرسال نتائج المهمة حقل اختياري بمجرد اكتمال المهمة، سنرسل طلب POST بنتائجها مضغوطة بصيغة gzip إلى postback_url الذي حددته يمكنك استخدام السلسلة ‘$id’ كمتغيّر $id و‘$tag’ كمتغيّر $tag بترميز URL. سنعيّن القيم اللازمة قبل إرسال الطلب. مثال: http://your-server.com/postbackscript?id=$id http://your-server.com/postbackscript?id=$id&tag=$tag ملاحظة: ستُرمّز الأحرف الخاصة في postback_url بترميز URL؛ على سبيل المثال، سيُرمّز الحرف # إلى %23 اعرف المزيد في مركز المساعدة لدينا

      • priority
        النوع: integer

        أولوية المهمة حقل اختياري يمكن أن تأخذ القيم التالية: 1 – أولوية التنفيذ العادية (تُعيّن افتراضيًا) 2 – أولوية التنفيذ العالية ستُفرض عليك رسوم إضافية على المهام ذات أولوية التنفيذ العالية. يمكن حساب التكلفة في صفحة الأسعار.

      • product_id
        النوع: string

        معرّف منتج فريد على Google Shopping حقل اختياري نوصي بتحديد product_id مع data_docid وgid للحصول على أفضل النتائج؛ يمكنك الحصول على هذه القيمة لمنتج معيّن عبر إرسال طلب منفصل إلى نقطة النهاية Google Shopping Products مثال: 4485466949985702538 اعرف المزيد عن هذا المعامل في دليل مركز المساعدة هذا

      • se_domain
        النوع: string

        نطاق محرك البحث حقل اختياري نختار نطاق محرك البحث المناسب تلقائيًا وفقًا للموقع واللغة التي تحددها مع ذلك، يمكنك تعيين نطاق محرك بحث مخصص في هذا الحقل مثال: google.co.uk، google.com.au، google.de، إلخ.

      • tag
        النوع: string

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

      كائن فارغ
      كائن فارغ
الاستجابات
  • 200
    النوع: object

    استجابة ناجحة

    • cost
      النوع: number

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

    • status_code
      النوع: integer

      رمز الحالة العام يمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا ملاحظة: نوصي بشدة بتصميم نظام لازم لمعالجة الحالات الاستثنائية أو حالات الخطأ ذات الصلة

    • status_message
      النوع: string

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

    • tasks
      النوع: array string[]

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

    • tasks_count
      النوع: integer

      عدد المهام في tasksarray

    • tasks_error
      النوع: integer

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

    • tasks.cost
      النوع: number

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

    • tasks.data
      النوع: object

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

    • tasks.id
      النوع: string

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

    • tasks.path
      النوع: array string[]

      مسار URL

    • tasks.result
      النوع: array string[]

      مصفوفة النتائج. في هذه الحالة، ستكون القيمة null

    • tasks.result_count
      النوع: integer

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

    • tasks.status_code
      النوع: integer

      رمز حالة المهمة الذي ينشئه DataForSEO؛ يمكن أن يقع ضمن النطاق التالي: 10000-60000

    • tasks.status_message
      النوع: string

      رسالة معلوماتية عن المهمة

    • tasks.time
      النوع: string

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

    • time
      النوع: string

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

    • version
      النوع: string

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

    application/json
  • 400

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

  • 401

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

  • 402

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

  • 403

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

  • 429

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

  • 502

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

  • 503

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

  • 504

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

  • default

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

    application/json
Request Example for post/v1/beta/dataforseo/merchant/google/reviews/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/merchant/google/reviews/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {},
  {}
]'

{
  "version": "string",
  "status_code": 1,
  "status_message": "string",
  "time": "string",
  "cost": 1,
  "tasks_count": 1,
  "tasks_error": 1,
  "tasks": [
    "string"
  ],
  "tasks.id": "string",
  "tasks.status_code": 1,
  "tasks.status_message": "string",
  "tasks.time": "string",
  "tasks.cost": 1,
  "tasks.result_count": 1,
  "tasks.path": [
    "string"
  ],
  "tasks.data": {},
  "tasks.result": [
    "string"
  ]
}

استجابة ناجحة

Setting Google Shopping Reviews Tasks