DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
הגדרת משימות Google Shopping Sellers
מעמיד בתור את רשימת המוכרים שמציעים מוצר Google Shopping אחד, ומחזיר id של משימה. המשפחה הזו אסינכרונית לכל אורכה: השליחה מחזירה id של משימה ב-tasks[0].id, וכלי האחזור מחזיר את התוצאה כשהיא מוכנה. אחזרו עם get_dataforseo_merchant_google_sellers_fetch.
מראה תמחור
- מדידה: עלות תגובה מדווחת.
- אומדן בקשת עיון: 0.012 דולר ארה״ב.
- מכפיל לקוח לעיון: 1.0. אין להחיל אותו בשנית על סכום לקוח שכבר נקבע.
זהו מטא-נתון לעיון בלבד, לא הצעת מחיר לחשבון, לא מחיר מובטח ולא תקרת הוצאה. קרדיטי משאבים אינם קרדיטים של Felo. החיוב הסופי נעשה לפי רשומות החיוב של Felo.
- סוג: array (object | null)[]
- additionalסוג: object | null
_specifications - propertyסוג: string | null
Name
- dataסוג: string
_docid - depthסוג: integer | null
- getסוג: boolean | null
_shops _on _google הכללת חנויות "buy on Google"
שדה אופציונלי
אם מוגדר ל-true, התגובה תכיל את רשימת המוכרים שמאפשרים לרכוש מוצר מסוים ישירות ב-Google
הערה: אם מוגדר ל-true, עלות המשימה תוכפל - gidסוג: string
- languageסוג: string
_code קוד שפה
שדה חובה אם לא מצייניםlanguage_name
אם משתמשים בשדה הזה, אין צורך לצייןlanguage_name
אפשר לקבל את רשימת השפות הזמינות של Google Shopping עםlanguage_codeשלהן על ידי שליחת בקשה נפרדת אלhttps://api.dataforseo.com/v3/merchant/google/languages
דוגמה:en - languageסוג: string
_name השם המלא של השפה
שדה חובה אם לא מצייניםlanguage_code
אם משתמשים בשדה הזה, אין צורך לצייןlanguage_code
אפשר לקבל את רשימת השפות הזמינות של Google Shopping עםlanguage_nameשלהן על ידי שליחת בקשה נפרדת אלhttps://api.dataforseo.com/v3/merchant/google/languages
דוגמה:English - locationסוג: integer
_code קוד מיקום
שדה חובה אם לא מצייניםlocation_nameאוlocation_coordinate
אם משתמשים בשדה הזה, אין צורך לצייןlocation_nameאוlocation_coordinate
אפשר לקבל את רשימת המיקומים הזמינים של Google Shopping עםlocation_codeשלהם על ידי שליחת בקשה נפרדת אלhttps://api.dataforseo.com/v3/merchant/google/locations
דוגמה:2840 - locationסוג: string
_coordinate קואורדינטות 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סוג: string
_name השם המלא של המיקום
שדה חובה אם לא מציינים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סוג: string | null
_url כתובת URL להתראה על השלמת משימה
שדה אופציונלי
כשהמשימה תושלם, נודיע לכם באמצעות בקשת GET שתישלח לכתובת ה-URL שציינתם
אפשר להשתמש במחרוזת ‘$id’ כמשתנה$idוב-‘$tag’ כמשתנה$tagמקודד ב-urlencoded. נעדכן את הערכים הנדרשים לפני שליחת הבקשה.
דוגמה:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
הערה: תווים מיוחדים ב-pingback_urlיקודדו ב-urlencoded;
לדוגמה, התו#יקודד ל-%23 - postbackסוג: string | null
_data - postbackסוג: string | null
_url כתובת URL לשליחת תוצאות המשימה
שדה אופציונלי
כשהמשימה תושלם, נשלח בקשת POST עם התוצאות שלה דחוסות בפורמטgzipאל ה-postback_urlשציינתם
אפשר להשתמש במחרוזת ‘$id’ כמשתנה$idוב-‘$tag’ כמשתנה$tagמקודד ב-urlencoded. נעדכן את הערכים הנדרשים לפני שליחת הבקשה.
דוגמה:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
הערה: תווים מיוחדים ב-postback_urlיקודדו ב-urlencoded;
לדוגמה, התו#יקודד ל-%23 - priorityסוג: integer | null
- productסוג: string
_id - pvfסוג: string | null
מסנן וריאנטים של מוצר ב-Google Shopping
שדה אופציונלי
פרמטר בכתובת ה-URL של Google Shopping שמפעיל סינון אופציונלי של וריאנטים של מוצר;
דוגמה:Eg4iBWNvbG9yKgV3aGl0ZRISIgxwYWNrYWdlIHNpemUqAjE0EgoiBHNpemUqAnhs - seסוג: string | null
_domain דומיין מנוע החיפוש
שדה אופציונלי
אנחנו בוחרים את דומיין מנוע החיפוש המתאים אוטומטית לפי המיקום והשפה שציינת
עם זאת, אפשר להגדיר דומיין מנוע חיפוש מותאם בשדה הזה
דוגמה:google.co.uk,google.com.au,google.deוכו'. - tagסוג: string | null
מזהה משימה מוגדר על ידי המשתמש
שדה אופציונלי
מגבלת התווים היא 255
אפשר להשתמש בפרמטר הזה כדי לזהות את המשימה ולהתאים אותה לתוצאה
את ערך ה-tagשציינתם תמצאו באובייקטdataשל התגובה
- סוג: object | null · Response36Afe1097B20_MerchantGoogleSellersTaskPostResponseInfo200
- סוג: number | null פורמט: doublecost
סך עלות המשימות, בדולר ארה״ב
- סוג: integer | nullstatus
_code קוד סטטוס כללי את הרשימה המלאה של קודי התגובה אפשר למצוא כאן
- סוג: string | nullstatus
_message הודעה אינפורמטיבית כללית את הרשימה המלאה של ההודעות האינפורמטיביות הכלליות אפשר למצוא כאן
- סוג: array (object | null)[] | nulltasks
מערך משימות
- סוג: object | null · Response36Afe1097B20_MerchantGoogleSellersTaskPostTaskInfo
- costסוג: number | null פורמט: double
סך עלות המשימות, בדולר ארה״ב
- dataסוג: object | null
מכיל את אותם הפרמטרים שציינתם בבקשת POST
- propertyסוג: object | null
Name
- idסוג: string | null
מזהה משימה מזהה משימה ייחודי במערכת שלנו בפורמט UUID
- pathסוג: array (string | null)[] | null
נתיב URL
- resultסוג: object | null
מערך תוצאות
במקרה זה, הערך יהיהnull - resultסוג: integer | null פורמט: int64
_count מספר הפריטים במערך result
- statusסוג: integer | null
_code קוד הסטטוס של המשימה נוצר על ידי DataForSEO ויכול להיות בטווח הבא: 10000-60000 את הרשימה המלאה של קודי התגובה אפשר למצוא כאן
- statusסוג: string | null
_message הודעה אינפורמטיבית של המשימה את הרשימה המלאה של ההודעות האינפורמטיביות הכלליות אפשר למצוא כאן
- timeסוג: string | null
זמן ביצוע, בשניות
- סוג: integer | null פורמט: int64tasks
_count מספר המשימות במערך tasks
- סוג: integer | null פורמט: int64tasks
_error מספר המשימות במערך tasks שהוחזרו עם שגיאה
- סוג: string | nulltime
זמן ביצוע כולל, בשניות
- סוג: string | nullversion
הגרסה הנוכחית של ה-API
application/json - 400
לא ניתן היה לעבד את הבקשה. בדקו את פרמטרי הבקשה.
- 401
נדרש מפתח API תקף של Felo.
- 402
לא ניתן להמשיך את הבקשה משום שדרישת חיוב אינה מתקיימת.
- 403
החשבון אינו מורשה לבצע את הפעולה הזו.
- 429
הגעתם למגבלת בקשות או לתקרת הוצאה.
- 502
השירות לא הצליח להשלים את הבקשה.
- 503
שירות ה-API או החיוב אינו זמין באופן זמני.
- 504
השירות פג בזמן הטיפול בבקשה.
- default
תגובת שגיאה; תגובות מעבר מהמעלה הזרם עשויות להשתמש בפורמטים של הספק
application/json
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
}
]
}