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' מגדיר את המימדים של תמונת השער כך שיהיו לה רוחב של 2,048 פיקסלים וגובה של 1,024 פיקסלים.

coverPhotoMediaItemId

string

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

שיטות

get

הפונקציה מחזירה את האלבום לפי הערך שצוין בשדה shareToken.

join

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

leave

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

list

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