Felo API PlatformFelo API Platform
تمام DataForSEO endpoints
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 کے ساتھ products نتیجے سے لیے گئے gid یا data_docid سے کریں۔ یہ فیملی مکمل طور پر async ہے: submit tasks[0].id میں ایک ٹاسک id واپس کرتا ہے، اور fetch ٹول تیار ہونے پر نتیجہ دیتا ہے۔ get_dataforseo_merchant_google_reviews_fetch سے حاصل کریں۔

قیمت کا حوالہ

  • میٹرنگ: رپورٹ شدہ جواب کی لاگت۔
  • حوالہ جاتی درخواست کا تخمینہ: USD 0.012۔
  • حوالہ جاتی صارف ملٹی پلائر: 1.0۔ تصفیہ شدہ صارف رقم پر اسے دوبارہ لاگو نہیں کریں۔

صرف حوالہ جاتی میٹا ڈیٹا، نہ کہ اکاؤنٹ کا کوٹ، ضمانت شدہ قیمت یا اخراجات کی حد۔ ریسورس کریڈٹس Felo کریڈٹس نہیں ہیں۔ حتمی چارجز Felo کے بلنگ ریکارڈز کے مطابق ہوں گے۔

باڈی
لازمی
application/json
  • قسم: array object[]
    • قسم: object
      • gid
        قسم: string
        لازمی

        Google Shopping پر عالمی پروڈکٹ شناخت کنندہ؛ درکار فیلڈ؛ بہترین نتائج کے لیے ہم تجویز دیتے ہیں کہ gid کو data_docid اور product_id کے ساتھ مل کر متعین کریں؛ آپ یہ قدر کسی مخصوص پروڈکٹ کے لیے Google Shopping Products endpoint پر الگ درخواست بھیج کر حاصل کر سکتے ہیں؛ مثال: 4702526954592161872؛ اس help center گائیڈ میں پیرامیٹر کے بارے میں مزید جانیں

      • data_docid
        قسم: string

        SERP ڈیٹا عنصر کا منفرد شناخت کنندہ؛ اختیاری فیلڈ؛ بہترین نتائج کے لیے ہم تجویز دیتے ہیں کہ data_docid کو product_id اور gid کے ساتھ مل کر متعین کریں؛ آپ یہ قدر کسی مخصوص عنصر کے لیے Google Shopping Products endpoint پر الگ درخواست بھیج کر حاصل کر سکتے ہیں؛ مثال: 13071766526042404278

      • depth
        قسم: integer

        پارسنگ ڈیپتھ؛ اختیاری فیلڈ؛ SERP میں جائزوں کی تعداد؛ ہم پارسنگ ڈیپتھ کو دس کے ضربوں میں مقرر کرنے کی سختی سے تجویز دیتے ہیں کیونکہ ہمارا سسٹم دس جائزے مسلسل پروسیس کرتا ہے؛ زیادہ سے زیادہ قدر: 8000؛ ڈیفالٹ قدر: 10؛ آپ کے اکاؤنٹ سے ہر اس SERP کے لیے بل لیا جائے گا جس میں زیادہ سے زیادہ 10 نتائج ہوں؛ 10 سے زیادہ ڈیپتھ مقرر کرنے پر اضافی چارجز آ سکتے ہیں اگر سرچ انجن 10 سے زیادہ نتائج واپس کرے؛ لاگت Pricing صفحے پر شمار کی جا سکتی ہے۔

      • 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۔ اختیاری فیلڈ۔ ٹاسک مکمل ہونے پر ہم آپ کو آپ کے متعین کردہ URL پر GET درخواست بھیج کر مطلع کریں گے۔ آپ ‘$id’ اسٹرنگ کو $id متغیر کے طور پر اور ‘$tag’ کو urlencoded $tag متغیر کے طور پر استعمال کر سکتے ہیں۔ ہم درخواست بھیجنے سے پہلے ضروری اقدار سیٹ کر دیں گے۔ مثال: http://your-server.com/pingscript?id=$id۔ http://your-server.com/pingscript?id=$id&tag=$tag۔ نوٹ: pingback_url میں خصوصی حروف urlencoded ہو جائیں گے؛ یعنی، # حرف %23 میں انکوڈ ہو جائے گا۔ ہمارے Help Center پر مزید جانیں

      • postback_data
        قسم: string

        postback_url ڈیٹا ٹائپ۔ اختیاری فیلڈ۔ اس ڈیٹا ٹائپ سے مطابقت رکھتا ہے جو آپ کے سرور کو بھیجا جائے گا۔ ممکنہ اقدار: advanced

      • postback_url
        قسم: string

        ٹاسک کے نتائج بھیجنے کے لیے URL۔ اختیاری فیلڈ۔ ٹاسک مکمل ہونے کے بعد ہم اس کے نتائج کو gzip فارمیٹ میں کمپریس کر کے آپ کے متعین کردہ postback_url پر POST درخواست کے ذریعے بھیجیں گے۔ آپ ‘$id’ اسٹرنگ کو $id متغیر کے طور پر اور ‘$tag’ کو urlencoded $tag متغیر کے طور پر استعمال کر سکتے ہیں۔ ہم درخواست بھیجنے سے پہلے ضروری اقدار سیٹ کر دیں گے۔ مثال: http://your-server.com/postbackscript?id=$id۔ http://your-server.com/postbackscript?id=$id&tag=$tag۔ نوٹ: postback_url میں خصوصی حروف urlencoded ہو جائیں گے؛ یعنی، # حرف %23 میں انکوڈ ہو جائے گا۔ ہمارے Help Center پر مزید جانیں

      • priority
        قسم: integer

        ٹاسک کی ترجیح۔ اختیاری فیلڈ۔ درج ذیل اقدار لے سکتا ہے: 1 – معمول کی عمل درآمد کی ترجیح (ڈیفالٹ طور پر سیٹ)۔ 2 – اعلیٰ عمل درآمد کی ترجیح۔ اعلیٰ عمل درآمد کی ترجیح والے ٹاسکس پر آپ سے اضافی چارج لیا جائے گا۔ لاگت Pricing صفحے پر شمار کی جا سکتی ہے۔

      • product_id
        قسم: string

        Google Shopping پر منفرد پروڈکٹ شناخت کنندہ۔ اختیاری فیلڈ۔ بہترین نتائج کے لیے ہم تجویز دیتے ہیں کہ product_id کو data_docid اور gid کے ساتھ متعین کریں؛ آپ کسی مخصوص پروڈکٹ کے لیے یہ قدر Google Shopping Products endpoint پر الگ درخواست بھیج کر حاصل کر سکتے ہیں۔ مثال: 4485466949985702538۔ اس پیرامیٹر کے بارے میں اس help center گائیڈ میں مزید جانیں

      • se_domain
        قسم: string

        سرچ انجن کا ڈومین۔ اختیاری فیلڈ۔ ہم آپ کے متعین کردہ مقام اور زبان کے مطابق متعلقہ سرچ انجن ڈومین خود بخود منتخب کرتے ہیں، تاہم آپ اس فیلڈ میں حسب ضرورت سرچ انجن ڈومین سیٹ کر سکتے ہیں۔ مثال: google.co.uk، google.com.au، google.de، وغیرہ

      • tag
        قسم: string

        صارف کے متعین کردہ ٹاسک کا شناخت کنندہ۔ اختیاری فیلڈ۔ حروف کی حد 255 ہے۔ آپ اس پیرامیٹر سے ٹاسک کی شناخت کر سکتے ہیں اور اسے نتیجے سے ملا سکتے ہیں۔ آپ جواب کے data آبجیکٹ میں متعین کردہ tag قدر دیکھیں گے

      خالی آبجیکٹ
      خالی آبجیکٹ
