Felo API PlatformFelo API Platform
כל ה-endpoints של 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 (Universally unique identifier)

    • 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