משאב: MediaItem
פריט מדיה אחד.
ייצוג JSON | |
---|---|
{ "name": string, "mediaFormat": enum ( |
שדות | ||
---|---|---|
name |
שם המשאב של פריט המדיה הזה. |
|
mediaFormat |
הפורמט של פריט המדיה הזה. חייבת להיות מוגדרת כשפריט המדיה נוצר, והיא תהיה לקריאה בלבד בכל שאר הבקשות. לא ניתן לעדכן. |
|
locationAssociation |
חובה כשמתקשרים אל הפעולה הזו נדרשת כשמוסיפים מדיה חדשה למיקום עם |
|
googleUrl |
פלט בלבד. כתובת URL שמתארחת ב-Google עבור פריט המדיה הזה. כתובת ה-URL הזו אינה סטטית כי היא עשויה להשתנות עם הזמן. עבור וידאו זו תהיה תמונת תצוגה מקדימה עם סמל הפעלה בשכבת-על. |
|
thumbnailUrl |
פלט בלבד. אם סופקה, כתובת ה-URL של תמונה ממוזערת של פריט המדיה הזה. |
|
createTime |
פלט בלבד. שעת היצירה של פריט המדיה הזה. חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
|
dimensions |
פלט בלבד. המידות (רוחב וגובה) בפיקסלים. |
|
insights |
פלט בלבד. נתונים סטטיסטיים עבור פריט המדיה הזה. |
|
attribution |
פלט בלבד. פרטי שיוך של פריטי מדיה של לקוחות. עליכם להציג את השיוך כפי שסופק למשתמשים, ואין למחוק או לשנות את השיוך. |
|
description |
התיאור של פריט המדיה הזה. אי אפשר לשנות תיאורים דרך Google My Business API, אבל אפשר להגדיר אותם כשיוצרים פריט מדיה חדש שאינו תמונת שער. |
|
שדה איחוד למעט קטגוריות כל התמונות שמעלים צריכות לעמוד בהנחיות להעלאת תמונות של 'פרופיל העסק ב-Google'. הערך של |
||
sourceUrl |
כתובת URL נגישה לכולם שממנה ניתן לאחזר את פריט המדיה. כשיוצרים את אחד מהפריטים האלה או את dataRef, צריך להגדיר את המקור של פריט המדיה. אם נעשה שימוש ב- אי אפשר לעדכן את השדה הזה. |
|
dataRef |
קלט בלבד. הפניה לנתונים בינאריים של פריט מדיה כפי שהתקבלו באמצעות השיטה בעת יצירת פריט מדיה,
או
חייב להיות מוגדר. |
MediaItemDataRef
הפניה לנתונים הבינאריים של התמונות של MediaItem
שהועלו באמצעות Google My Business API.
צריך ליצור מאגר נתונים באמצעות media.startUpload
ולהשתמש בהפניה הזו כשמעלים בייטים ל-[media.upload] ואז קריאה ל-media.create
.
ייצוג JSON | |
---|---|
{ "resourceName": string } |
שדות | |
---|---|
resourceName |
המזהה הייחודי של הנתונים הבינאריים של פריט המדיה הזה. הנתונים משמשים להעלאת נתוני התמונות באמצעות [media.upload] ובעת יצירת פריט מדיה חדש מהבייטים האלה באמצעות דוגמה להעלאת בייטים: לשיחות |
MediaFormat
Enum לפורמט מדיה.
טיפוסים בני מנייה (enums) | |
---|---|
MEDIA_FORMAT_UNSPECIFIED |
הפורמט לא צוין. |
PHOTO |
פריט המדיה הוא תמונה. בגרסה הזו יש תמיכה רק בתמונות. |
VIDEO |
פריט המדיה הוא סרטון. |
LocationAssociation
האופן שבו פריט המדיה משויך למיקום שלו.
ייצוג JSON | |
---|---|
{ // Union field |
שדות | ||
---|---|---|
שדה איחוד location_attachment_type . המדיה של המיקום צריכה לכלול קטגוריה או מזהה של פריט מחירון שאליו היא משויכת. מדיה שלא מבוססת על מיקום (לדוגמה, תמונות של פוסטים מקומיים) לא יכולה לכלול אף אחת מהן. הערך של location_attachment_type יכול להיות רק אחת מהאפשרויות הבאות: |
||
category |
הקטגוריה שאליה שייכת תמונת המיקום הזו. |
|
priceListItemId |
המזהה של פריט מחירון שאליו משויכת תמונת המיקום הזו. |
קטגוריה
טיפוסים בני מנייה (enum) לקטגוריית פריט מדיה.
טיפוסים בני מנייה (enums) | |
---|---|
CATEGORY_UNSPECIFIED |
הקטגוריה לא צוינה. |
COVER |
תמונת השער. למיקום יש רק תמונת שער אחת. |
PROFILE |
תמונת פרופיל. למיקום יש תמונת פרופיל אחת בלבד. |
LOGO |
תמונת לוגו. |
EXTERIOR |
מדיה חיצונית. |
INTERIOR |
מדיה פנימית. |
PRODUCT |
מדיה של המוצר. |
AT_WORK |
מדיה בעבודה. |
FOOD_AND_DRINK |
מדיה של מזון ומשקאות. |
MENU |
מדיה בתפריט. |
COMMON_AREA |
מדיה ציבורית. |
ROOMS |
מדיה של חדרים. |
TEAMS |
מדיה של Teams. |
ADDITIONAL |
מדיה נוספת, ללא שיוך לקטגוריה. |
מאפיינים
מידות של פריט המדיה.
ייצוג JSON | |
---|---|
{ "widthPixels": integer, "heightPixels": integer } |
שדות | |
---|---|
widthPixels |
הרוחב של פריט המדיה, בפיקסלים. |
heightPixels |
הגובה של פריט המדיה, בפיקסלים. |
MediaInsights
תובנות ונתונים סטטיסטיים לגבי פריט המדיה.
ייצוג JSON | |
---|---|
{ "viewCount": string } |
שדות | |
---|---|
viewCount |
פלט בלבד. מספר הפעמים שבהן פריט המדיה נצפה. |
שיוך (Attribution)
פרטי שיוך של פריטי מדיה של לקוחות, כמו שם השותף ותמונת הפרופיל.
ייצוג JSON | |
---|---|
{ "profileName": string, "profilePhotoUrl": string, "takedownUrl": string, "profileUrl": string } |
שדות | |
---|---|
profileName |
שם המשתמש שאליו יש לשייך את פריט המדיה. |
profilePhotoUrl |
כתובת ה-URL של תמונת הפרופיל של המשתמש המשויך. |
takedownUrl |
כתובת ה-URL של דף ההסרה, שבו ניתן לדווח על פריט המדיה אם הוא בלתי הולם. |
profileUrl |
כתובת ה-URL של דף הפרופיל של המשתמש המשויך במפות Google. |
שיטות |
|
---|---|
|
יצירת פריט מדיה חדש למיקום. |
|
מחיקת פריט המדיה שצוין. |
|
מחזירה מטא-נתונים של פריט המדיה המבוקש. |
|
מחזירה רשימה של פריטי מדיה שמשויכים למיקום מסוים. |
|
עדכון המטא-נתונים של פריט המדיה שצוין. |
|
יוצר MediaItemDataRef להעלאת פריט מדיה. |