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 นี้ก่อนใช้งาน ดูรายการพารามิเตอร์ที่รองรับทั้งหมดได้ในเอกสารประกอบสำหรับนักพัฒนาซอฟต์แวร์ ตัวอย่างเช่น '=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

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

boolean

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

เมธอด

addEnrichment

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

batchAddMediaItems

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

batchRemoveMediaItems

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

create

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

get

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

list

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

patch

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

share

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

unshare

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