Method: videos.lookupVideo

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

בקשת HTTP

GET https://aerialview.googleapis.com/v1/videos:lookupVideo

בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.

פרמטרים של שאילתה

פרמטרים
פרמטר איחוד key. חובה. מפתח המשמש לחיפוש סרטון. הערך של key יכול להיות רק אחת מהאפשרויות הבאות:
videoId

string

הוחזר מזהה מ-videos.renderVideo.
address

string

כתובת למשלוח דואר בארה"ב.

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התגובה

אובייקט שכולל את כל הנתונים לגבי הסרטון.

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:

ייצוג JSON 
{
  "uris": {
    string: {
      object (Uris)
    },
    ...
  },
  "state": enum (State),
  "metadata": {
    object (VideoMetadata)
  }
}
שדות
uris

map (key: string, value: object (Uris))

מיפוי של סוגי מדיה למזהי ה-URI שלהם. השדה הזה נכלל רק ב-ACTIVE סרטונים. המפתח הוא ערך טיפוסים בני מנייה (enum) מ-MediaFormat.

אובייקט שמכיל רשימה של "key": value זוגות. דוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }
state

enum (State)

המצב הנוכחי של בקשת העיבוד.
metadata

object (VideoMetadata)

מכיל את המטא-נתונים של הסרטון, שמוגדר רק אם המצב הוא ACTIVE.

אוריס

מכיל את כל רכיבי ה-URI של פורמט וידאו נתון.

ייצוג JSON 
{
  "landscapeUri": string,
  "portraitUri": string
}
שדות
landscapeUri

string

URI חתום לטווח קצר של המדיה בכיוון לרוחב.
portraitUri

string

URI חתום לטווח קצר של המדיה בתצוגה לאורך.