REST Resource: albums
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
المورد: الألبوم
تمثيل لألبوم في "صور Google" الألبومات هي حاويات لملفات الوسائط. إذا شارك التطبيق ألبومًا، سيحتوي على سمة shareInfo إضافية.
| تمثيل JSON |
{
"id": string,
"title": string,
"productUrl": string,
"isWriteable": boolean,
"shareInfo": {
object (ShareInfo)
},
"mediaItemsCount": string,
"coverPhotoBaseUrl": string,
"coverPhotoMediaItemId": string
} |
| الحقول |
id |
string
معرّف الألبوم هذا معرّف دائم يمكن استخدامه بين الجلسات لتحديد هذا الألبوم.
|
title |
string
اسم الألبوم الذي يظهر للمستخدم في حسابه على "صور Google" يجب ألا يزيد طول هذه السلسلة عن 500 حرف.
|
productUrl |
string
[إخراج فقط] عنوان URL الخاص بالألبوم في "صور Google" يجب أن يكون المستخدم مسجّلاً الدخول إلى حسابه على "صور Google" للوصول إلى هذا الرابط.
|
isWriteable |
boolean
[إخراج فقط] صحيح إذا كان بإمكانك إنشاء عناصر وسائط في هذا الألبوم. يستند هذا الحقل إلى النطاقات الممنوحة وأذونات الألبوم. في حال تغيير النطاقات أو أذونات الألبوم، يتم تعديل هذا الحقل.
|
shareInfo |
object (ShareInfo)
[الإخراج فقط] معلومات متعلقة بالألبومات المشتركة لا تتم تعبئة هذا الحقل إلا إذا كان الألبوم مشترَكًا، وكان المطوِّر قد أنشأ الألبوم ومنح المستخدم نطاق photoslibrary.sharing.
|
mediaItemsCount |
string (int64 format)
[للإخراج فقط] عدد عناصر الوسائط في الألبوم
|
coverPhotoBaseUrl |
string
[للإخراج فقط] عنوان URL لوحدات البايت الخاصة بالصورة الرئيسية يجب عدم استخدام هذا العنوان كما هو. يجب إلحاق المَعلمات بهذا عنوان URL قبل استخدامه. اطّلِع على مستندات المطوّرين للحصول على قائمة كاملة بالمَعلمات المتاحة. على سبيل المثال، تضبط '=w2048-h1024' سمات صورة الغلاف ليكون عرضها 2048 بكسل وارتفاعها 1024 بكسل.
|
coverPhotoMediaItemId |
string
معرّف لعنصر الوسائط المرتبط بصورة الغلاف
|
ShareInfo
معلومات عن الألبومات التي تتم مشاركتها ولا يتم تضمين هذه المعلومات إلا إذا أنشأت الألبوم وتمّت مشاركته وكان لديك نطاق المشاركة.
| تمثيل JSON |
{
"sharedAlbumOptions": {
object (SharedAlbumOptions)
},
"shareableUrl": string,
"shareToken": string,
"isJoined": boolean,
"isOwned": boolean,
"isJoinable": boolean
} |
| الحقول |
sharedAlbumOptions |
object (SharedAlbumOptions)
الخيارات التي تتحكّم في إمكانية إضافة مستخدم إلى ألبوم مشترَك أو التعليق عليه
|
shareableUrl |
string
رابط يؤدي إلى ألبوم "صور Google" المشترَك يمكن لأي مستخدم لديه الرابط الاطّلاع على محتوى الألبوم، لذا يجب التعامل معه بحذر. لا يتم عرض المَعلمة shareableUrl إلا إذا كانت ميزة "المشاركة باستخدام رابط" مفعّلة في الألبوم. إذا كان المستخدم قد انضم إلى ألبوم لم تتم مشاركته باستخدام رابط، يمكنه استخدام رمز productUrl الخاص بالألبوم للوصول إليه بدلاً من ذلك. يتم إلغاء صلاحية shareableUrl إذا أوقف المالك ميزة "مشاركة الرابط" في تطبيق "صور Google"، أو إذا تم إلغاء مشاركة الألبوم.
|
shareToken |
string
رمز مميّز يُستخدَم للانضمام إلى ألبوم مشترَك أو مغادرته أو استرداد تفاصيله بالنيابة عن مستخدم ليس مالكًا له. يتم إلغاء صلاحية shareToken إذا أوقف المالك ميزة "مشاركة الرابط" في تطبيق "صور Google"، أو إذا تم إلغاء مشاركة الألبوم.
|
isJoined |
boolean
صحيح إذا كان المستخدم قد انضم إلى الألبوم. وينطبق ذلك دائمًا على مالك الألبوم.
|
isOwned |
boolean
صحيح إذا كان المستخدم يملك الألبوم.
|
isJoinable |
boolean
صحيح إذا كان بإمكان المستخدمين الانضمام إلى الألبوم.
|
SharedAlbumOptions
الخيارات التي تتحكّم في مشاركة ألبوم
| تمثيل JSON |
{
"isCollaborative": boolean,
"isCommentable": boolean
} |
| الحقول |
isCollaborative |
boolean
صحيح إذا كان الألبوم المشترَك يسمح للمتعاونين (المستخدمين الذين انضموا إلى الألبوم) بإضافة عناصر وسائط إليه. القيمة التلقائية هي false.
|
الطُرق |
|
|
تُضيف ميزة "تحسين المحتوى" معلومات في موضع محدّد في ألبوم تم إنشاؤه من خلال تطبيق. |
|
|
تضيف هذه الإذنات عنصر وسائط واحدًا أو أكثر أنشأه التطبيق في مكتبة "صور Google" الخاصة بالمستخدم إلى ألبوم أنشأه التطبيق. |
|
|
تزيل هذه العملية ملف وسائط واحدًا أو أكثر أنشأه التطبيق من ألبوم محدّد أنشأه التطبيق. |
|
|
يتيح هذا الإذن إنشاء ألبوم في مكتبة "صور Google" الخاصة بالمستخدم. |
|
|
لعرض الألبوم الذي أنشأه التطبيق استنادًا إلى albumId المحدّد. |
|
|
تعرض هذه السمة قائمة بجميع الألبومات التي أنشأها تطبيقك. |
|
|
عدِّل الألبوم الذي أنشأه التطبيق باستخدام id المحدّد. |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eGoogle Photos Albums are containers for media items and can be shared with others.\u003c/p\u003e\n"],["\u003cp\u003eShared albums have properties controlling adding media and comments, along with shareable links and tokens.\u003c/p\u003e\n"],["\u003cp\u003eAlbums include metadata such as title, product URL, cover photo, and media item count.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can programmatically manage albums using various methods like create, get, list, and update.\u003c/p\u003e\n"],["\u003cp\u003eSome album management method scopes are subject to removal or change.\u003c/p\u003e\n"]]],["Google Photos albums, serving as media containers, include properties like `id`, `title`, and `productUrl`. Shared albums have `shareInfo`, which contains a `shareableUrl`, `shareToken`, and booleans for user interaction (`isJoined`, `isOwned`, `isJoinable`). Sharing options (`SharedAlbumOptions`) determine collaboration (`isCollaborative`) and commenting (`isCommentable`). Methods for albums include adding/removing media, creating, retrieving, updating (patching), and managing sharing (share/unshare, which will stop working after March 31, 2025).\n"],null,[]]
