REST Resource: accounts.locations.media.customers

משאב: MediaItem

פריט מדיה יחיד.

ייצוג JSON 
{
  "name": string,
  "mediaFormat": enum (MediaFormat),
  "locationAssociation": {
    object (LocationAssociation)
  },
  "googleUrl": string,
  "thumbnailUrl": string,
  "createTime": string,
  "dimensions": {
    object (Dimensions)
  },
  "insights": {
    object (MediaInsights)
  },
  "attribution": {
    object (Attribution)
  },
  "description": string,

  // Union field data can be only one of the following:
  "sourceUrl": string,
  "dataRef": {
    object (MediaItemDataRef)
  }
  // End of list of possible types for union field data.
}
שדות
name

string

שם המשאב של פריט המדיה הזה. accounts/{accountId}/locations/{locationId}/media/{mediaKey}
mediaFormat

enum (MediaFormat)

הפורמט של פריט המדיה הזה. יש להגדיר אותו בזמן יצירת פריט המדיה, והוא זמין לקריאה בלבד בכל הבקשות האחרות. לא ניתן לעדכן.
locationAssociation

object (LocationAssociation)

נדרש בעת התקשרות אל CreatePhoto. תיאור האופן שבו פריט המדיה הזה מקושר למיקום שלו. הערך צריך להיות קטגוריה (לדוגמה, EXTERIOR) או מזהה של פריט מחירון.

הפעולה הזו נדרשת כשמוסיפים מדיה חדשה למיקום באמצעות media.create. סוגי מדיה אחרים, כמו תמונות בפוסטים מקומיים, לא יהיו זמינים.
googleUrl

string

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

string

פלט בלבד. אם צוינה כתובת ה-URL של תמונה ממוזערת לפריט המדיה הזה,
createTime

string (Timestamp format)

פלט בלבד. מועד היצירה של פריט המדיה הזה.

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
dimensions

object (Dimensions)

פלט בלבד. המימדים (רוחב וגובה) בפיקסלים.
insights

object (MediaInsights)

פלט בלבד. נתונים סטטיסטיים עבור פריט המדיה הזה.
attribution

object (Attribution)

פלט בלבד. נתוני שיוך (Attribution) של פריטי מדיה של לקוחות. עליכם להציג את השיוך הזה כפי שהוא מוצג למשתמשים, ואסור למחוק או לשנות אותו.
description

string

התיאור של פריט המדיה הזה. אי אפשר לשנות תיאורים באמצעות Google My Business API, אבל אפשר להגדיר אותם כשיוצרים פריט מדיה חדש שאינו תמונת שער.

שדה איחוד data. מקור הנתונים של פריט המדיה. כשיוצרים פריט מדיה חדש, יש לספק כתובת URL או קובץ עזר של נתונים.

למעט הקטגוריה PROFILE ו-COVER, כל התמונות צריכות להיות בגודל של לפחות 250 פיקסלים בקצה הקצר, וגודל הקובץ חייב להיות לפחות 10,240 בייטים.

כל התמונות שמעלים צריכות לעמוד בדרישות ההנחיות לגבי תמונות בפרופיל העסק. data יכול להיות רק אחת מהאפשרויות הבאות:
sourceUrl

string

כתובת URL נגישה לכולם שממנה ניתן לאחזר את פריט המדיה.

כשיוצרים את אחד מהפריטים האלה או את אחד משדות ה-dataRef, יש להגדיר את האובייקט כך שיציין את המקור של פריט המדיה.

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

לא ניתן לעדכן את השדה הזה.
dataRef

object (MediaItemDataRef)

קלט בלבד. הפניה לנתונים בינאריים של פריט מדיה כפי שהתקבלו באמצעות השיטה media.startUpload.

כשיוצרים פריט מדיה,

sourceUrl

או

dataRef

חייב להגדיר.

שיטות

get

 מחזירה מטא-נתונים של פריט המדיה שהלקוח ביקש.

list

 הפונקציה מחזירה רשימה של פריטי מדיה שמשויכים למיקום שתרמו על ידי לקוחות.