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

دریافت نتایج Google Extended Reviews بر اساس id

سرور:https://openapi.felo.ai
کتابخانه‌های کلاینت

DataForSEO

​

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

دریافت نتایج Google Extended Reviews بر اساس id

​

تاریخچه کامل نظرات Google یک کسب‌وکار را که در صف قرار گرفته، فراتر از صفحه اولی که نقطه پایانی استاندارد برمی‌گرداند، بر اساس id بازیابی می‌کند. پاسخ در پاکت DataForSEO قرار می‌گیرد: داده‌ها در tasks[0].result و نتیجه در tasks[0].status_code — درخواست ردشده نیز همچنان HTTP 200 برمی‌گرداند. ⚠️ اندازه با depth که هنگام ارسال تعیین می‌شود مقیاس می‌گیرد و هنگام واکشی قابل محدود کردن نیست.

مرجع قیمت‌گذاری

  • اندازه‌گیری: هزینه گزارش‌شده پاسخ.
  • برآورد درخواست مرجع: 0.012 دلار آمریکا.
  • ضریب مشتری مرجع: 1.0. آن را دوباره روی مبلغ تسویه‌شده مشتری اعمال نکنید.

فقط فراداده مرجع است، نه نقل‌قول حساب، نه قیمت تضمین‌شده و نه سقف هزینه. اعتبار منابع، اعتبار Felo نیست. هزینه‌های نهایی تابع سوابق صورت‌حساب Felo است.

