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, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
dimensions

object (Dimensions)

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

object (MediaInsights)

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

object (Attribution)

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

string

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

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

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

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

string

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

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

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

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

object (MediaItemDataRef)

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

בעת יצירת פריט מדיה,

sourceUrl

או

dataRef

חייב להיות מוגדר.

שיטות

get

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

list

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