מאחזר סרטון לפי הכתובת או מזהה הווידאו שלו. התגובה תהיה סרטון עם קבוצת מזהי URI של הפעלה לסרטונים פעילים, מצב 'עיבוד' לסרטונים בהמתנה, או שגיאת 404 אם הסרטון לא קיים. קבלת סרטון היא אירוע לחיוב, ולכן המתקשרים בשיטה הזו צריכים להיות מוכנים להשתמש במזהי ה-URI שהוחזרו בזמן הבקשה.
בקשת HTTP
GET https://aerialview.googleapis.com/v1/videos:lookupVideo
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
פרמטרים של שאילתה
פרמטרים | |
---|---|
פרמטר איחוד key . חובה. מפתח המשמש לחיפוש סרטון. הערך של key יכול להיות רק אחת מהאפשרויות הבאות: |
|
videoId |
הוחזר מזהה מ- |
address |
כתובת למשלוח דואר בארה"ב. |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התגובה
אובייקט שכולל את כל הנתונים לגבי הסרטון.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:
ייצוג JSON |
---|
{ "uris": { string: { object ( |
שדות | |
---|---|
uris |
מיפוי של סוגי מדיה למזהי ה-URI שלהם. השדה הזה נכלל רק ב- אובייקט שמכיל רשימה של |
state |
המצב הנוכחי של בקשת העיבוד. |
metadata |
מכיל את המטא-נתונים של הסרטון, שמוגדר רק אם המצב הוא |
אוריס
מכיל את כל רכיבי ה-URI של פורמט וידאו נתון.
ייצוג JSON |
---|
{ "landscapeUri": string, "portraitUri": string } |
שדות | |
---|---|
landscapeUri |
URI חתום לטווח קצר של המדיה בכיוון לרוחב. |
portraitUri |
URI חתום לטווח קצר של המדיה בתצוגה לאורך. |