Felo API PlatformFelo API Platform
همه endpointهای DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

تنظیم وظایف Google Finance Markets SERP

Felo API Support
MIT
سرور:https://openapi.felo.ai
کتابخانه‌های کلاینت
Shell Curl

DataForSEO

​

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

DataForSEO عملیات

تنظیم وظایف Google Finance Markets SERP

​

شاخص‌های بازار و نمادهای پرنوسانی را که Google Finance در 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)[]
    • device
      نوع: string | null

      نوع دستگاه

      فیلد اختیاری

      بازگرداندن نتایج برای نوع دستگاه مشخص

      مقدار ممکن: desktop

    • 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_name نیست

      می‌توانید فهرست موقعیت‌های موجود موتورهای جستجو را همراه با location_code آن‌ها با ارسال یک درخواست جداگانه به https://api.dataforseo.com/v3/serp/google/locations دریافت کنید

      مثال:

      2840

    • location_name
      نوع: string

      نام کامل موقعیت موتور جستجو

      فیلد الزامی اگر location_code را تعیین نکنید

      اگر از این فیلد استفاده کنید، نیازی به تعیین location_code نیست

      می‌توانید فهرست موقعیت‌های موجود موتور جستجو را همراه با location_name آن‌ها با ارسال یک درخواست جداگانه به https://api.dataforseo.com/v3/serp/google/locations دریافت کنید

      مثال:

      London,England,United Kingdom

    • market_type
      نوع: string | null

      نوع بازار Google Finance

      فیلد اختیاری

      مقادیر ممکن: most-active، indexes، indexes/americas، indexes/europe-middle-east-africa، indexes/asia-pacific، gainers، losers، climate-leaders، cryptocurrencies، currencies

      مقدار پیش‌فرض: most-active

    • os
      نوع: string | null

      سیستم‌عامل دستگاه

      فیلد اختیاری

      مقادیر ممکن: windows

    • 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 را مشخص کنید

      با نوع داده‌ای مطابقت دارد که به سرور شما ارسال می‌شود

      مقادیر ممکن:: 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_SerpGoogleFinanceMarketsTaskPostResponseInfo
    • cost
      نوع: number | null قالب: double

      هزینه کل وظایف، دلار آمریکا

    • status_code
      نوع: integer | null

      کد وضعیت عمومی فهرست کامل کدهای پاسخ را اینجا پیدا می‌کنید

    • status_message
      نوع: string | null

      پیام اطلاعاتی عمومی فهرست کامل پیام‌های اطلاعاتی عمومی را اینجا پیدا می‌کنید

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

      آرایه‌ای از وظایف

      • نوع: object | null · Response36Afe1097B20_SerpGoogleFinanceMarketsTaskPostTaskInfo
        • 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/finance_markets/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/finance_markets/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_code": 2840,
    "language_name": "English"
  }
]'

{
  "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 Finance Markets SERP Tasks