REST Resource: accounts.locations.media

משאב: 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

חייב להגדיר.

MediaItemDataRef

הפניה לנתונים הבינאריים של תמונות של MediaItem שהועלו באמצעות Google My Business API.

יוצרים קובץ עזר של נתונים באמצעות media.startUpload, ומשתמשים בהפניה הזו כשמעלים בייטים אל [media.upload] ולאחר מכן קוראים ל-media.create.

ייצוג JSON 
{
  "resourceName": string
}
שדות
resourceName

string

המזהה הייחודי של הנתונים הבינאריים של פריט המדיה הזה. הנתונים משמשים להעלאה של נתוני התמונה באמצעות [media.upload] וליצירת פריט מדיה חדש מהבייטים האלה באמצעות media.create.

דוגמה להעלאה של בייטים: curl -X POST -T{path_to_file} "http://mybusiness.googleapis.com/upload/v1/media/{resourceName}?uploadType=media"

לשיחות media.create, צריך להגדיר את האפשרות הזו כ-dataRef MediaItem.

MediaFormat

טיפוסים בני מנייה (enum) לפורמט מדיה.

טיפוסים בני מנייה (enum)
MEDIA_FORMAT_UNSPECIFIED הפורמט לא צוין.
PHOTO פריט המדיה הוא תמונה. בגרסה הזו יש תמיכה רק בתמונות.
VIDEO פריט המדיה הוא סרטון.

LocationAssociation

איך פריט המדיה משויך למיקום שלו.

ייצוג JSON 
{

  // Union field location_attachment_type can be only one of the following:
  "category": enum (Category),
  "priceListItemId": string
  // End of list of possible types for union field location_attachment_type.
}
שדות
שדה איחוד location_attachment_type. המדיה של המיקום צריכה לכלול קטגוריה או מזהה של פריט מחירון שאליו היא משויכת. מדיה שלא מבוססת על מיקום (למשל, תמונות בפוסט מקומי) לא יכולה לכלול אף תמונה. location_attachment_type יכול להיות רק אחת מהאפשרויות הבאות:
category

enum (Category)

הקטגוריה שאליה שייכת תמונת המיקום הזו.
priceListItemId

string

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

קטגוריה

דוגמאות לקטגוריית פריט מדיה.

טיפוסים בני מנייה (enum)
CATEGORY_UNSPECIFIED הקטגוריה לא צוינה.
COVER תמונת השער. למיקום יש רק תמונת שער אחת.
PROFILE תמונת פרופיל. למיקום יש רק תמונת פרופיל אחת.
EXTERIOR מדיה חיצונית.
INTERIOR מדיה פנימית.
PRODUCT מדיה של המוצר.
AT_WORK 'בעבודה' מדיה.
FOOD_AND_DRINK מדיה בנושא מזון ומשקאות.
MENU מדיה בתפריט.
COMMON_AREA מדיה באזור ציבורי.
ROOMS מדיה של חדרים.
TEAMS מדיה בצוותים.
ADDITIONAL מדיה נוספת, ללא שיוך לקטגוריה.

מידות

המידות של פריט המדיה.

ייצוג JSON 
{
  "widthPixels": integer,
  "heightPixels": integer
}
שדות
widthPixels

integer

הרוחב של פריט המדיה, בפיקסלים.
heightPixels

integer

הגובה של פריט המדיה, בפיקסלים.

MediaInsights

תובנות ונתונים סטטיסטיים לגבי פריט המדיה.

ייצוג JSON 
{
  "viewCount": string
}
שדות
viewCount

string (int64 format)

פלט בלבד. מספר הצפיות בפריט המדיה.

שיוך (Attribution)

פרטי השיוך (Attribution) של פריטי מדיה של לקוחות, כמו השם ותמונת הפרופיל של השותף ביצירת התוכן.

ייצוג JSON 
{
  "profileName": string,
  "profilePhotoUrl": string,
  "takedownUrl": string,
  "profileUrl": string
}
שדות
profileName

string

שם המשתמש שאליו רוצים לשייך את פריט המדיה.
profilePhotoUrl

string

כתובת ה-URL של התמונה הממוזערת של תמונת הפרופיל של המשתמש המשויך.
takedownUrl

string

כתובת ה-URL של דף ההסרה, שבו אפשר לדווח על פריט המדיה אם הוא בלתי הולם.
profileUrl

string

כתובת ה-URL של דף הפרופיל של המשתמש המשויך במפות Google.

שיטות

create

 יצירת פריט מדיה חדש עבור המיקום.

delete

 מוחק את פריט המדיה שצוין.

get

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

list

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

patch

 מעדכן מטא-נתונים של פריט המדיה שצוין.

startUpload

 יוצר MediaItemDataRef להעלאה של פריט מדיה.