Felo API PlatformFelo API Platform
تمام DataForSEO endpoints
v0.2.0-beta
OpenAPI 3.1.0

Google Shopping Sellers ٹاسکس سیٹ کرنا

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 Sellers ٹاسکس سیٹ کرنا

​

ایک Google Shopping پروڈکٹ پیش کرنے والے سیلرز کی فہرست قطار میں ڈالتا ہے اور ٹاسک id واپس کرتا ہے۔ یہ فیملی مکمل طور پر async ہے: submit tasks[0].id میں ایک ٹاسک id واپس کرتا ہے، اور fetch ٹول تیار ہونے پر نتیجہ دیتا ہے۔ get_dataforseo_merchant_google_sellers_fetch سے حاصل کریں۔

قیمت کا حوالہ

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

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

باڈی
application/json
  • قسم: array (object | null)[]
    • additional_specifications
      قسم: object | null

      اضافی url پیرامیٹرز پر مشتمل آبجیکٹ
      آپ "additional_specifications آبجیکٹ استعمال کر کے پروڈکٹ کے بارے میں اضافی معلومات حاصل کر سکتے ہیں، جو آپ Google Shopping Products endpoint پر الگ درخواست بھیج کر حاصل کر سکتے ہیں
      مثال:
      "additional_specifications": {
      "eto": "16157121050167572763_0"
      }

      • propertyName
        قسم: string | null
    • data_docid
      قسم: string

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

    • depth
      قسم: integer | null

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

    • get_shops_on_google
      قسم: boolean | null

      "buy on Google" دکانیں شامل کریں
      اختیاری فیلڈ
      اگر true پر سیٹ کیا جائے تو جواب میں ان بیچنے والوں کی فہرست ہوگی جو کوئی مخصوص پروڈکٹ براہ راست Google پر خریدنے کی اجازت دیتے ہیں
      نوٹ: اگر true پر سیٹ کیا جائے تو ٹاسک کی لاگت دوگنی ہو جائے گی

    • gid
      قسم: string

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

    • language_code
      قسم: string

      زبان کا کوڈ
      اگر آپ language_name متعین نہ کریں تو درکار فیلڈ
      اگر آپ یہ فیلڈ استعمال کریں تو language_name متعین کرنے کی ضرورت نہیں
      آپ Google Shopping کی دستیاب زبانوں کی فہرست ان کے language_code_کے ساتھ https://api.dataforseo.com/v3/merchant/google/languages پر الگ درخواست بھیج کر حاصل کر سکتے ہیں
      مثال:
      en

    • language_name
      قسم: string

      زبان کا پورا نام
      اگر آپ language_code متعین نہ کریں تو درکار فیلڈ
      اگر آپ یہ فیلڈ استعمال کریں تو language_code متعین کرنے کی ضرورت نہیں
      آپ Google Shopping کی دستیاب زبانوں کی فہرست ان کے language_name کے ساتھ https://api.dataforseo.com/v3/merchant/google/languages پر الگ درخواست بھیج کر حاصل کر سکتے ہیں
      مثال:
      English

    • location_code
      قسم: integer

      مقام کا کوڈ
      اگر آپ location_name_یا location_coordinate متعین نہ کریں تو درکار فیلڈ
      اگر آپ یہ فیلڈ استعمال کریں تو location_name یا location_coordinate متعین کرنے کی ضرورت نہیں
      آپ Google Shopping کے دستیاب مقامات کی فہرست ان کے location_code کے ساتھ https://api.dataforseo.com/v3/merchant/google/locations پر الگ درخواست بھیج کر حاصل کر سکتے ہیں
      مثال:
      2840

    • 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 متعین کرنے کی ضرورت نہیں
      آپ Google Shopping کے دستیاب مقامات کی فہرست ان کے location_name کے ساتھ https://api.dataforseo.com/v3/merchant/google/locations پر الگ درخواست بھیج کر حاصل کر سکتے ہیں
      مثال:
      London,England,United Kingdom

    • pingback_url
      قسم: string | null

      مکمل شدہ ٹاسک کا اطلاعی 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 میں خصوصی حروف urlencode کیے جائیں گے؛
      مثلاً # حرف %23 میں انکوڈ کیا جائے گا

      مزید جانیں ہمارے Help Center پر

    • postback_data
      قسم: string | null
    • postback_url
      قسم: string | null

      ٹاسک کے نتائج بھیجنے کے لیے 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 میں خصوصی حروف urlencode کیے جائیں گے؛
      مثلاً # حرف %23 میں انکوڈ کیا جائے گا

      مزید جانیں ہمارے Help Center پر

    • priority
      قسم: integer | null

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

    • product_id
      قسم: string

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

    • pvf
      قسم: string | null

      Google Shopping پر پروڈکٹ ویریئنٹ فلٹر
      اختیاری فیلڈ
      Google Shopping URL میں پیرامیٹر، اختیاری پروڈکٹ ویریئنٹ فلٹریشن مقرر کرتا ہے؛
      مثال:
      Eg4iBWNvbG9yKgV3aGl0ZRISIgxwYWNrYWdlIHNpemUqAjE0EgoiBHNpemUqAnhs

    • se_domain
      قسم: string | null

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

    • tag
      قسم: string | null

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

جوابات
  • 200
    قسم: object | null · Response36Afe1097B20_MerchantGoogleSellersTaskPostResponseInfo
    • cost
      قسم: number | null فارمیٹ: double

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

    • status_code
      قسم: integer | null

      عمومی اسٹیٹس کوڈ رسپانس کوڈز کی مکمل فہرست یہاں مل سکتی ہے

    • status_message
      قسم: string | null

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

    • tasks
      قسم: array (object | null)[] | null

      ٹاسکس کی صف

      • قسم: object | null · Response36Afe1097B20_MerchantGoogleSellersTaskPostTaskInfo
        • cost
          قسم: number | null فارمیٹ: double

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

        • data
          قسم: object | null

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

          • propertyName
            قسم: object | null
        • id
          قسم: string | null

          ٹاسک شناخت کنندہ ہمارے نظام میں UUID فارمیٹ کا منفرد ٹاسک شناخت کنندہ

        • path
          قسم: array (string | null)[] | null

          URL پاتھ

        • result
          قسم: object | null

          نتائج کی صف
          اس صورت میں قدر 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

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

  • 402

    درخواست آگے نہیں بڑھ سکتی کیونکہ بلنگ کی شرط پوری نہیں ہوئی۔

  • 403

    اکاؤنٹ کو یہ آپریشن کرنے کی اجازت نہیں۔

  • 429

    درخواست یا اخراجات کی حد پوری ہو گئی ہے۔

  • 502

    سروس درخواست مکمل نہیں کر سکی۔

  • 503

    API یا بلنگ سروس عارضی طور پر دستیاب نہیں۔

  • 504

    درخواست پر کارروائی کے دوران سروس کا وقت ختم ہو گیا۔

  • default

    خرابی کا جواب؛ اپ اسٹریم پاس تھرو جوابات پرووائیڈر کی شکلیں استعمال کر سکتے ہیں

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

{
  "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": null
    }
  ]
}

کامیاب آپریشن

Setting Google Shopping Sellers Tasks