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

صحيح إذا كان بإمكان المستخدمين الانضمام إلى الألبوم.

SharedAlbumOptions

الخيارات التي تتحكّم في مشاركة ألبوم

تمثيل JSON 
{
  "isCollaborative": boolean,
  "isCommentable": boolean
}
الحقول
isCollaborative

boolean

صحيح إذا كان الألبوم المشترَك يسمح للمتعاونين (المستخدمين الذين انضموا إلى الألبوم) بإضافة عناصر وسائط إليه. وتكون القيمة التلقائية على "خطأ".
isCommentable

boolean

True إذا كان الألبوم المشترك يسمح للمتعاونين (المستخدمون الذين انضموا إلى الألبوم) بإضافة تعليقات على الألبوم. وتكون القيمة التلقائية على "خطأ".

الطُرق

addEnrichment

batchAddMediaItems

batchRemoveMediaItems

create

get

list

patch

 عدِّل الألبوم باستخدام id المحدّد.

share

unshare