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

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

เมธอด

addEnrichment

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

batchAddMediaItems

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

batchRemoveMediaItems

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

create

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

get

 แสดงผลอัลบั้มที่แอปสร้างขึ้นตาม albumId ที่ระบุ

list

 แสดงรายการอัลบั้มทั้งหมดที่แอปของคุณสร้างขึ้น

patch

 อัปเดตอัลบั้มที่สร้างโดยแอปด้วย id ที่ระบุ