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

[เอาต์พุตเท่านั้น] เป็นจริงหากคุณสร้างรายการสื่อในอัลบั้มนี้ได้ ช่องนี้จะอิงตามขอบเขตที่ให้สิทธิ์และสิทธิ์ของอัลบั้ม หากเปลี่ยนขอบเขตหรือสิทธิ์ของอัลบั้ม ระบบจะอัปเดตช่องนี้
shareInfo

object (ShareInfo)

[เอาต์พุตเท่านั้น] ข้อมูลที่เกี่ยวข้องกับอัลบั้มที่แชร์ ระบบจะป้อนข้อมูลในช่องนี้เฉพาะในกรณีที่อัลบั้มเป็นอัลบั้มที่แชร์ นักพัฒนาแอปสร้างอัลบั้ม และผู้ใช้ได้ให้สิทธิ์ระดับ photoslibrary.sharing
mediaItemsCount

string (int64 format)

[เอาต์พุตเท่านั้น] จำนวนรายการสื่อในอัลบั้ม
coverPhotoBaseUrl

string

[เอาต์พุตเท่านั้น] URL ไปยังไบต์ของรูปภาพหน้าปก ไม่ควรใช้ 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 Photos ที่แชร์ ทุกคนที่มีลิงก์สามารถดูเนื้อหาของอัลบั้มได้ ดังนั้นควรตรวจสอบด้วยความระมัดระวัง

ระบบจะแสดงผลพารามิเตอร์ shareableUrl เฉพาะในกรณีที่อัลบั้มเปิดการแชร์ลิงก์ไว้เท่านั้น หากผู้ใช้เข้าร่วมอัลบั้มที่ยังไม่ได้แชร์ลิงก์อยู่แล้ว ผู้ใช้จะใช้ productUrl ของอัลบั้มนั้นเพื่อเข้าถึงอัลบั้มแทนได้

shareableUrl จะใช้งานไม่ได้หากเจ้าของปิดการแชร์ลิงก์ในแอป Google Photos หรือหากยกเลิกการแชร์อัลบั้ม
shareToken

string

โทเค็นที่ใช้เพื่อเข้าร่วม ออก หรือเรียกข้อมูลรายละเอียดของอัลบั้มที่แชร์ในนามของผู้ใช้ที่ไม่ใช่เจ้าของ

shareToken จะใช้งานไม่ได้หากเจ้าของปิดการแชร์ลิงก์ในแอป Google Photos หรือหากยกเลิกการแชร์อัลบั้ม
isJoined

boolean

เป็นจริงหากผู้ใช้เข้าร่วมอัลบั้ม และจะเป็นเช่นนี้เสมอสำหรับเจ้าของอัลบั้ม
isOwned

boolean

เป็นจริงหากผู้ใช้เป็นเจ้าของอัลบั้ม
isJoinable

boolean

เป็นจริงหากผู้ใช้เข้าร่วมอัลบั้มได้

SharedAlbumOptions

ตัวเลือกที่ควบคุมการแชร์อัลบั้ม

การแสดง JSON 
{
  "isCollaborative": boolean,
  "isCommentable": boolean
}
ช่อง
isCollaborative

boolean

จริงหากอัลบั้มที่แชร์อนุญาตให้ผู้ทำงานร่วมกัน (ผู้ใช้ที่เข้าร่วมอัลบั้ม) เพิ่มรายการสื่อลงในอัลบั้มได้ ค่าเริ่มต้นคือ False
isCommentable

boolean

เป็นจริงหากอัลบั้มที่แชร์อนุญาตให้ผู้ทำงานร่วมกัน (ผู้ใช้ที่เข้าร่วมอัลบั้ม) เพิ่มความคิดเห็นในอัลบั้มได้ ค่าเริ่มต้นคือ "เท็จ"

เมธอด

addEnrichment

 เพิ่มข้อมูลให้สมบูรณ์ในตำแหน่งที่ระบุในอัลบั้มที่กําหนด

batchAddMediaItems

 เพิ่มรายการสื่ออย่างน้อย 1 รายการในห้องสมุด Google Photos ของผู้ใช้ลงในอัลบั้ม

batchRemoveMediaItems

 นำรายการสื่ออย่างน้อย 1 รายการออกจากอัลบั้มที่ระบุ

create

 สร้างอัลบั้มในคลังภาพ Google Photos ของผู้ใช้

get

 แสดงอัลบั้มตาม albumId ที่ระบุ

list

 แสดงรายการอัลบั้มทั้งหมดที่แสดงต่อผู้ใช้ในแท็บอัลบั้มของแอป Google Photos

patch

 อัปเดตอัลบั้มด้วย id ที่ระบุ

share

 ทำเครื่องหมายอัลบั้มว่าแชร์และผู้ใช้รายอื่นเข้าถึงได้

unshare

 ทำเครื่องหมายอัลบั้มที่แชร์ก่อนหน้านี้ว่าเป็นส่วนตัว