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

تنظیم وظایف Google Shopping Reviews

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

DataForSEO

​

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

DataForSEO عملیات

تنظیم وظایف Google Shopping Reviews

​

نظرات یک محصول Google Shopping را در صف قرار می‌دهد و id وظیفه را برمی‌گرداند. محصول را با product_id به‌همراه gid یا data_docid از نتیجه محصولات مشخص کنید. این خانواده سراسر ناهمگام است: ارسال id وظیفه را در tasks[0].id برمی‌گرداند و ابزار واکشی پس از آماده شدن، نتیجه را برمی‌گرداند. بازیابی با get_dataforseo_merchant_google_reviews_fetch.

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

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

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

بدنه
الزامی
application/json
  • نوع: array object[]
    • نوع: object
      • gid
        نوع: string
        الزامی

        شناسه محصول جهانی در Google Shopping فیلد الزامی توصیه می‌کنیم gid را همراه با data_docid و product_id برای بهترین نتایج مشخص کنید؛ می‌توانید این مقدار را برای یک محصول خاص با ارسال درخواستی جداگانه به نقطه پایانی محصولات Google Shopping دریافت کنید مثال: 4702526954592161872 درباره این پارامتر در این راهنمای مرکز راهنمایی بیشتر بدانید

      • data_docid
        نوع: string

        شناسه یکتای عنصر داده SERP فیلد اختیاری توصیه می‌کنیم data_docid را همراه با product_id و gid برای بهترین نتایج مشخص کنید؛ می‌توانید این مقدار را برای یک عنصر خاص با ارسال درخواستی جداگانه به نقطه پایانی محصولات Google Shopping دریافت کنید مثال: 13071766526042404278

      • depth
        نوع: integer

        عمق تجزیه فیلد اختیاری تعداد نظرات در SERP؛ اکیداً توصیه می‌کنیم عمق تجزیه را در مضارب ده تنظیم کنید، زیرا سیستم ما ده نظر را پشت سر هم پردازش می‌کند؛ حداکثر مقدار: 8000 مقدار پیش‌فرض: 10 حساب شما برای هر SERP که حداکثر 10 نتیجه دارد صورت‌حساب می‌شود؛ تنظیم عمق بیش از 10 ممکن است در صورت بازگرداندن بیش از 10 نتیجه توسط موتور جستجو هزینه‌های اضافی ایجاد کند؛ هزینه را می‌توان در صفحه قیمت‌گذاری محاسبه کرد.

      • language_code
        نوع: string

        کد زبان موتور جستجو فیلد الزامی اگر مشخص نکنید language_name اگر از این فیلد استفاده کنید، نیازی به تعیین language_name نیست می‌توانید فهرست زبان‌های موجود را همراه با پارامترهای language_code آن‌ها با ارسال درخواستی جداگانه به https://api.dataforseo.com/v3/merchant/google/languages دریافت کنید مثال: en_GB

      • language_name
        نوع: string

        نام کامل زبان موتور جستجو فیلد الزامی اگر مشخص نکنید language_code اگر از این فیلد استفاده کنید، نیازی به تعیین language_code نیست می‌توانید فهرست زبان‌های موجود را همراه با پارامترهای language_name آن‌ها با ارسال درخواستی جداگانه به https://api.dataforseo.com/v3/merchant/google/languages دریافت کنید مثال: English (United Kingdom)

      • location_code
        نوع: integer

        کد موقعیت موتور جستجو فیلد الزامی اگر مشخص نکنید location_name یا location_coordinate اگر از این فیلد استفاده کنید، نیازی به تعیین location_name یا location_coordinate نیست می‌توانید فهرست موقعیت‌های موجود را همراه با پارامترهای location_code آن‌ها با ارسال درخواستی جداگانه به https://api.dataforseo.com/v3/merchant/google/locations دریافت کنید مثال: 9045969

      • location_coordinate
        نوع: string

        مختصات GPS یک موقعیت فیلد الزامی اگر مشخص نکنید location_name یا location_code اگر از این فیلد استفاده کنید، نیازی به تعیین location_name یا location_code نیست پارامتر location_coordinate باید در قالب “latitude,longitude,radius” مشخص شود حداکثر تعداد ارقام اعشار برای “latitude” و “longitude”: 7 حداقل مقدار برای “radius”: 199.9 مثال: 53.476225,-2.243572,200

      • location_name
        نوع: string

        نام کامل موقعیت موتور جستجو فیلد الزامی اگر مشخص نکنید location_code یا location_coordinate اگر از این فیلد استفاده کنید، نیازی به تعیین location_code یا location_coordinate نیست می‌توانید فهرست موقعیت‌های موجود را همراه با پارامترهای location_name آن‌ها با ارسال درخواستی جداگانه به https://api.dataforseo.com/v3/merchant/google/locations دریافت کنید مثال: HA1,England,United Kingdom

      • pingback_url
        نوع: string

        نشانی URL اطلاع‌رسانی برای وظیفه تکمیل‌شده فیلد اختیاری وقتی وظیفه تکمیل شد، با درخواست GET به نشانی URL تعیین‌شده به شما اطلاع می‌دهیم می‌توانید از رشته ‘$id’ به‌عنوان متغیر $id و از ‘$tag’ به‌عنوان متغیر $tag کدگذاری‌شده در URL استفاده کنید. مقادیر لازم را پیش از ارسال درخواست تنظیم می‌کنیم. مثال: http://your-server.com/pingscript?id=$id http://your-server.com/pingscript?id=$id&tag=$tag توجه: کاراکترهای ویژه در pingback_url با URL کدگذاری می‌شوند؛ از جمله کاراکتر # به %23 کدگذاری می‌شود اطلاعات بیشتر در مرکز راهنمایی ما

      • postback_data
        نوع: string

        نوع داده postback_url فیلد اختیاری با نوع داده‌ای مطابقت دارد که به سرور شما ارسال می‌شود مقادیر ممکن: advanced

      • postback_url
        نوع: string

        نشانی URL برای ارسال نتایج وظیفه فیلد اختیاری پس از تکمیل وظیفه، درخواست POST حاوی نتایج فشرده‌شده با فرمت gzip را به postback_url تعیین‌شده ارسال می‌کنیم می‌توانید از رشته ‘$id’ به‌عنوان متغیر $id و از ‘$tag’ به‌عنوان متغیر $tag کدگذاری‌شده در URL استفاده کنید. مقادیر لازم را پیش از ارسال درخواست تنظیم می‌کنیم. مثال: http://your-server.com/postbackscript?id=$id http://your-server.com/postbackscript?id=$id&tag=$tag توجه: کاراکترهای ویژه در postback_url با URL کدگذاری می‌شوند؛ از جمله کاراکتر # به %23 کدگذاری می‌شود اطلاعات بیشتر در مرکز راهنمایی ما

      • priority
        نوع: integer

        اولویت وظیفه فیلد اختیاری می‌تواند مقادیر زیر را داشته باشد: 1 – اولویت اجرای عادی (به‌طور پیش‌فرض تنظیم می‌شود) 2 – اولویت اجرای بالا برای وظایف با اولویت اجرای بالا هزینه اضافی دریافت می‌شود. هزینه را می‌توانید در صفحه قیمت‌گذاری محاسبه کنید.

      • product_id
        نوع: string

        شناسه یکتای محصول در Google Shopping فیلد اختیاری توصیه می‌کنیم product_id را همراه با data_docid و gid برای بهترین نتایج مشخص کنید؛ می‌توانید این مقدار را برای یک محصول خاص با ارسال درخواست جداگانه به نقطه پایانی Google Shopping Products دریافت کنید مثال: 4485466949985702538 اطلاعات بیشتر درباره این پارامتر در این راهنمای مرکز راهنمایی

      • se_domain
        نوع: string

        دامنه موتور جستجو فیلد اختیاری دامنه موتور جستجوی مناسب را به‌طور خودکار بر اساس مکان و زبانی که تعیین می‌کنید انتخاب می‌کنیم با این حال، می‌توانید دامنه موتور جستجوی سفارشی را در این فیلد تنظیم کنید مثال: google.co.uk، google.com.au، google.de و غیره.

      • tag
        نوع: string

        شناسه وظیفه تعریف‌شده توسط کاربر فیلد اختیاری محدودیت کاراکتر 255 است می‌توانید از این پارامتر برای شناسایی وظیفه و تطبیق آن با نتیجه استفاده کنید مقدار tag مشخص‌شده را در شیء data پاسخ پیدا می‌کنید

      شیء خالی
      شیء خالی
