REST Resource: spaces.messages.attachments
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
แหล่งข้อมูล: ไฟล์แนบ
| การแสดง JSON |
{
"name": string,
"contentName": string,
"contentType": string,
"thumbnailUri": string,
"downloadUri": string,
"source": enum (Source),
// Union field data_ref can be only one of the following:
"attachmentDataRef": {
object (AttachmentDataRef)
},
"driveDataRef": {
object (DriveDataRef)
}
// End of list of possible types for union field data_ref.
} |
| ช่อง |
name |
string
ไม่บังคับ ชื่อทรัพยากรของไฟล์แนบในรูปแบบ spaces/{space}/messages/{message}/attachments/{attachment}
|
contentName |
string
เอาต์พุตเท่านั้น ชื่อไฟล์ต้นฉบับของเนื้อหา ไม่ใช่เส้นทางแบบสมบูรณ์
|
contentType |
string
เอาต์พุตเท่านั้น ประเภทเนื้อหา (ประเภท MIME) ของไฟล์
|
thumbnailUri |
string
เอาต์พุตเท่านั้น URL ของภาพปกที่ควรใช้แสดงตัวอย่างไฟล์แนบต่อผู้ใช้ แอปรับแชทไม่ควรใช้ URL นี้เพื่อดาวน์โหลดเนื้อหาไฟล์แนบ
|
downloadUri |
string
เอาต์พุตเท่านั้น URL การดาวน์โหลดที่ควรใช้เพื่อให้ผู้ใช้ดาวน์โหลดไฟล์แนบได้ แอปรับแชทไม่ควรใช้ URL นี้เพื่อดาวน์โหลดเนื้อหาไฟล์แนบ
|
source |
enum (Source)
เอาต์พุตเท่านั้น แหล่งที่มาของไฟล์แนบ
|
ฟิลด์สหภาพ data_ref การอ้างอิงข้อมูลไปยังไฟล์แนบ data_ref ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
attachmentDataRef |
object (AttachmentDataRef)
ไม่บังคับ การอ้างอิงข้อมูลไฟล์แนบ ช่องนี้ใช้ในการสร้างหรืออัปเดตข้อความที่มีไฟล์แนบ หรือใช้กับ Media API เพื่อดาวน์โหลดข้อมูลไฟล์แนบ
|
driveDataRef |
object (DriveDataRef)
เอาต์พุตเท่านั้น การอ้างอิงไฟล์แนบ Google ไดรฟ์ ช่องนี้ใช้กับ Google Drive API
|
AttachmentDataRef
| การแสดง JSON |
{
"resourceName": string,
"attachmentUploadToken": string
} |
| ช่อง |
resourceName |
string
ไม่บังคับ ชื่อทรัพยากรของข้อมูลไฟล์แนบ ฟิลด์นี้ใช้กับ Media API เพื่อดาวน์โหลดข้อมูลไฟล์แนบ
|
attachmentUploadToken |
string
ไม่บังคับ โทเค็นแบบทึบที่มีข้อมูลอ้างอิงถึงไฟล์แนบที่อัปโหลด ลูกค้าจะถือว่าสตริงนี้เป็นสตริงทึบและใช้เพื่อสร้างหรืออัปเดตข้อความใน Chat ที่มีไฟล์แนบ
|
แหล่งที่มา
| Enum |
SOURCE_UNSPECIFIED |
สงวนไว้ |
DRIVE_FILE |
ไฟล์เป็นไฟล์ Google ไดรฟ์ |
UPLOADED_CONTENT |
ระบบจะอัปโหลดไฟล์ไปยัง Chat |
เมธอด |
|
|
รับข้อมูลเมตาของไฟล์แนบข้อความ |
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-07-25 UTC
[null,null,["อัปเดตล่าสุด 2025-07-25 UTC"],[[["\u003cp\u003eAn \u003ccode\u003eAttachment\u003c/code\u003e resource represents a file attached to a Google Chat message, containing metadata such as file name, content type, and source.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eAttachment\u003c/code\u003e includes URLs for thumbnail preview and user download, but Chat apps should utilize the \u003ccode\u003edata_ref\u003c/code\u003e field for accessing content.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003edata_ref\u003c/code\u003e field can point to either uploaded content within Chat (\u003ccode\u003eAttachmentDataRef\u003c/code\u003e) or a Google Drive file (\u003ccode\u003eDriveDataRef\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eAttachmentDataRef\u003c/code\u003e is used by Chat apps to create/update messages with attachments or to download attachment data via the media API.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can use the \u003ccode\u003eget\u003c/code\u003e method to retrieve metadata for a specific message attachment.\u003c/p\u003e\n"]]],["Attachments in Google Chat contain metadata and data references. Key information includes the attachment's `name`, `contentName`, `contentType`, `thumbnailUri`, and `downloadUri`. The `source` indicates if it's from Google Drive or uploaded to Chat. `AttachmentDataRef` provides a `resourceName` for media API downloads and an `attachmentUploadToken` for creating/updating messages with attachments. Methods to retrieve attachments metadata are detailed. The data source can be either a Drive file or uploaded content.\n"],null,["# REST Resource: spaces.messages.attachments\n\n- [Resource: Attachment](#Attachment)\n - [JSON representation](#Attachment.SCHEMA_REPRESENTATION)\n - [AttachmentDataRef](#Attachment.AttachmentDataRef)\n - [JSON representation](#Attachment.AttachmentDataRef.SCHEMA_REPRESENTATION)\n - [Source](#Attachment.Source)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Attachment\n--------------------\n\nAn attachment in Google Chat.\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"contentName\": string, \"contentType\": string, \"thumbnailUri\": string, \"downloadUri\": string, \"source\": enum (/workspace/chat/api/reference/rest/v1/spaces.messages.attachments#Attachment.Source), // Union field `data_ref` can be only one of the following: \"attachmentDataRef\": { object (/workspace/chat/api/reference/rest/v1/spaces.messages.attachments#Attachment.AttachmentDataRef) }, \"driveDataRef\": { object (/workspace/chat/api/reference/rest/v1/DriveDataRef) } // End of list of possible types for union field `data_ref`. } ``` |\n\n| Fields ||\n|---------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Optional. Resource name of the attachment, in the form `spaces/{space}/messages/{message}/attachments/{attachment}`. |\n| `contentName` | `string` Output only. The original file name for the content, not the full path. |\n| `contentType` | `string` Output only. The content type (MIME type) of the file. |\n| `thumbnailUri` | `string` Output only. The thumbnail URL which should be used to preview the attachment to a human user. Chat apps shouldn't use this URL to download attachment content. |\n| `downloadUri` | `string` Output only. The download URL which should be used to allow a human user to download the attachment. Chat apps shouldn't use this URL to download attachment content. |\n| `source` | `enum (`[Source](/workspace/chat/api/reference/rest/v1/spaces.messages.attachments#Attachment.Source)`)` Output only. The source of the attachment. |\n| Union field `data_ref`. The data reference to the attachment. `data_ref` can be only one of the following: ||\n| `attachmentDataRef` | `object (`[AttachmentDataRef](/workspace/chat/api/reference/rest/v1/spaces.messages.attachments#Attachment.AttachmentDataRef)`)` Optional. A reference to the attachment data. This field is used to create or update messages with attachments, or with the media API to download the attachment data. |\n| `driveDataRef` | `object (`[DriveDataRef](/workspace/chat/api/reference/rest/v1/DriveDataRef)`)` Output only. A reference to the Google Drive attachment. This field is used with the Google Drive API. |\n\n### AttachmentDataRef\n\nA reference to the attachment data.\n\n| JSON representation |\n|---------------------------------------------------------------------|\n| ``` { \"resourceName\": string, \"attachmentUploadToken\": string } ``` |\n\n| Fields ||\n|-------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `resourceName` | `string` Optional. The resource name of the attachment data. This field is used with the media API to download the attachment data. |\n| `attachmentUploadToken` | `string` Optional. Opaque token containing a reference to an uploaded attachment. Treated by clients as an opaque string and used to create or update Chat messages with attachments. |\n\n### Source\n\nThe source of the attachment.\n\n| Enums ||\n|----------------------|----------------------------------|\n| `SOURCE_UNSPECIFIED` | Reserved. |\n| `DRIVE_FILE` | The file is a Google Drive file. |\n| `UPLOADED_CONTENT` | The file is uploaded to Chat. |\n\n| Methods ------- ||\n|----------------------------------------------------------------------------------|--------------------------------------------|\n| ### [get](/workspace/chat/api/reference/rest/v1/spaces.messages.attachments/get) | Gets the metadata of a message attachment. |"]]
