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 חתום לטווח קצר למדיה בפריסה לאורך.