پاسخ‌ها
  • 200
    نوع: object

    پاسخ موفق

    • cost
      نوع: number

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

    • status_code
      نوع: integer

      کد وضعیت عمومی فهرست کامل کدهای پاسخ را اینجا پیدا می‌کنید توجه: اکیداً توصیه می‌کنیم سیستمی لازم برای مدیریت شرایط استثنایی یا خطاهای مرتبط طراحی کنید

    • status_message
      نوع: string

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

    • tasks
      نوع: array string[]

      آرایه وظایف

    • tasks_count
      نوع: integer

      تعداد وظایف در tasksarray

    • tasks_error
      نوع: integer

      تعداد وظایف در آرایه tasks که با خطا برگردانده شده‌اند

    • tasks.cost
      نوع: number

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

    • tasks.data
      نوع: object

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

    • tasks.id
      نوع: string

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

    • tasks.path
      نوع: array string[]

      مسیر URL

    • tasks.result
      نوع: array string[]

      آرایه نتایج. در این حالت، مقدار null خواهد بود

    • tasks.result_count
      نوع: integer

      تعداد عناصر در آرایه result

    • tasks.status_code
      نوع: integer

      کد وضعیت وظیفه که توسط DataForSEO تولید می‌شود؛ می‌تواند در بازه زیر باشد: 10000-60000

    • tasks.status_message
      نوع: string

      پیام اطلاعاتی وظیفه

    • tasks.time
      نوع: string

      زمان اجرا، ثانیه

    • time
      نوع: string

      زمان اجرا، ثانیه

    • version
      نوع: string

      نسخه فعلی API

    application/json
  • 400

    درخواست پردازش نشد. پارامترهای درخواست را بررسی کنید.

  • 401

    یک کلید API معتبر Felo لازم است.

  • 402

    درخواست ادامه نمی‌یابد چون یک الزام صورت‌حساب برآورده نشده است.

  • 403

    حساب مجاز به انجام این عملیات نیست.

  • 429

    به سقف درخواست یا هزینه رسیده‌اید.

  • 502

    سرویس نتوانست درخواست را کامل کند.

  • 503

    سرویس API یا صورت‌حساب موقتاً در دسترس نیست.

  • 504

    سرویس هنگام پردازش درخواست به پایان مهلت رسید.

  • default

    پاسخ خطا؛ پاسخ‌های عبوری بالادست ممکن است از قالب‌های ارائه‌دهنده استفاده کنند

    application/json
Request Example for post/v1/beta/dataforseo/merchant/google/reviews/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/merchant/google/reviews/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {},
  {}
]'

{
  "version": "string",
  "status_code": 1,
  "status_message": "string",
  "time": "string",
  "cost": 1,
  "tasks_count": 1,
  "tasks_error": 1,
  "tasks": [
    "string"
  ],
  "tasks.id": "string",
  "tasks.status_code": 1,
  "tasks.status_message": "string",
  "tasks.time": "string",
  "tasks.cost": 1,
  "tasks.result_count": 1,
  "tasks.path": [
    "string"
  ],
  "tasks.data": {},
  "tasks.result": [
    "string"
  ]
}

پاسخ موفق

Setting Google Shopping Reviews Tasks