# إعداد مهام مراجعات تطبيق Google

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/app_data/google/app_reviews/task_post`

**Tags:** DataForSEO

يضع مراجعات تطبيق واحد في Google Play حسب `app_id` في قائمة الانتظار، ويعيد معرّف مهمة `id`. يحدّد `depth` عدد المراجعات المجموعة. غير متزامن: يعيد الإرسال معرّف مهمة `id` في `tasks[0].id`، وتعيد أداة الجلب النتيجة فور جاهزيتها. استرجع النتيجة عبر `get_dataforseo_app_google_app_reviews_fetch`.

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

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

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

## Related links

- [الأسعار](<https://dataforseo.com/pricing/api/google-play>)
- [الأسعار](<https://dataforseo.com/pricing/app-data/google-play>)

## 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": {
          "app_id": {
            "type": "string",
            "description": "<em>معرّف التطبيق</em><br><strong>حقل مطلوب</strong><br>معرّف تطبيق الجوال على Google Play؛<br>يمكنك العثور على المعرّف في عنوان URL لكل تطبيق مدرج في Google Play؛<br>مثال:<br><code>https://play.google.com/store/apps/details?id=<strong>org.telegram.messenger</strong></code>"
          },
          "location_name": {
            "type": "string",
            "description": "<em>الاسم الكامل لموقع محرك البحث</em><br><strong>حقل مطلوب إذا لم تحدد <code>location_code</code></strong><br><strong>إذا استخدمت هذا الحقل، فلست بحاجة إلى تحديد <code>location_code</code></strong><br>يمكنك الحصول على قائمة المواقع المتاحة لمحرك البحث مع <code>location_name</code> عبر طلب منفصل إلى <code>https://api.dataforseo.com/v3/app_data/google/locations</code><br>مثال:<br><code class=\"long-string\">West Los Angeles,California,United States</code>"
          },
          "location_code": {
            "type": "integer",
            "description": "<em>رمز موقع محرك البحث</em><br><strong>حقل مطلوب إذا لم تحدد <code>location_name</code></strong><br><strong>إذا استخدمت هذا الحقل، فلست بحاجة إلى تحديد <code>location_name</code></strong><br>يمكنك الحصول على قائمة المواقع المتاحة لمحرك البحث مع <code>location_code</code> الخاصة بها عبر طلب منفصل إلى <code>https://api.dataforseo.com/v3/app_data/google/locations</code><br>مثال:<br><code class=\"long-string\">9061121</code>"
          },
          "language_name": {
            "type": "string",
            "description": "<em>الاسم الكامل للغة محرك البحث</em><br><strong>حقل مطلوب إذا لم تحدد <code>language_code</code></strong><br>إذا استخدمت هذا الحقل، فلست بحاجة إلى تحديد <code>language_code</code><br>يمكنك الحصول على قائمة اللغات المتاحة مع <code>language_name</code> عبر طلب منفصل إلى <code>https://api.dataforseo.com/v3/app_data/google/languages</code><br>مثال:<br><code class=\"long-string\">English</code>"
          },
          "language_code": {
            "type": "string",
            "description": "<em>رمز لغة محرك البحث</em><br><strong>حقل مطلوب إذا لم تحدد <code>language_name</code></strong><br>إذا استخدمت هذا الحقل، فلست بحاجة إلى تحديد <code>language_name</code><br>يمكنك الحصول على قائمة اللغات المتاحة مع <code>language_code</code> الخاصة بها عبر طلب منفصل إلى <code>https://api.dataforseo.com/v3/app_data/google/languages</code><em><br></em>مثال:<em><br></em><code class=\"long-string\">en</code>"
          },
          "priority": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>أولوية المهمة</em><br>حقل اختياري<br>يمكن أن تأخذ القيم التالية:<br>1 – أولوية تنفيذ عادية (تُعيّن افتراضيًا)<br>2 – أولوية تنفيذ عالية. ستُحتسب عليك رسوم إضافية للمهام ذات أولوية التنفيذ العالية.<br>يمكن حساب التكلفة في صفحة الأسعار."
          },
          "depth": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>عمق التحليل</em><br>حقل اختياري<br>عدد المراجعات التي ستُعاد في استجابة API؛<br>نوصي بشدة بتعيين عمق التحليل بمضاعفات 150، لأن نظامنا يعالج 150 مراجعة على التوالي؛<br>القيمة الافتراضية: <code>150</code>؛<br>الحد الأقصى: <code>100000</code>؛<br><strong>ستُحتسب رسوم حسابك لكل SERP يحتوي على ما يصل إلى 150 نتيجة؛</strong> <br>قد يؤدي تعيين عمق أكبر من 150 إلى رسوم إضافية إذا أعاد محرك البحث أكثر من 150 نتيجة</a>؛<br>يمكن حساب التكلفة في صفحة الأسعار."
          },
          "rating": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>تصفية المراجعات حسب التقييم</em><br>حقل اختياري<br>يمكنك استخدام هذا الحقل لتصفية النتائج؛<br>أنواع التصفية الممكنة:<br><code>5</code> — إعادة المراجعات ذات تقييم خمس نجوم فقط؛<br><code>4</code> — إعادة المراجعات ذات تقييم أربع نجوم فقط؛<br><code>3</code> — إعادة المراجعات ذات تقييم ثلاث نجوم فقط؛<br><code>2</code> — إعادة المراجعات ذات تقييم نجمتين فقط؛<br><code>1</code> — إعادة المراجعات ذات تقييم نجمة واحدة فقط؛<br>افتراضيًا، يعيد API جميع المراجعات بغض النظر عن عدد النجوم"
          },
          "sort_by": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>معاملات فرز النتائج</em><br>حقل اختياري<br>يمكنك استخدام هذا الحقل لفرز النتائج؛<br>أنواع الفرز الممكنة:<br><code>newest</code> — الفرز حسب أحدث المراجعات؛<br><code>most_relevant</code> — الفرز حسب أكثر المراجعات صلةً؛<br>القاعدة الافتراضية: <code>most_relevant</code>"
          },
          "tag": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>معرّف مهمة يحدده المستخدم</em><br>حقل اختياري<br><em>الحد الأقصى للأحرف هو 255</em><br>يمكنك استخدام هذا المعامل لتمييز المهمة ومطابقتها مع النتيجة<br>ستجد قيمة <code>tag</code> المحددة في كائن <code>data</code> ضمن الاستجابة"
          },
          "postback_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>عنوان URL لإرسال نتائج المهمة</em><br>حقل اختياري<br>بمجرد اكتمال المهمة، سنرسل طلب POST بنتائجها مضغوطة بتنسيق <code>gzip</code> إلى <code>postback_url</code> الذي حددته<br>يمكنك استخدام السلسلة ‘$id’ كمتغير <code>$id</code> و‘$tag’ كمتغير <code>$tag</code> بترميز URL. سنعيّن القيم اللازمة قبل إرسال الطلب.<br>مثال:<br><code>http://your-server.com/postbackscript?id=$id</code><br><code>http://your-server.com/postbackscript?id=$id&amp;tag=$tag</code><br><strong>ملاحظة:</strong> ستُرمّز الأحرف الخاصة في <code>postback_url</code> بترميز URL؛ <br>أي أن الحرف <code>#</code> سيُرمّز إلى <code>%23</code>"
          },
          "postback_data": {
            "type": "string",
            "description": "<em>نوع بيانات postback_url</em><br><strong>حقل مطلوب إذا حددت <code>postback_url</code></strong><br>يطابق نوع البيانات الذي سيُرسل إلى خادمك<br>القيم الممكنة:<br><code>advanced</code>، <code>html</code>"
          },
          "pingback_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>عنوان URL للإشعار عند اكتمال المهمة</em><br>حقل اختياري<br>عند اكتمال المهمة سنشعرك عبر طلب GET يُرسل إلى عنوان URL الذي حددته<br>يمكنك استخدام السلسلة ‘$id’ كمتغير <code>$id</code> و‘$tag’ كمتغير <code>$tag</code> بترميز URL. سنعيّن القيم اللازمة قبل إرسال الطلب.<br>مثال:<br><code>http://your-server.com/pingscript?id=$id</code><br><code>http://your-server.com/pingscript?id=$id&amp;tag=$tag</code><br><strong>ملاحظة:</strong> ستُرمّز الأحرف الخاصة في <code>pingback_url</code> بترميز URL؛ <br>أي أن الحرف <code>#</code> سيُرمّز إلى <code>%23</code>"
          }
        },
        "example": [
          {
            "app_id": "org.telegram.messenger",
            "location_code": 2840,
            "language_code": "en",
            "depth": 150
          }
        ]
      }
    ]
  },
  "example": [
    {
      "app_id": "org.telegram.messenger",
      "location_code": 2840,
      "language_code": "en",
      "depth": 150
    }
  ]
}
```

## Responses

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

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

**application/json**

Schema: object | null

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

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

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

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

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

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

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

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

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

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

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response36Afe1097B20_AppDataGoogleAppReviewsTaskPostResponseInfo

`#/components/schemas/Response36Afe1097B20_AppDataGoogleAppReviewsTaskPostResponseInfo`

```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_AppDataGoogleAppReviewsTaskPostTaskInfo"
              }
            ]
          },
          "description": "<em>مصفوفة المهام</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_AppDataGoogleAppReviewsTaskPostTaskInfo

`#/components/schemas/Response36Afe1097B20_AppDataGoogleAppReviewsTaskPostTaskInfo`

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

### 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"
    }
  }
}
```
