- المرجع: ملاحظة
- المرفق
- الإذن
- Role
- المستخدم
- المجموعة
- أفراد العائلة
- القسم
- TextContent
- ListContent
- ListItem
- الطُرق
المرجع: ملاحظة
ملاحظة واحدة.
تمثيل JSON |
---|
{ "name": string, "createTime": string, "updateTime": string, "trashTime": string, "trashed": boolean, "attachments": [ { object ( |
الحقول | |
---|---|
name |
النتائج فقط. تمثّل هذه السمة اسم المصدر لهذه الملاحظة. يُرجى الاطّلاع على الملاحظة العامة حول المعرّفات في KeepService. |
createTime |
النتائج فقط. وقت إنشاء هذه الملاحظة |
updateTime |
النتائج فقط. تاريخ آخر تعديل على هذه الملاحظة |
trashTime |
النتائج فقط. الوقت الذي تم فيه نقل هذه الملاحظة إلى المهملات إذا |
trashed |
النتائج فقط. |
attachments[] |
النتائج فقط. المرفقات المرفقة بهذه الملاحظة |
permissions[] |
النتائج فقط. قائمة الأذونات التي تم ضبطها في الملاحظة تحتوي على إدخال واحد على الأقل لمالك الملاحظة. |
title |
تمثّل هذه السمة عنوان الملاحظة. يجب ألا يزيد الطول عن 1,000 حرف. |
body |
نص الملاحظة. |
مرفق
مرفق بملاحظة.
تمثيل JSON |
---|
{ "name": string, "mimeType": [ string ] } |
الحقول | |
---|---|
name |
اسم المورد: |
mimeType[] |
أنواع MIME (أنواع وسائط IANA) التي يتوفر فيها المرفق. |
الإذن
إذن واحد في الملاحظة. ربط member
بـ role
تمثيل JSON |
---|
{ "name": string, "role": enum ( |
الحقول | |
---|---|
name |
النتائج فقط. اسم المورد. |
role |
الدور الذي يمنحكه هذا الإذن. ويحدد الدور قدرة الكيان على قراءة الملاحظات وكتابتها ومشاركتها. |
email |
تمثّل هذه السمة عنوان البريد الإلكتروني المرتبط بالعضو. في حال ضبط الحقل عند الإنشاء، يجب أن يكون الحقل |
deleted |
النتائج فقط. ما إذا تم حذف هذا العضو. في حال استرداد العضو، يتم ضبط هذه القيمة على "خطأ"، ويحتفظ العضو الذي تم استرداده بالدور الوارد في الملاحظة. |
حقل الاتحاد member . لتحديد الهوية الممنوحة للدور. يتم إلغاء ضبط العضو في حال تم حذفه. يمكن أن يكون member واحدًا فقط مما يلي: |
|
user |
النتائج فقط. المستخدم الذي ينطبق عليه هذا الدور. |
group |
النتائج فقط. المجموعة التي ينطبق عليها هذا الدور. |
family |
النتائج فقط. عائلة Google التي ينطبق عليها هذا الدور. |
الدور
يحدد الأدوار المختلفة التي يمكن أن يتمتع بها الكيان.
عمليات التعداد | |
---|---|
ROLE_UNSPECIFIED |
دور غير محدّد. |
OWNER |
دور يمنح إمكانية الوصول الكامل. لا يمكن إضافة هذا الدور أو إزالته. يحدده منشئ الملاحظة. |
WRITER |
دور يمنح إمكانية المساهمة بالمحتوى وتعديل أذونات الملاحظات. |
مستخدم
يصف مستخدمًا واحدًا.
تمثيل JSON |
---|
{ "email": string } |
الحقول | |
---|---|
email |
عنوان البريد الإلكتروني للمستخدِم. |
مجموعة
يصف مجموعة واحدة.
تمثيل JSON |
---|
{ "email": string } |
الحقول | |
---|---|
email |
عنوان البريد الإلكتروني للمجموعة. |
Family
لا يحتوي هذا النوع على أي حقول.
تصف عائلة واحدة على Google
القسم
محتوى الملاحظة.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد Content . ويجب أن يكون محتوى القسم أحد أنواع القيم هذه. يمكن أن يكون Content واحدًا فقط مما يلي: |
|
text |
يتم استخدامه إذا كان محتوى هذا القسم عبارة عن نص. يجب أن يكون طول المحتوى النصي أقل من 20,000 حرف. |
list |
يتم استخدامه إذا كان محتوى هذا القسم عبارة عن قائمة. |
TextContent
كتلة النص لقسم نص واحد أو عنصر قائمة.
تمثيل JSON |
---|
{ "text": string } |
الحقول | |
---|---|
text |
تمثّل هذه السمة نص الملاحظة. تختلف الحدود المسموح بها في هذا الحقل حسب الحقل المحدد الذي يستخدم هذا النوع. |
ListContent
قائمة بالعناصر لملاحظة قائمة واحدة.
تمثيل JSON |
---|
{
"listItems": [
{
object ( |
الحقول | |
---|---|
listItems[] |
العناصر في القائمة. يجب ألّا يزيد عدد العناصر عن 1,000. |
ListItem
عنصر قائمة واحد في قائمة ملاحظة.
تمثيل JSON |
---|
{ "childListItems": [ { object ( |
الحقول | |
---|---|
childListItems[] |
في حال الضبط، يتم إدراج عناصر القائمة المتداخلة ضمن عنصر القائمة هذا. يُسمح بمستوى واحد فقط من التداخل. |
text |
تمثّل هذه السمة نص هذا العنصر. يجب ألا يزيد الطول عن 1,000 حرف. |
checked |
تشير هذه السمة إلى ما إذا كان قد تم وضع علامة على هذا المنتج أم لا. |
الطُرق |
|
---|---|
|
ينشئ ملاحظة جديدة. |
|
يتم حذف ملاحظة. |
|
ستحصل على ملاحظة. |
|
يسرد الملاحظات. |