v0.2.0-beta

OpenAPI 3.1.0

הגדרת משימות רשימת אפליקציות Google

Felo API Support

MIT

שרת

https://openapi.felo.ai

ספריות לקוח

Shell Curl

DataForSEO

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

DataForSEO פעולות

post/v1/beta/dataforseo/app_data/google/app_list/task_post

הגדרת משימות רשימת אפליקציות Google

מכניס לתור אחד מהאוספים הנבחרים של Google Play — המובילים בחינם, המובילים בהכנסות, והחמים — שנבחר עם app_collection, ומחזיר id של משימה. depth מגביל עד כמה עמוק לקרוא בטבלת הדירוג. אסינכרוני: השליחה מחזירה id של משימה ב-tasks[0].id, וכלי האחזור מחזיר את התוצאה כשהיא מוכנה. אחזרו עם get_dataforseo_app_google_app_list_fetch. זו תצוגת הדירוג; לחיפוש לפי מילת מפתח השתמשו ב-post_dataforseo_app_google_app_searches_submit.

מראה תמחור

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

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

גוף

application/json

סוג: array (object | null)[]
- age_rating
  סוג: string | null
  
  סינון תוצאות לפי דירוג גיל
  שדה אופציונלי
  אפשר להשתמש בשדה זה כדי לסנן את התוצאות לפי דירוג גיל;
  סוגי סינון אפשריים:
  ages_up_to_5 — החזרת אפליקציות שאושרו לילדים עד גיל 5;
  ages_6_8 — החזרת אפליקציות שאושרו לילדים בגיל 6 עד 8;
  ages_9_12 — החזרת אפליקציות שאושרו לילדים בגיל 9 עד 12;
  כברירת מחדל, ה-API מחזיר אפליקציות לכל הגילאים;
  הערה: המסנן הזה פועל רק יחד עם הפרמטר "category": "family"
- app_category
  סוג: string | null
  
  קטגוריית אפליקציה ב-Google Play
  שדה אופציונלי
  אפשר לסנן את התוצאות לפי קטגוריית אפליקציה;
  דוגמה:
  family;
  אפשר לקבל את הרשימה המלאה של הקטגוריות הזמינות בבקשה נפרדת אל https://api.dataforseo.com/v3/app_data/google/categories
  הערה: אין להשתמש ב-app_category אם הפרמטר app_collection מוגדר ל-featured
- app_collection
  סוג: string
  
  אוסף אפליקציות
  שדה חובה
  אוסף האפליקציות ב-Google Play שממנו ייאספו אפליקציות;
  אפשר לציין את הערכים הבאים:
  featured, topselling_paid, topselling_free, topselling_new_free, topselling_new_paid, topgrossing, movers_shakers
  הערה: אם נבחר featured, אין להשתמש בפרמטר app_category
- depth
  סוג: integer | null
  
  עומק פענוח
  שדה אופציונלי
  מספר האפליקציות שיוחזרו בתגובת ה-API;
  אנו ממליצים בחום להגדיר את עומק הפענוח בכפולות של 100, מפני שהמערכת שלנו מעבדת 100 תוצאות ברצף;
  ערך ברירת מחדל: 100;
  ערך מרבי: 200;
  החשבון שלכם יחויב עבור כל SERP המכיל עד 100 תוצאות;
  הגדרת עומק מעל 100 עשויה לגרום לחיובים נוספים אם מנוע החיפוש מחזיר יותר מ-100 תוצאות;
  אפשר לחשב את העלות בעמוד התמחור.
- language_code
  סוג: string
  
  קוד שפת מנוע החיפוש
  שדה חובה אם לא מצוין language_name
  אם משתמשים בשדה זה, אין צורך לציין language_name
  אפשר לקבל את רשימת השפות הזמינות עם language_code שלהן בבקשה נפרדת אל https://api.dataforseo.com/v3/app_data/google/languages
  דוגמה:
  en
- language_name
  סוג: string
  
  השם המלא של שפת מנוע החיפוש
  שדה חובה אם לא מצוין language_code
  אם משתמשים בשדה זה, אין צורך לציין language_code
  אפשר לקבל את רשימת השפות הזמינות עם language_name בבקשה נפרדת אל https://api.dataforseo.com/v3/app_data/google/languages
  דוגמה:
  English
- location_code
  סוג: integer
  
  קוד מיקום של מנוע החיפוש
  שדה חובה אם לא מצוין location_name
  אם משתמשים בשדה זה, אין צורך לציין location_name
  אפשר לקבל את רשימת המיקומים הזמינים של מנוע החיפוש עם location_code שלהם בבקשה נפרדת אל https://api.dataforseo.com/v3/app_data/google/locations
  דוגמה:
  9061121
- location_name
  סוג: string
  
  השם המלא של מיקום מנוע החיפוש
  שדה חובה אם לא מצוין location_code
  אם משתמשים בשדה זה, אין צורך לציין location_code
  אפשר לקבל את רשימת המיקומים הזמינים של מנוע החיפוש עם location_name בבקשה נפרדת אל https://api.dataforseo.com/v3/app_data/google/locations
  דוגמה:
  West Los Angeles,California,United States
- pingback_url
  סוג: string | null
  
  כתובת 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
  שדה חובה אם מציינים postback_url
  מתאים לסוג הנתונים שיישלח לשרת שלכם
  ערכים אפשריים:
  advanced, html
- postback_url
  סוג: string | null
  
  כתובת 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 | null
  
  עדיפות משימה
  שדה אופציונלי
  יכול לקבל את הערכים הבאים:
  1 – עדיפות ביצוע רגילה (מוגדרת כברירת מחדל)
  2 – עדיפות ביצוע גבוהה. תחויבו בתשלום נוסף עבור משימות בעדיפות ביצוע גבוהה.
  אפשר לחשב את העלות בעמוד התמחור.
- tag
  סוג: string | null
  
  מזהה משימה מוגדר על ידי המשתמש
  שדה אופציונלי
  מגבלת התווים היא 255
  אפשר להשתמש בפרמטר הזה כדי לזהות את המשימה ולהתאים אותה לתוצאה
  את ערך ה-tag שציינתם תמצאו באובייקט data של התגובה

תגובות

200
סוג: object | null · Response36Afe1097B20_AppDataGoogleAppListTaskPostResponseInfo
cost
סוג: number | null פורמט: double

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

status_code
סוג: integer | null

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

status_message
סוג: string | null

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

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

מערך משימות

סוג: object | null · Response36Afe1097B20_AppDataGoogleAppListTaskPostTaskInfo
cost
סוג: number | null פורמט: double

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

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

נדרש מפתח API תקף של Felo.
402

לא ניתן להמשיך את הבקשה משום שדרישת חיוב אינה מתקיימת.
403

החשבון אינו מורשה לבצע את הפעולה הזו.
429

הגעתם למגבלת בקשות או לתקרת הוצאה.
502

השירות לא הצליח להשלים את הבקשה.
503

שירות ה-API או החיוב אינו זמין באופן זמני.
504

השירות פג בזמן הטיפול בבקשה.
default

תגובת שגיאה; תגובות מעבר מהמעלה הזרם עשויות להשתמש בפורמטים של הספק

application/json

post/v1/beta/dataforseo/app_data/google/app_list/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/app_data/google/app_list/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "app_collection": "topselling_free",
    "location_code": 2840,
    "language_code": "en",
    "depth": 100
  }
]'

הצגת סכמה

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

פעולה מוצלחת

הגדרת משימות רשימת אפליקציות Google

אימותRequired

DataForSEO

הגדרת משימות רשימת אפליקציות Google

מראה תמחור