Felo API PlatformFelo API Platform
כל ה-endpoints של DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

קבלת תוצאות Google Shopping Sellers לפי id

שרת:https://openapi.felo.ai
ספריות לקוח

DataForSEO

​

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

קבלת תוצאות Google Shopping Sellers לפי id

​

התגובה עטופה במעטפת של DataForSEO: הנתונים ב-tasks[0].result, והתוצאה ב-tasks[0].status_code — גם בקשה שנדחתה מחזירה HTTP 200. זו תצוגת השוואת המחירים; המוצר עצמו הוא get_dataforseo_merchant_google_product_info_fetch.

מראה תמחור

  • מדידה: עלות תגובה מדווחת.
  • אומדן בקשת עיון: 0.012 דולר ארה״ב.
  • מכפיל לקוח לעיון: 1.0. אין להחיל אותו בשנית על סכום לקוח שכבר נקבע.

זהו מטא-נתון לעיון בלבד, לא הצעת מחיר לחשבון, לא מחיר מובטח ולא תקרת הוצאה. קרדיטי משאבים אינם קרדיטים של Felo. החיוב הסופי נעשה לפי רשומות החיוב של Felo.

פרמטרי נתיב
  • id
    סוג: string
    חובה

    מזהה המשימה
    מזהה משימה ייחודי במערכת שלנו בפורמט UUID
    אפשר להשתמש בו במשך 30 יום כדי לבקש את תוצאות המשימה בכל עת

תגובות
  • 200
    סוג: object | null · Response36Afe1097B20_MerchantGoogleSellersTaskGetAdvancedResponseInfo
    • cost
      סוג: number | null פורמט: double

      סך עלות המשימות, בדולר ארה״ב

    • status_code
      סוג: integer | null

      קוד סטטוס כללי את הרשימה המלאה של קודי התגובה אפשר למצוא כאן

    • status_message
      סוג: string | null

      הודעה אינפורמטיבית כללית את הרשימה המלאה של ההודעות האינפורמטיביות הכלליות אפשר למצוא כאן

    • tasks
      סוג: array (object | null)[] | null

      מערך משימות

      • סוג: object | null · Response36Afe1097B20_MerchantGoogleSellersTaskGetAdvancedTaskInfo
        • 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 ישירה לתוצאות Google Shopping
            אפשר להשתמש בה כדי לוודא שסיפקנו תוצאות מדויקות

          • datetime
            סוג: string | null

            התאריך והשעה שבהם התוצאה התקבלה
            בפורמט UTC: “yyyy-mm-dd hh-mm-ss +00:00”
            דוגמה:
            2019-11-15 12:57:46 +00:00

          • image_url
            סוג: string | null

            כתובת URL לתמונת המוצר

          • item_types
            סוג: array (string | null)[] | null

            סוגי תוצאות החיפוש שנמצאו ב-Google Shopping SERP
            מכיל את הסוגים של כל תוצאות החיפוש (items) שנמצאו ב-SERP שהוחזר
            סוגי פריטים אפשריים:
            shops_list, buy_on_google

          • items
            סוג: array (object | null)[] | null

            פריטים ב-SERP

            • base_price
              סוג: number | null

              מחיר המוצר ללא מס ומשלוח

            • currency
              סוג: string | null

              המטבע בפורמט ISO
              דוגמה:
              USD

            • details
              סוג: string | null

              פרטים ומבצעים מיוחדים
              אם אין פרטים, הערך יהיה null

            • domain
              סוג: string | null

              דומיין ב-SERP

            • position
              סוג: string | null

              היישור של הרכיב ב-Google Shopping SERP
              ערכים אפשריים:
              left, right

            • rank_absolute
              סוג: integer | null

              דירוג מוחלט ב-SERP
              מיקום מוחלט מבין כל הרכיבים שנמצאו ב-Google Shopping SERP

            • rank_group
              סוג: integer | null

              מיקום בתוך קבוצת רכיבים עם ערכי type זהים
              מיקומים של רכיבים עם ערכי type שונים מושמטים מ-rank_group

            • seller_name
              סוג: string | null

              שם המוכר
              שם החברה שהציבה מוצר מתאים ב-Google Shopping

            • shipping_price
              סוג: number | null

              מחיר המשלוח של המוצר

            • shop_ad_aclk
              סוג: string | null

              פרמטר ייחוס ייחודי של לחיצה על מודעה
              באמצעות הפרמטר הזה אפשר לקבל כתובת URL של המודעה בGoogle Shopping Sellers Ad URL

            • tax
              סוג: number | null

              סכום המס
              המס מצוין כסכום כסף בפועל, לא כאחוז

            • title
              סוג: string | null

              כותרת המוצר

            • total_price
              סוג: number | null פורמט: int64

              מחיר המוצר כולל מס ומשלוח

            • type
              סוג: string | null

              סוג הרכיב

            • url
              סוג: string | null

              כתובת URL של Google Shopping המפנה לדף המוצר באתר המוכר
              אם ברצונכם לקבל כתובת URL של המודעה המפנה לדף המוצר באתר המוכר, עיינו בנקודת הקצה Google Shopping Sellers Ad URL

            • xpath
              סוג: string | null

              XPath של הרכיב

          • items_count
            סוג: integer | null פורמט: int64

            מספר התוצאות שמוחזרו במערך items

          • language_code
            סוג: string | null

            קוד שפה במערך POST

          • location_code
            סוג: integer | null

            קוד מיקום במערך POST

          • product_id
            סוג: string | null

            product_id שהתקבל במערך POST
            מידע נוסף על הפרמטר במדריך מרכז העזרה הזה

          • 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

              כמות המשוב

          • se_domain
            סוג: string | null

            דומיין מנוע החיפוש במערך POST

          • title
            סוג: string | null

            כותרת המוצר

          • type
            סוג: string | null

            סוג הרכיב

          • url
            סוג: string | null

            כתובת URL לעמוד המוצר

        • 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/merchant/google/sellers/task_get/advanced/{id}
curl https://openapi.felo.ai/v1/beta/dataforseo/merchant/google/sellers/task_get/advanced/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": [
        {
          "product_id": null,
          "type": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "check_url": null,
          "datetime": null,
          "title": null,
          "url": null,
          "image_url": null,
          "rating": {
            "rating_type": null,
            "value": null,
            "votes_count": null,
            "rating_max": null
          },
          "item_types": [
            null
          ],
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "position": null,
              "xpath": null,
              "domain": null,
              "title": null,
              "url": null,
              "details": null,
              "base_price": null,
              "tax": null,
              "shipping_price": null,
              "total_price": null,
              "currency": null,
              "seller_name": null,
              "shop_ad_aclk": null
            }
          ]
        }
      ]
    }
  ]
}
Get Google Shopping Sellers Results by id