# إعداد مهام Google Finance Explore SERP

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/serp/google/finance_explore/task_post`

**Tags:** DataForSEO

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

### مرجع التسعير

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

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

## Related links

- [مركز المساعدة](<https://dataforseo.com/help-center/pingbacks-postbacks-with-dataforseo-api>)
- [الأسعار](<https://dataforseo.com/pricing/serp/google-finance-serp-api>)

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Request body

Required: **no**

### application/json

Schema:

```json
{
  "type": "array",
  "items": {
    "type": [
      "object",
      "null"
    ],
    "oneOf": [
      {
        "type": "object",
        "properties": {
          "location_code": {
            "type": "integer",
            "description": "<p><em>رمز موقع محرك البحث</em><p><strong>حقل مطلوب إذا لم تحدد <code>location_name</code></strong><p><strong>إذا استخدمت هذا الحقل، فلا حاجة لتحديد <code>location_name</code></strong><p>يمكنك الحصول على قائمة مواقع محركات البحث المتاحة مع <code>location_code</code> الخاص بها عبر إرسال طلب منفصل إلى <code>https://api.dataforseo.com/v3/serp/google/locations</code><p>مثال:<p><code class=\"long-string\">2840</code></p>"
          },
          "language_code": {
            "type": "string",
            "description": "<p><em>رمز لغة محرك البحث</em><p><strong>حقل مطلوب إذا لم تحدد <code>language_name</code></strong><p><strong>إذا استخدمت هذا الحقل، فلا حاجة لتحديد <code>language_name</code></strong><p>يمكنك الحصول على قائمة لغات محرك البحث المتاحة مع <code>language_code</code>&nbsp;الخاص بها عبر إرسال طلب منفصل إلى <code>https://api.dataforseo.com/v3/serp/google/languages</code><em><p></em>مثال:<em><p></em><code class=\"long-string\">en</code></p>"
          },
          "device": {
            "type": [
              "string",
              "null"
            ],
            "description": "<p><em>نوع الجهاز</em><p>حقل اختياري<p>إعادة النتائج لنوع جهاز محدد<p>القيمة الممكنة: <code>desktop</code></p>"
          },
          "pingback_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "<p><em>عنوان URL لإشعار اكتمال المهمة</em><p>حقل اختياري<p>عند اكتمال المهمة، سنُشعرك عبر طلب GET يُرسل إلى عنوان URL الذي حددته<p>يمكنك استخدام السلسلة ‘$id’ كمتغيّر <code>$id</code> و‘$tag’ كمتغيّر <code>$tag</code> بترميز urlencoded. سنضبط القيم اللازمة قبل إرسال الطلب.<p>مثال:<p><code>http://your-server.com/pingscript?id=$id</code><p><code>http://your-server.com/pingscript?id=$id&amp;tag=$tag</code><p><strong>ملاحظة:</strong> تُرمَّز الأحرف الخاصة في <code>pingback_url</code> بترميز urlencoded؛<p>منها أن الحرف <code>#</code> يُرمَّز إلى <code>%23</code></p><br><p>تعرّف على المزيد في مركز المساعدة</p>"
          },
          "postback_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "<p><em>عنوان URL لإرسال نتائج المهمة</em><p>حقل اختياري<p>بعد اكتمال المهمة، سنرسل طلب POST بنتائجها مضغوطة بصيغة <code>gzip</code> إلى <code>postback_url</code> الذي حددته<p>يمكنك استخدام السلسلة ‘$id’ كمتغيّر <code>$id</code> و‘$tag’ كمتغيّر <code>$tag</code> بترميز urlencoded. سنضبط القيم اللازمة قبل إرسال الطلب<p>مثال:<p><code>http://your-server.com/postbackscript?id=$id</code><p><code>http://your-server.com/postbackscript?id=$id&amp;tag=$tag</code><p><strong>ملاحظة:</strong> تُرمَّز الأحرف الخاصة في <code>postback_url</code> بترميز urlencoded;<p>منها أن الحرف <code>#</code> يُرمَّز إلى <code>%23</code></p><br><p>تعرّف على المزيد في مركز المساعدة</p>"
          },
          "postback_data": {
            "type": "string",
            "description": "<p><em>نوع بيانات postback_url</em><p><strong>حقل مطلوب إذا حددت <code>postback_url</code></strong><p>يطابق نوع البيانات الذي سيُرسل إلى خادمك<p>القيم الممكنة:: <code>advanced</code>، <code>html</code></p>"
          },
          "priority": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<p><em>أولوية المهمة</em><p>حقل اختياري<p>يمكن أن تأخذ القيم التالية:<p>1 – أولوية التنفيذ العادية (تُعيّن افتراضيًا)؛<p>2 – أولوية التنفيذ العالية</p><br>ستُفرض عليك رسوم إضافية على المهام ذات أولوية التنفيذ العالية؛<p>يمكن حساب التكلفة في صفحة الأسعار"
          },
          "location_name": {
            "type": "string",
            "description": "<p><em>الاسم الكامل لموقع محرك البحث</em><p><strong>حقل مطلوب إذا لم تحدد <code>location_code</code></strong><p><strong>إذا استخدمت هذا الحقل، فلا حاجة لتحديد <code>location_code</code></strong><p>يمكنك الحصول على قائمة مواقع محرك البحث المتاحة مع <code>location_name</code> الخاص بها عبر إرسال طلب منفصل إلى  <code>https://api.dataforseo.com/v3/serp/google/locations</code><p>مثال:<p><code class=\"long-string\">London,England,United Kingdom</code></p>"
          },
          "language_name": {
            "type": "string",
            "description": "<p><em>الاسم الكامل للغة محرك البحث</em><p><strong>حقل مطلوب إذا لم تحدد <code>language_code</code> </strong><p><strong>إذا استخدمت هذا الحقل، فلا حاجة لتحديد <code>language_code</code></strong><p>يمكنك الحصول على قائمة لغات محرك البحث المتاحة مع <code>language_name</code> الخاص بها عبر إرسال طلب منفصل إلى <code>https://api.dataforseo.com/v3/serp/google/languages</code><p>مثال:<p><code class=\"long-string\">English</code></p>"
          },
          "os": {
            "type": [
              "string",
              "null"
            ],
            "description": "<p><em>نظام تشغيل الجهاز</em><p>حقل اختياري<p>القيم الممكنة: <code>windows</code></p>"
          },
          "tag": {
            "type": [
              "string",
              "null"
            ],
            "description": "<p><em>معرّف مهمة يعرّفه المستخدم</em><p>حقل اختياري<p><em>حد الأحرف 255</em><p>يمكنك استخدام هذا المعامل لتعريف المهمة ومطابقتها مع النتيجة<p>ستجد قيمة <code>tag</code> المحددة في كائن <code>data</code> في الاستجابة</p>"
          },
          "news_type": {
            "type": [
              "string",
              "null"
            ],
            "description": "<p><em>مرشّحات الأخبار المالية</em><p>حقل اختياري<p>القيم الممكنة: <code>top_stories</code>، <code>local_market</code>، <code>world_markets</code><p>القيمة الافتراضية: <code>top_stories</code><p><strong>ملاحظة:</strong> إذا حددت <code>local_market</code> أو <code>world_markets</code>، فستُضاعف رسوم كل مهمة بمقدار 2</p>"
          }
        },
        "example": [
          {
            "location_code": 2840,
            "language_name": "English"
          }
        ]
      }
    ]
  },
  "example": [
    {
      "location_code": 2840,
      "language_name": "English"
    }
  ]
}
```

## Responses

### 200 — عملية ناجحة

Headers:
- `X-Request-Id` (string) — معرّف الطلب المراد تضمينه عند التواصل مع دعم Felo.

**application/json**

Schema: object | null

```json
{
  "type": [
    "object",
    "null"
  ],
  "oneOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_SerpGoogleFinanceExploreTaskPostResponseInfo"
    }
  ]
}
```

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

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

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

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

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

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

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

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

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

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response36Afe1097B20_BaseResponseInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseInfo`

