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

تنظیم وظایف Google Finance Quote 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 Quote 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

    • keyword
      نوع: string

      نماد معاملاتی یا نماد سهام

      فیلد الزامی

      در این فیلد می‌توانید نماد معاملاتی سهام عرضه‌شده به عموم یک سهام یا اوراق بهادار خاص در یک بورس خاص را وارد کنید؛

      می‌توانید تا 700 نویسه در فیلد keyword مشخص کنید؛

      همه %## رمزگشایی می‌شوند (همچنین کاراکتر ‘+’ به فاصله رمزگشایی می‌شود)

      اگر به نویسه “%” در keyword نیاز دارید، آن را به‌صورت “%25” مشخص کنید؛

      اگر به نویسه “+” در keyword نیاز دارید، آن را به‌صورت “%2B” مشخص کنید؛


      درباره قواعد و محدودیت‌های فیلدهای keyword و keywords در APIهای DataForSEO در این مقاله مرکز راهنمایی بیشتر بدانید

    • 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

    • 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 پاسخ خواهید یافت

    • window
      نوع: string | null

      بازه زمانی برای نمودار google_finance_quote

      فیلد اختیاری

      مقادیر ممکن: 1D، 5D، 1M، 6M، YTD، 1Y، 5Y، MAX

      مقدار پیش‌فرض: 1D

      نکته: اگر مقداری متفاوت از 1D تعیین کنید، هزینه هر وظیفه در 2 ضرب می‌شود

پاسخ‌ها
  • 200
    نوع: object | null · Response36Afe1097B20_SerpGoogleFinanceQuoteTaskPostResponseInfo
    • cost
      نوع: number | null قالب: double

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

    • status_code
      نوع: integer | null

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

    • status_message
      نوع: string | null

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

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

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

      • نوع: object | null · Response36Afe1097B20_SerpGoogleFinanceQuoteTaskPostTaskInfo
        • 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_quote/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/finance_quote/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keyword": ".DJI:INDEXDJX",
    "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 Quote SERP Tasks