جوابات
  • 200
    قسم: object

    کامیاب جواب

    • cost
      قسم: number

      ٹاسکس کی کل لاگت، USD

    • status_code
      قسم: integer

      عمومی اسٹیٹس کوڈ۔ جوابی کوڈز کی مکمل فہرست یہاں مل سکتی ہے۔ نوٹ: ہم متعلقہ استثنائی یا خرابی کی صورتحال سنبھالنے کے لیے ضروری نظام ڈیزائن کرنے کی سختی سے سفارش کرتے ہیں

    • status_message
      قسم: string

      عمومی معلوماتی پیغام۔ عمومی معلوماتی پیغامات کی مکمل فہرست یہاں مل سکتی ہے

    • tasks
      قسم: array string[]

      ٹاسکس کی صف

    • tasks_count
      قسم: integer

      tasksarray میں ٹاسکس کی تعداد

    • tasks_error
      قسم: integer

      خرابی کے ساتھ واپس ہونے والے tasks صف میں ٹاسکس کی تعداد

    • tasks.cost
      قسم: number

      ٹاسک کی لاگت، USD

    • tasks.data
      قسم: object

      وہی پیرامیٹرز رکھتا ہے جو آپ نے POST درخواست میں متعین کیے۔

    • tasks.id
      قسم: string

      ہمارے سسٹم میں منفرد ٹاسک شناخت کنندہ، Universally unique identifier (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

    درست Felo API کلید درکار ہے۔

  • 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