REST Resource: comments

منبع: نظر

یک نظر در مورد یک فایل.

برخی از متدهای منبع (مانند comments.update ) به یک commentId نیاز دارند. از متد comments.list برای بازیابی شناسه یک نظر در یک فایل استفاده کنید.

نمایش JSON 
{
  "replies": [
    {
      object (Reply)
    }
  ],
  "mentionedEmailAddresses": [
    string
  ],
  "id": string,
  "kind": string,
  "createdTime": string,
  "modifiedTime": string,
  "resolved": boolean,
  "anchor": string,
  "author": {
    object (User)
  },
  "deleted": boolean,
  "htmlContent": string,
  "content": string,
  "quotedFileContent": {
    "mimeType": string,
    "value": string
  },
  "assigneeEmailAddress": string
}
فیلدها
replies[]

object ( Reply )

فقط خروجی. لیست کامل پاسخ‌ها به نظر به ترتیب زمانی.

mentionedEmailAddresses[]

string

فقط خروجی. فهرستی از آدرس‌های ایمیل کاربران ذکر شده در این نظر. اگر هیچ کاربری ذکر نشده باشد، فهرست خالی است.

id

string

فقط خروجی. شناسه نظر.

kind

string

فقط خروجی. نوع منبع را مشخص می‌کند. مقدار: رشته ثابت "drive#comment" .

createdTime

string

فقط خروجی. زمانی که نظر ایجاد شده است (تاریخ-زمان RFC 3339).

modifiedTime

string

فقط خروجی. آخرین باری که نظر یا هر یک از پاسخ‌های آن اصلاح شده است (تاریخ-زمان RFC 3339).

resolved

boolean

فقط خروجی. اینکه آیا نظر توسط یکی از پاسخ‌هایش حل شده است یا خیر.

anchor

string

بخشی از سند که به صورت رشته JSON نمایش داده می‌شود. برای جزئیات بیشتر در مورد تعریف ویژگی‌های لنگر، به مدیریت نظرات و پاسخ‌ها مراجعه کنید.

author

object ( User )

فقط خروجی. نویسنده نظر. آدرس ایمیل نویسنده و شناسه مجوز پر نخواهد شد.

deleted

boolean

فقط خروجی. اینکه آیا نظر حذف شده است یا خیر. نظر حذف شده محتوایی ندارد.

htmlContent

string

فقط خروجی. محتوای نظر با قالب‌بندی HTML.

content

string

محتوای متنی ساده‌ی نظر. این فیلد برای تنظیم محتوا استفاده می‌شود، در حالی که htmlContent باید نمایش داده شود.

quotedFileContent

object

محتوای فایلی که نظر به آن اشاره دارد، معمولاً در ناحیه لنگر. برای مثال، برای یک فایل متنی، این متن در محل نظر قرار دارد.

quotedFileContent.mimeType

string

نوع MIME محتوای نقل قول شده.

quotedFileContent.value

string

خودِ محتوای نقل قول شده. اگر از طریق API تنظیم شود، به عنوان متن ساده تفسیر می‌شود.

assigneeEmailAddress

string

فقط خروجی. آدرس ایمیل کاربری که به این نظر اختصاص داده شده است. اگر هیچ کاربری اختصاص داده نشده باشد، فیلد تنظیم نشده است.

روش‌ها

create

 یک نظر (کامنت) روی یک فایل ایجاد می‌کند.

delete

 یک نظر را حذف می‌کند.

get

 یک نظر را بر اساس شناسه دریافت می‌کند.

list

 نظرات یک فایل را لیست می‌کند.

update

 یک نظر را با معانی وصله به‌روزرسانی می‌کند.