أنت تعرض المستندات القديمة لواجهة برمجة التطبيقات Google Photos Library API.
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
[الإخراج فقط] True إذا كان بإمكانك إنشاء عناصر وسائط في هذا الألبوم. يستند هذا الحقل إلى النطاقات الممنوحة وأذونات الألبوم. وفي حال تغيير النطاقات أو تغيير أذونات الألبوم، يتم تعديل هذا الحقل.
|
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
True إذا كان المستخدم انضم إلى الألبوم. وينطبق هذا الأمر دائمًا على مالك الألبوم.
|
isOwned |
boolean
True إذا كان المستخدم يمتلك الألبوم.
|
isJoinable |
boolean
True إذا كان يمكن للمستخدمين ضم الألبوم.
|
SharedAlbumOptions
الخيارات التي تتحكّم في مشاركة ألبوم
| تمثيل JSON |
{
"isCollaborative": boolean,
"isCommentable": boolean
} |
| الحقول |
isCollaborative |
boolean
True إذا كان الألبوم المشترك يسمح للمتعاونين (المستخدمون الذين انضموا إلى الألبوم) بإضافة عناصر الوسائط إليه. وتكون القيمة التلقائية على "خطأ".
|
الطُرق |
|
|
يضيف قيمة إضافية في موضع محدد في ألبوم محدد. |
|
|
لإضافة عنصر وسائط واحد أو أكثر في مكتبة "صور Google" لدى المستخدم إلى ألبوم |
|
|
لإزالة عنصر وسائط واحد أو أكثر من ألبوم محدّد. |
|
|
ينشئ ألبومًا في مكتبة "صور Google" للمستخدم. |
|
|
عرض الألبوم استنادًا إلى albumId المحدد. |
|
|
يسرد جميع الألبومات التي تظهر لمستخدم في علامة التبويب "الألبومات" في تطبيق "صور Google". |
|
|
تعديل الألبوم باستخدام السمة id المحددة |
|
|
وضع علامة على ألبوم على أنّه مشترَك ويمكن للمستخدمين الآخرين الوصول إليه |
|
|
يضع علامة على ألبوم تمت مشاركته سابقًا باعتباره خاصًا. |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-09-12 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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 (حسب التوقيت العالمي المتفَّق عليه)"],[[["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."]]],[]]
