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

إعداد مهام Google Jobs

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

DataForSEO

​

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

DataForSEO العمليات

إعداد مهام Google Jobs

​

يضع قوائم الوظائف التي يعرضها Google لاستعلام على Google في قائمة الانتظار ويعيد id للمهمة في tasks[0].id. الاستجابة مغلّفة في غلاف DataForSEO: البيانات في tasks[0].result، والنتيجة في tasks[0].status_code — ولا يزال الطلب المرفوض يعيد HTTP 200. النظير المباشر يجيب فورًا وهو أبسط لاستعلام واحد؛ استخدم قائمة الانتظار عندما تتجاوز الدفعة مدة استدعاء أداة.

مرجع التسعير

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

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

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

      عمق التحليل

      حقل اختياري

      عدد النتائج في SERP؛

      القيمة الافتراضية: 10

      الحد الأقصى: 200


      ستُحتسب رسوم حسابك لكل SERP يحتوي على ما يصل إلى 10 نتائج؛

      قد يؤدي تعيين عمق أكبر من 10 إلى رسوم إضافية إذا أعاد محرك البحث أكثر من 10 نتائج؛

      إذا كان العمق المحدد أعلى من عدد النتائج في الاستجابة، فسيُرد الفارق تلقائيًا إلى رصيد حسابك؛

      يمكن حساب التكلفة في صفحة الأسعار.

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

      نوع عقد العمل

      حقل اختياري

      نوع عقد العمل الذي ستُعاد نتائج البحث من أجله؛

      القيم الممكنة:

      fulltime، partime، contractor، intern

    • keyword
      النوع: string

      الكلمة المفتاحية

      حقل مطلوب

      يمكنك تحديد حتى 700 حرف في الحقل keyword

      سيُفك ترميز كل %## (وسيُفك ترميز الحرف «+» إلى مسافة)

      إذا كنت بحاجة إلى استخدام الحرف «%» في keyword، فحدده بالشكل «%25»؛

      إذا كنت بحاجة إلى استخدام الحرف «+» في keyword، فحدده بالشكل «%2B»؛

      ملاحظة: يجب أن تشير الكلمة المفتاحية التي تحددها إلى المسمى الوظيفي؛

      مثال: .net developer


      تعرّف على المزيد حول قواعد وقيود الحقلين keyword وkeywords في DataForSEO APIs في مقال مركز المساعدة

    • language_code
      النوع: string

      رمز لغة محرك البحث

      حقل مطلوب إذا لم تحدد language_name

      إذا استخدمت هذا الحقل، فلا حاجة لتحديد language_name؛

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

      مثال:

      en

    • language_name
      النوع: string

      الاسم الكامل للغة محرك البحث

      حقل مطلوب إذا لم تحدد language_code

      إذا استخدمت هذا الحقل، فلا حاجة لتحديد language_code؛

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

      مثال:

      English

    • location_code
      النوع: integer

      رمز موقع محرك البحث

      حقل مطلوب إذا لم تحدد location_name؛

      يمكنك الحصول على قائمة مواقع محركات البحث المتاحة مع location_code الخاص بها عبر إرسال طلب منفصل إلى https://api.dataforseo.com/v3/serp/google/jobs/locations

      مثال:

      2840

    • location_name
      النوع: string

      الاسم الكامل لموقع محرك البحث

      حقل مطلوب إذا لم تحدد location_code

      إذا استخدمت هذا الحقل، فلا حاجة لتحديد location_code؛

      يمكنك الحصول على قائمة مواقع محرك البحث المتاحة مع location_name الخاص بها عبر إرسال طلب منفصل إلى https://api.dataforseo.com/v3/serp/google/jobs/locations

      مثال:

      London,England,United Kingdom

    • location_radius
      النوع: string | null

      نطاق البحث عن الموقع

      حقل اختياري

      نطاق البحث عن الموقع بالكيلومترات؛

      ملاحظة: بالنسبة للبلدان التي تستخدم النظام الإمبراطوري للوحدات، ستحتاج إلى تحويل الأميال إلى كيلومترات بضرب القيمة بالأميال في 1.609؛

      إذا لم تُحدد قيمة، يُنفَّذ البحث في أي مكان ضمن الموقع المحدد؛

      القيمة القصوى: 300

      القيمة الدنيا: > 0

    • pingback_url
      النوع: string | null

      عنوان URL لإشعار اكتمال المهمة

      حقل اختياري

      عند اكتمال المهمة، سنُشعرك عبر طلب GET يُرسل إلى عنوان URL الذي حددته

      يمكنك استخدام السلسلة ‘$id’ كمتغيّر $id و‘$tag’ كمتغيّر $tag بترميز urlencoded. سنضبط القيم اللازمة قبل إرسال الطلب.

      مثال:

      http://your-server.com/pingscript?id=$id

      http://your-server.com/pingscript?id=$id&tag=$tag

      ملاحظة: تُرمَّز الأحرف الخاصة في pingback_url بترميز urlencoded؛

      منها أن الحرف # يُرمَّز إلى %23


      تعرّف على المزيد في مركز المساعدة

    • postback_data
      النوع: string

      نوع بيانات postback_url

      حقل مطلوب إذا حددت postback_url

      يطابق نوع البيانات الذي سيُرسل إلى خادمك

      القيم الممكنة:

      regular، advanced، html

    • postback_url
      النوع: string | null

      عنوان URL لإرسال نتائج المهمة

      حقل اختياري

      بعد اكتمال المهمة، سنرسل طلب POST بنتائجها مضغوطة بصيغة gzip إلى postback_url الذي حددته

      يمكنك استخدام السلسلة ‘$id’ كمتغيّر $id و‘$tag’ كمتغيّر $tag بترميز urlencoded. سنضبط القيم اللازمة قبل إرسال الطلب

      مثال:

      http://your-server.com/postbackscript?id=$id

      http://your-server.com/postbackscript?id=$id&tag=$tag

      ملاحظة: تُرمَّز الأحرف الخاصة في postback_url بترميز urlencoded;

      منها أن الحرف # يُرمَّز إلى %23


      تعرّف على المزيد في مركز المساعدة

    • priority
      النوع: integer | null

      أولوية المهمة

      حقل اختياري

      يمكن أن تأخذ القيم التالية:

      1 – أولوية التنفيذ العادية (تُعيّن افتراضيًا)؛

      2 – أولوية التنفيذ العالية


      ستُفرض عليك رسوم إضافية على المهام ذات أولوية التنفيذ العالية؛

      يمكن حساب التكلفة في صفحة الأسعار

    • tag
      النوع: string | null

      معرّف مهمة يعرّفه المستخدم

      حقل اختياري

      حد الأحرف 255

      يمكنك استخدام هذا المعامل لتعريف المهمة ومطابقتها مع النتيجة

      ستجد قيمة tag المحددة في كائن data في الاستجابة

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

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

    • status_code
      النوع: integer | null

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

    • status_message
      النوع: string | null

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

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

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

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

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

        • data
          النوع: object | null

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

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

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

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

          مسار URL

        • result
          النوع: object | null

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

        • 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/serp/google/jobs/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/jobs/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": ".net developer"
  },
  {
    "language_name": "English",
    "location_name": "United States",
    "keyword": ".net developer",
    "tag": "some_string_123",
    "pingback_url": "https://your-server.com/pingscript?id=$id&tag=$tag"
  }
]'

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

عملية ناجحة

Setting Google Jobs Tasks