REST Resource: sharedAlbums

משאב: אלבום

ייצוג של אלבום ב-Google Photos. אלבומים הם מאגרים של פריטי מדיה. אם האפליקציה שיתפה אלבום, הוא מכיל מאפיין shareInfo נוסף.

ייצוג JSON
{
  "id": string,
  "title": string,
  "productUrl": string,
  "isWriteable": boolean,
  "shareInfo": {
    object (ShareInfo)
  },
  "mediaItemsCount": string,
  "coverPhotoBaseUrl": string,
  "coverPhotoMediaItemId": string
}
שדות
id

string

מזהה האלבום. זהו מזהה קבוע שיכול לשמש לזיהוי האלבום הזה בין סשנים.

title

string

שם האלבום שמוצג למשתמשים בחשבון Google Photos. המחרוזת צריכה להיות באורך 500 תווים לכל היותר.

productUrl

string

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

isWriteable

boolean

[פלט בלבד] True אם אפשר ליצור פריטי מדיה באלבום הזה. השדה הזה מבוסס על היקף ההרשאות שניתנו לאלבום ועל ההרשאות שלו. אם ההיקפים של האלבום השתנו או אם ההרשאות של האלבום השתנו, השדה הזה יתעדכן.

shareInfo

object (ShareInfo)

[פלט בלבד] מידע שקשור לאלבומים משותפים. השדה הזה יאוכלס רק אם האלבום הוא אלבום משותף, המפתח יצר את האלבום והמשתמש אישר את ההיקף photoslibrary.sharing.

mediaItemsCount

string (int64 format)

[פלט בלבד] מספר פריטי המדיה באלבום.

coverPhotoBaseUrl

string

[פלט בלבד] כתובת URL לבייטים של תמונת השער. אין להשתמש בשם הזה. צריך להוסיף פרמטרים לכתובת ה-URL הזו לפני השימוש. כדי לקבל רשימה מלאה של הפרמטרים הנתמכים, אפשר לעיין בתיעוד למפתחים. לדוגמה, '=w2048-h1024' מגדיר את המידות של תמונת השער כך שיהיו ברוחב של 2048 פיקסלים ובגובה של 1024 פיקסלים.

coverPhotoMediaItemId

string

מזהה של פריט המדיה שמשויך לתמונת השער.

שיטות

get

מחזירה את האלבום על סמך shareToken שצוין.

join

הצטרפות לאלבום משותף בשם המשתמש ב-Google Photos.

leave

עזיבת אלבום משותף שכבר הצטרפתם אליו בשם המשתמש ב-Google Photos.

list

כאן רשומים כל האלבומים המשותפים שזמינים בכרטיסייה 'שיתוף' באפליקציית Google Photos של המשתמש.