پارامترهای مسیر
  • id
    نوع: string
    الزامی

    شناسه وظیفه
    شناسه وظیفه یکتا در سیستم ما با قالب UUID
    می‌توانید تا 30 روز از آن برای درخواست نتایج وظیفه در هر زمان استفاده کنید

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

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

    • status_code
      نوع: integer | null

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

    • status_message
      نوع: string | null

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

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

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

      • نوع: object | null · Response36Afe1097B20_BusinessDataGoogleExtendedReviewsTaskGetTaskInfo
        • cost
          نوع: number | null قالب: double

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

        • data
          نوع: object | null

          همان پارامترهایی را دارد که در درخواست POST تعیین کرده‌اید

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

          شناسه وظیفه شناسه یکتای وظیفه در سیستم ما در قالب UUID

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

          مسیر URL

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

          آرایه‌ای از نتایج

          • check_url
            نوع: string | null

            نشانی URL مستقیم نتایج موتور جستجو
            می‌توانید از آن استفاده کنید تا مطمئن شوید نتایج دقیقی ارائه کرده‌ایم

          • cid
            نوع: string | null

            شناسه مشتری تعریف‌شده توسط Google
            شناسه یکتای یک مؤسسه محلی
            برای آشنایی بیشتر با این شناسه، این مقاله مرکز راهنما را ببینید

          • datetime
            نوع: string | null

            تاریخ و زمانی که نتیجه دریافت شده است
            در قالب UTC: “yyyy-mm-dd hh-mm-ss +00:00”
            مثال:
            2019-11-15 12:57:46 +00:00

          • feature_id
            نوع: string | null

            شناسه یکتای عنصر «reviews» در SERP
            برای آشنایی بیشتر با این شناسه، این مقاله مرکز راهنما را ببینید

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

            نظرات یافت‌شده
            برای دریافت نتایج بیشتر می‌توانید هنگام تنظیم وظیفه از پارامتر depth استفاده کنید

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

              تصاویر ارسال‌شده توسط نویسنده نظر

              • alt
                نوع: string | null

                برچسب alt تصویر

              • image_url
                نوع: string | null

                نشانی URL تصویر
                نشانی URL منتهی به تصویر در منبع اصلی یا فضای ذخیره‌سازی DataForSEO (اگر منبع اصلی در دسترس نباشد)

              • type
                نوع: string | null

                نوع عنصر

              • url
                نوع: string | null

                نشانی URL مرتبط

            • local_guide
              نوع: boolean | null

              نشان می‌دهد آیا نویسنده نظر وضعیت 'راهنمای محلی' دارد

            • original_owner_answer
              نوع: string | null

              متن اصلی پاسخ مالک
              پاسخ اصلی به نظر، بدون اعمال ترجمه خودکار

            • original_review_text
              نوع: string | null

              محتوای اصلی نظر
              محتوای اصلی نظر، بدون اعمال ترجمه خودکار

            • owner_answer
              نوع: string | null

              متن پاسخ مالک
              پاسخ مالک به نظر

            • owner_time_ago
              نوع: string | null

              زمان انتشار
              زمانی را نشان می‌دهد (در قالب 'چند وقت پیش') که مالک پاسخ خود را به نظر ارسال کرده است

            • owner_timestamp
              نوع: string | null

              تاریخ و زمان پاسخ مالک به نظر
              با قالب UTC: “yyyy-mm-dd hh-mm-ss +00:00”
              مثال:
              2019-11-15 12:57:46 +00:00

            • photos_count
              نوع: integer | null قالب: int64

              تعداد کل عکس‌های ارسال‌شده توسط نویسنده نظر

            • position
              نوع: string | null

              تراز نظر در SERP
              می‌تواند مقادیر زیر را داشته باشد: right

            • profile_image_url
              نوع: string | null

              نشانی URL تصویر پروفایل نویسنده نظر

            • profile_name
              نوع: string | null

              نام پروفایل نویسنده نظر

            • profile_url
              نوع: string | null

              نشانی URL پروفایل نویسنده نظر

            • rank_absolute
              نوع: integer | null

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

            • rank_group
              نوع: integer | null

              موقعیت در یک گروه از عناصر با مقادیر type یکسان
              موقعیت عناصر با مقادیر type متفاوت از rank_group حذف می‌شود

            • rating
              نوع: object | null · Response36Afe1097B20_RatingInfo

              امتیاز رتبه‌بندی ارسال‌شده توسط بازبین

              • rating_max
                نوع: integer | null

                حداکثر مقدار یک rating_type

              • rating_type
                نوع: string | null

                نوع امتیاز اینجا می‌توانید عناصر زیر را بیابید: Max5، Percents، CustomMax

              • value
                نوع: number | null قالب: double

                مقدار امتیاز

              • votes_count
                نوع: integer | null قالب: int64

                میزان بازخورد

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

              نکات برجسته نظر
              حاوی معیارها و ارزیابی‌های برجسته‌شده نظر است

              • assessment
                نوع: string | null

                ارزیابی ویژگی

              • feature
                نوع: string | null

                ویژگی بررسی‌شده

            • review_id
              نوع: string | null

              شناسه یکتای نظر در Google
              مثال:
              ChZDSUhNMG9nS0VJQ0FnSUMxbHFyMFlnEAE

            • review_text
              نوع: string | null

              محتوای نظر

            • review_url
              نوع: string | null

              نشانی URL نظر

            • reviews_count
              نوع: integer | null قالب: int64

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

            • source
              نوع: object | null · Response36Afe1097B20_Source

              منبع نظر
              شامل اطلاعاتی درباره منبعی است که نظر در آن منتشر شده است

              • domain
                نوع: string | null

                دامنه منبعی که نظر در آن منتشر شده است

              • image
                نوع: string | null

                تصویر شاخص منبع

              • title
                نوع: string | null

                نام منبعی که نظر در آن منتشر شده است

            • time_ago
              نوع: string | null

              زمان انتشار
              زمانی را نشان می‌دهد (در قالب 'چند وقت پیش') که نظر نمایش داده شده است

            • timestamp
              نوع: string | null

              تاریخ و زمان انتشار نظر
              در قالب UTC: “yyyy-mm-dd hh-mm-ss +00:00”
              مثال:
              2019-11-15 12:57:46 +00:00

            • type
              نوع: string | null

              نوع عنصر

            • xpath
              نوع: string | null

              XPath مربوط به نظر

          • items_count
            نوع: integer | null قالب: int64

            تعداد آیتم‌های نظرات در آرایه نتایج
            می‌توانید با استفاده از پارامتر depth هنگام تنظیم وظیفه نتایج بیشتری دریافت کنید

          • keyword
            نوع: string | null

            کلیدواژه دریافت‌شده در آرایه POST
            کلیدواژه با کدگشایی %## برگردانده می‌شود (کاراکتر '+' به فاصله کدگشایی می‌شود)

          • language_code
            نوع: string | null

            کد زبان در آرایه POST

          • location_code
            نوع: integer | null

            کد مکان در آرایه POST

          • place_id
            نوع: string | null

            شناسه یکتای موقعیت کسب‌وکار که Google اختصاص می‌دهد
            برای آشنایی بیشتر با این شناسه، این مقاله مرکز راهنما را ببینید

          • rating
            نوع: object | null · Response36Afe1097B20_RatingInfo

            امتیاز مؤسسه محلی مربوطه
            نرخ محبوبیت بر اساس نظرات که در SERP نمایش داده می‌شود

            • rating_max
              نوع: integer | null

              حداکثر مقدار یک rating_type

            • rating_type
              نوع: string | null

              نوع امتیاز اینجا می‌توانید عناصر زیر را بیابید: Max5، Percents، CustomMax

            • value
              نوع: number | null قالب: double

              مقدار امتیاز

            • votes_count
              نوع: integer | null قالب: int64

              میزان بازخورد

          • reviews_count
            نوع: integer | null قالب: int64

            تعداد کل نظرات

          • se_domain
            نوع: string | null

            دامنه موتور جستجو در آرایه POST

          • sub_title
            نوع: string | null

            زیرعنوان عنصر «reviews» در SERP
            اطلاعات تکمیلی (مثلاً نشانی) درباره عنصر «reviews» که نظرات برای آن جمع‌آوری می‌شوند

          • title
            نوع: string | null

            عنوان عنصر «reviews» در SERP
            نام مؤسسه محلی که نظرات برای آن جمع‌آوری می‌شوند

          • type
            نوع: string | 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 get/v1/beta/dataforseo/business_data/google/extended_reviews/task_get/{id}
curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/extended_reviews/task_get/00000000-0000-0000-0000-000000000000 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "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": [
        {
          "keyword": null,
          "type": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "check_url": null,
          "datetime": null,
          "title": null,
          "sub_title": null,
          "rating": {
            "rating_type": null,
            "value": null,
            "votes_count": null,
            "rating_max": null
          },
          "feature_id": null,
          "place_id": null,
          "cid": null,
          "reviews_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "position": null,
              "xpath": null,
              "review_text": null,
              "original_review_text": null,
              "time_ago": null,
              "timestamp": null,
              "rating": "[Max Depth Exceeded]",
              "reviews_count": null,
              "photos_count": null,
              "local_guide": null,
              "profile_name": null,
              "profile_url": null,
              "review_url": null,
              "profile_image_url": null,
              "owner_answer": null,
              "original_owner_answer": null,
              "owner_time_ago": null,
              "owner_timestamp": null,
              "review_id": null,
              "images": [
                "[Max Depth Exceeded]"
              ],
              "review_highlights": [
                "[Max Depth Exceeded]"
              ],
              "source": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}
Get Business Data Google Extended Reviews Results by id