```json
{
  "properties": {
    "version": {
      "type": [
        "string",
        "null"
      ],
      "description": "الإصدار الحالي من API"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "رمز الحالة العام\nيمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "رسالة معلوماتية عامة\nيمكنك العثور على القائمة الكاملة للرسائل المعلوماتية العامة هنا"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "إجمالي وقت التنفيذ، بالثواني"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "إجمالي تكلفة المهام، بالدولار الأمريكي",
      "format": "double"
    },
    "tasks_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "عدد المهام في مصفوفة tasks",
      "format": "int64"
    },
    "tasks_error": {
      "type": [
        "integer",
        "null"
      ],
      "description": "عدد المهام في مصفوفة tasks التي أُعيدت مع خطأ",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_BaseResponseTaskInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo`

```json
{
  "properties": {
    "id": {
      "type": [
        "string",
        "null"
      ],
      "description": "معرّف المهمة\nمعرّف مهمة فريد في نظامنا بصيغة UUID"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "رمز حالة المهمة\nينشئه DataForSEO ويمكن أن يقع ضمن النطاق التالي: 10000-60000\nيمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "الرسالة المعلوماتية للمهمة\nيمكنك العثور على القائمة الكاملة للرسائل المعلوماتية العامة هنا"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "وقت التنفيذ، بالثواني"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "إجمالي تكلفة المهام، بالدولار الأمريكي",
      "format": "double"
    },
    "result_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "عدد العناصر في مصفوفة result",
      "format": "int64"
    },
    "path": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "مسار URL"
    },
    "data": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "object",
          "null"
        ]
      },
      "description": "يحتوي على المعاملات نفسها التي حددتها في طلب POST"
    }
  }
}
```

### Response36Afe1097B20_SerpGoogleFinanceExploreTaskPostResponseInfo

`#/components/schemas/Response36Afe1097B20_SerpGoogleFinanceExploreTaskPostResponseInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseInfo"
    },
    {
      "type": "object",
      "properties": {
        "tasks": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": [
              "object",
              "null"
            ],
            "oneOf": [
              {
                "$ref": "#/components/schemas/Response36Afe1097B20_SerpGoogleFinanceExploreTaskPostTaskInfo"
              }
            ]
          },
          "description": "<em>مصفوفة المهام</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_SerpGoogleFinanceExploreTaskPostTaskInfo

`#/components/schemas/Response36Afe1097B20_SerpGoogleFinanceExploreTaskPostTaskInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo"
    },
    {
      "type": "object",
      "properties": {
        "result": {
          "type": [
            "object",
            "null"
          ],
          "description": "<em>مصفوفة نتائج</em><br>في هذه الحالة، ستكون القيمة <code>null</code>"
        }
      }
    }
  ]
}
```
