v0.2.0-beta

OpenAPI 3.1.0

הגדרת משימות כתוביות YouTube

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/serp/youtube/video_subtitles/task_post

הגדרת משימות כתוביות YouTube

מכניס לתור מסלול כתוביות של סרטון YouTube אחד ב-YouTube, ומחזיר id של משימה ב-tasks[0].id. עטוף במעטפת של DataForSEO: הנתונים ב-tasks[0].result, והתוצאה ב-tasks[0].status_code — בקשה שנדחתה עדיין מחזירה HTTP 200. התאום החי עונה מיד ופשוט יותר לשאילתה בודדת; השתמשו בתור כשהאצווה תארך יותר מקריאת כלי.

מראה תמחור

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

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

גוף

application/json

סוג: array (object | null)[]
- device
  סוג: string | null
  
  סוג המכשיר שדה אופציונלי הערך היחיד: desktop
- language_code
  סוג: string | null
  
  קוד שפת מנוע החיפוש שדה חובה אם לא מציינים language_name אם משתמשים בשדה הזה, אין צורך לציין language_name אפשר לקבל את רשימת השפות הזמינות של מנוע החיפוש עם language_code שלהן על ידי שליחת בקשה נפרדת אל https://api.dataforseo.com/v3/serp/youtube/languages דוגמה: en
- language_name
  סוג: string | null
  
  השם המלא של שפת מנוע החיפוש שדה חובה אם לא מציינים language_code אם משתמשים בשדה הזה, אין צורך לציין language_code אפשר לקבל את רשימת השפות הזמינות של מנוע החיפוש עם language_name שלהן על ידי שליחת בקשה נפרדת אל https://api.dataforseo.com/v3/serp/youtube/languages דוגמה: English
- location_code
  סוג: integer | null
  
  קוד מיקום מנוע החיפוש שדה חובה אם לא מציינים location_name אם משתמשים בשדה הזה, אין צורך לציין location_name אפשר לקבל את רשימת המיקומים הזמינים של מנועי החיפוש עם location_code שלהם על ידי שליחת בקשה נפרדת אל https://api.dataforseo.com/v3/serp/youtube/locations דוגמה: 2840
- location_name
  סוג: string | null
  
  השם המלא של מיקום מנוע החיפוש שדה חובה אם לא מציינים location_code אם משתמשים בשדה הזה, אין צורך לציין location_code אפשר לקבל את רשימת המיקומים הזמינים של מנוע החיפוש עם location_name שלהם על ידי שליחת בקשה נפרדת אל https://api.dataforseo.com/v3/serp/youtube/locations דוגמה: United States
- os
  סוג: string | null
  
  מערכת ההפעלה של המכשיר שדה אופציונלי בחרו מבין הערכים הבאים: windows, macos ערך ברירת מחדל: windows
- pingback_url
  סוג: string | null
  
  כתובת URL להתראה על השלמת משימה שדה אופציונלי כשהמשימה תושלם, נודיע לכם באמצעות בקשת GET שתישלח לכתובת ה-URL שציינתם אפשר להשתמש במחרוזת ‘$id’ כמשתנה $id וב-‘$tag’ כמשתנה $tag מקודד ב-urlencoded. נעדכן את הערכים הנדרשים לפני שליחת הבקשה. דוגמה: http://your-server.com/pingscript?id=$id http://your-server.com/pingscript?id=$id&tag=$tag הערה: תווים מיוחדים ב-pingback_url יקודדו ב-urlencoded; לדוגמה, התו # יקודד ל-%23 מידע נוסף במרכז העזרה
- postback_data
  סוג: string | null
  
  סוג הנתונים של postback_url שדה חובה אם מציינים postback_url מתאים לסוג הנתונים שיישלח לשרת שלכם ערך אפשרי: advanced
- postback_url
  סוג: string | null
  
  כתובת URL להחזרת תוצאות המשימה שדה אופציונלי כשהמשימה תושלם, נשלח בקשת POST עם התוצאות שלה דחוסות בפורמט gzip אל postback_url שציינתם אפשר להשתמש במחרוזת ‘$id’ כמשתנה $id וב-‘$tag’ כמשתנה $tag מקודד ב-urlencoded. נעדכן את הערכים הנדרשים לפני שליחת הבקשה. דוגמה: http://your-server.com/postbackscript?id=$id http://your-server.com/postbackscript?id=$id&tag=$tag הערה: תווים מיוחדים ב-postback_url יקודדו ב-urlencoded; לדוגמה, התו # יקודד ל-%23 מידע נוסף במרכז העזרה
- priority
  סוג: integer | null
  
  עדיפות המשימה שדה אופציונלי יכול לקבל את הערכים הבאים: 1 – עדיפות ביצוע רגילה (מוגדרת כברירת מחדל) 2 – עדיפות ביצוע גבוהה תחויבו בתשלום נוסף עבור משימות בעדיפות ביצוע גבוהה. אפשר לחשב את העלות בעמוד התמחור.
- subtitles_language
  סוג: string | null
  
  קוד השפה של הטקסט המקורי אפשר לקבל את קוד השפה מתוצאת YouTube Video Info
- subtitles_translate_language
  סוג: string | null
  
  קוד השפה של הטקסט המתורגם ערכים אפשריים: "az", "ay", "ak", "sq", "am", "en", "ar", "hy", "as", "af", "eu", "be", "bn", "my", "bg", "bs", "bho", "cy", "hu", "vi", "haw", "ht", "gl", "lg", "el", "ka", "gn", "gu", "gd", "da", "fy", "zu", "iw", "ig", "yi", "id", "ga", "is", "es", "it", "yo", "kk", "kn", "ca", "qu", "rw", "ky", "zh-Hant", "zh-Hans", "ko", "co", "xh", "ku", "km", "lo", "la", "lv", "ln", "lt", "lb", "mk", "mg", "ms", "ml", "dv", "mt", "mi", "mr", "mn", "und", "de", "ne", "nl", "no", "ny", "or", "om", "pa", "fa", "pl", "pt", "ps", "ro", "ru", "sm", "sa", "ceb", "nso", "sr", "si", "sd", "sk", "sl", "so", "sw", "su", "tg", "th", "ta", "tt", "te", "ti", "ts", "tr", "tk", "uz", "ug", "uk", "ur", "fil", "fi", "fr", "ha", "hi", "hmn", "hr", "cs", "sv", "sn", "ee", "eo", "et", "st", "jv", "ja", "kri"
- tag
  סוג: string | null
  
  מזהה משימה מוגדר על ידי המשתמש שדה אופציונלי מגבלת התווים היא 255 אפשר להשתמש בפרמטר הזה כדי לזהות את המשימה ולהתאים אותה לתוצאה את ערך tag שציינתם תמצאו באובייקט data של התגובה
- video_id
  סוג: string
  
  מזהה הסרטון שדה חובה אפשר למצוא את מזהה הסרטון בכתובת ה-URL או בפריט 'youtube_video' בתוצאת YouTube Organic דוגמה: Y8Wu4rSNJms

תגובות

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

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

status_code
סוג: integer | null

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

status_message
סוג: string | null

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

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

מערך משימות

סוג: object | null · Response36Afe1097B20_SerpYoutubeVideoSubtitlesTaskPostTaskInfo
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/serp/youtube/video_subtitles/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/youtube/video_subtitles/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "video_id": "Y8Wu4rSNJms"
  }
]'

הצגת סכמה

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

פעולה מוצלחת

הגדרת משימות כתוביות YouTube

אימותRequired

DataForSEO

הגדרת משימות כתוביות YouTube

מראה תמחור