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

صحيح إذا كان المستخدم قد انضم إلى الألبوم. وينطبق ذلك دائمًا على مالك الألبوم.
isOwned

boolean

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

boolean

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

SharedAlbumOptions

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

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

boolean

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

boolean

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

الطُرق

addEnrichment

 تُضيف ميزة "تحسين" في موضع محدّد في ألبوم محدّد.

batchAddMediaItems

 لإضافة عنصر وسائط واحد أو أكثر في مكتبة "صور Google" لدى مستخدم إلى ألبوم

batchRemoveMediaItems

 تزيل هذه العملية ملف وسائط واحدًا أو أكثر من ألبوم محدّد.

create

 لإنشاء ألبوم في مكتبة "صور Google" الخاصة بالمستخدم

get

 لعرض الألبوم استنادًا إلى albumId المحدّد.

list

 يسرد جميع الألبومات التي تظهر لمستخدم في علامة التبويب "الألبومات" في تطبيق "صور Google".

patch

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

share

 وضع علامة على ألبوم كمُشترَك ويمكن للمستخدمين الآخرين الوصول إليه

unshare

 وضع علامة على ألبوم مشترَك سابقًا على أنّه خاص