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

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

object (ShareInfo)

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

string (int64 format)

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

string

[เอาต์พุตเท่านั้น] URL ไปยังรูปภาพปก'ไบต์ ไม่ควรใช้คําสั่งนี้อย่างที่เป็นอยู่ ควรเพิ่มพารามิเตอร์ต่อท้าย URL นี้ก่อนใช้ ดูรายการพารามิเตอร์ทั้งหมดที่รองรับได้ในเอกสารประกอบสําหรับนักพัฒนาซอฟต์แวร์ ตัวอย่างเช่น '=w2048-h1024' ตั้งค่าขนาดของรูปภาพปกให้มีความกว้าง 2048 พิกเซลและสูง 1024 พิกเซล
coverPhotoMediaItemId

string

ตัวระบุสําหรับรายการสื่อที่เชื่อมโยงกับรูปภาพปก

แชร์ข้อมูล

ข้อมูลเกี่ยวกับอัลบั้มที่แชร์ ข้อมูลนี้จะรวมอยู่ในอัลบั้มที่คุณสร้างเท่านั้น ซึ่งจะเป็นการแชร์และคุณมีขอบเขตการแชร์

การแสดง 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

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

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

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

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

boolean

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

boolean

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

เมธอด

addEnrichment

 เพิ่มการปรับปรุงในตําแหน่งที่ระบุไว้ในอัลบั้มที่กําหนด

batchAddMediaItems

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

batchRemoveMediaItems

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

create

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

get

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

list

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

patch

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

share

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

unshare

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