מוצג לך תיעוד של הגרסה הקודמת של Google Photos Library API.
REST Resource: albums
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
משאב: אלבום
ייצוג של אלבום ב-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
מזהה של פריט המדיה שמשויך לתמונת השער.
|
ShareInfo
מידע על האלבומים המשותפים. אפשר לכלול את המידע הזה רק אם אתם יצרתם את האלבום, אם הוא משותף ויש לכם הרשאות שיתוף.
| ייצוג ב-JSON |
{
"sharedAlbumOptions": {
object (SharedAlbumOptions)
},
"shareableUrl": string,
"shareToken": string,
"isJoined": boolean,
"isOwned": boolean,
"isJoinable": boolean
} |
| שדות |
sharedAlbumOptions |
object (SharedAlbumOptions)
אפשרויות שקובעים אם אנשים יוכלו להוסיף תמונות לאלבום משותף או להגיב עליו.
|
shareableUrl |
string
קישור לאלבום המשותף ב-Google Photos. כל מי שיש לו את הקישור יכול לצפות בתוכן של האלבום, לכן חשוב להיזהר. הפרמטר shareableUrl מוחזר רק אם שיתוף באמצעות קישור מופעל באלבום. אם משתמש מסוים כבר הצטרף לאלבום שלא שותף באמצעות קישור, הוא יכול להשתמש בproductUrl של האלבום כדי להיכנס אליו. shareableUrl לא תקף אם הבעלים השבית את השיתוף באמצעות קישור באפליקציית Google Photos או אם השיתוף של האלבום בוטל.
|
shareToken |
string
אסימון שמשמש להצטרפות לאלבום משותף, ליציאה ממנו או לאחזור הפרטים שלו בשם משתמש שאינו הבעלים. shareToken לא תקף אם הבעלים השבית את השיתוף באמצעות קישור באפליקציית Google Photos או אם השיתוף של האלבום בוטל.
|
isJoined |
boolean
הערך True אם המשתמש הצטרף לאלבום. זה תמיד נכון לגבי הבעלים של האלבום.
|
isOwned |
boolean
True אם האלבום הוא בבעלות המשתמש.
|
isJoinable |
boolean
הערך הוא True אם משתמשים יכולים להצטרף לאלבום.
|
SharedAlbumOptions
אפשרויות השיתוף של אלבום.
| ייצוג JSON |
{
"isCollaborative": boolean,
"isCommentable": boolean
} |
| שדות |
isCollaborative |
boolean
הערך הוא True אם האלבום המשותף מאפשר לשותפי עריכה (משתמשים שהצטרפו לאלבום) להוסיף אליו פריטי מדיה. ברירת המחדל היא False.
|
שיטות |
|
|
הוספת העשרה במיקום מוגדר באלבום מוגדר. |
|
|
הוספת פריט מדיה אחד או יותר בספרייה של המשתמש ב-Google Photos לאלבום. |
|
|
הסרת פריט מדיה אחד או יותר מאלבום מסוים. |
|
|
יצירת אלבום בספריית Google Photos של משתמש. |
|
|
הפונקציה מחזירה את האלבום לפי הערך שצוין בשדה albumId. |
|
|
רשימה של כל האלבומים שמוצגים למשתמש בכרטיסייה 'אלבומים' באפליקציית Google Photos. |
|
|
מעדכנים את האלבום עם id שצוין. |
|
|
מסמנת את האלבום כאלבום משותף ונגיש למשתמשים אחרים. |
|
|
סימון אלבום ששיתפתם בעבר כפרטי. |
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2024-09-12 (שעון UTC).
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2024-09-12 (שעון UTC)."],[[["The Album resource represents albums in Google Photos, acting as containers for media items and including share information for shared albums."],["Albums have properties like ID, title, product URL, writeability, share details, media item count, and cover photo information."],["Shared albums have options to control collaboration (adding media) and commenting, along with shareable URLs and tokens for access."],["Developers can use various methods to manage albums, including creating, getting, listing, updating, adding/removing media, sharing, and unsharing."],["ShareInfo and SharedAlbumOptions objects provide further details about shared album configurations and access control."]]],[]]
