រៀនពីរបៀបកែប្រែព័ត៌មានកំណត់ត្រា និងវាលផ្ទាល់ខ្លួនដោយប្រើ Blue API។
កែប្រែព័ត៌មានកំណត់ត្រា
ដើម្បីកែប្រែលក្ខណៈសំខាន់ៗនៃកំណត់ត្រា សូមប្រើ editTodo
mutation:
mutation UpdateRecordDetails {
editTodo(
input: {
todoId: "YOUR RECORD ID"
todoListId: "RECORD LIST ID TO MOVE THE RECORD TO"
position: "NEW RECORD POSITION IN NUMBER"
title: "NEW RECORD TITLE"
html: "NEW RECORD DESCRIPTION IN HTML (MUST MATCH TEXT)"
text: "NEW RECORD DESCRIPTION IN TEXT (MUST MATCH HTML)"
startedAt: "NEW RECORD DUE DATE (START)"
duedAt: "NEW RECORD DUE DATE (END)"
color: "RECORD COLOR CODE"
}
) {
id
title
position
html
text
color
}
}
ឯកសារវាលបញ្ចូល
វាល | ប្រភេទ | ព័ត៌មានពិពណ៌នា |
---|---|---|
todoId | String | (ត្រូវការពិត) អត្តសញ្ញាណនៃកំណត់ត្រាដែលត្រូវកែប្រែ |
todoListId | String | អត្តសញ្ញាណបញ្ជីថ្មីប្រសិនបើបញ្ជីកំណត់ត្រាត្រូវបានផ្លាស់ទី |
position | Float | ទីតាំងថ្មីក្នុងបញ្ជី |
title | String | ចំណងជើងកំណត់ត្រាដែលបានកែប្រែ |
html/text | String | ព័ត៌មានពិពណ៌នាដែលបានកែប្រែ (ត្រូវតែស្របគ្នានៅក្នុងទាំងពីរវាល) |
startedAt/duedAt | DateTime | ថ្ងៃខែឆ្នាំចាប់ផ្តើម/បញ្ចប់ដែលបានកែប្រែក្នុងទ្រង់ទ្រាយ ISO 8601 |
color | String | កូដពណ៌ពីជម្រើសដែលមាន |
ជម្រើសពណ៌
// Light theme colors
["#ffc2d4", "#ed8285", "#ffb55e", "#ffe885", "#ccf07d",
"#91e38c", "#a1f7fa", "#91cfff", "#c29ee0", "#e8bd91"]
// Dark theme colors
["#ff8ebe", "#ff4b4b", "#ff9e4b", "#ffdc6b", "#b4e051",
"#66d37e", "#4fd2ff", "#4a9fff", "#a17ee8", "#e89e64"]
កែប្រែវាលផ្ទាល់ខ្លួន
ដើម្បីកែប្រែតម្លៃវាលផ្ទាល់ខ្លួន សូមប្រើ setTodoCustomField
mutation ជាមួយប៉ារ៉ាម៉ែត្រដែលមានលក្ខណៈពិសេស:
វាលផ្អែកលើអត្ថបទ
mutation {
setTodoCustomField(
input: {
customFieldId: "YOUR CUSTOM FIELD ID"
todoId: "YOUR RECORD ID"
text: "VALUE"
}
)
}
អនុវត្តទៅ: TEXT_SINGLE
, TEXT_MULTI
, URL
, EMAIL
វាលលេខ
mutation {
setTodoCustomField(
input: {
customFieldId: "YOUR CUSTOM FIELD ID"
todoId: "YOUR RECORD ID"
number: "NUMERIC_VALUE"
}
)
}
អនុវត្តទៅ: NUMBER
, PERCENT
, RATING
វាលជ្រើស
mutation {
setTodoCustomField(
input: {
customFieldId: "YOUR CUSTOM FIELD ID"
todoId: "YOUR RECORD ID"
customFieldOptionIds: ["OPTION_ID_1", "OPTION_ID_2"]
}
)
}
អនុវត្តទៅ: SELECT_SINGLE
, SELECT_MULTI
វាលពិសេស
លេខទូរស័ព្ទ:
mutation {
setTodoCustomField(
input: {
customFieldId: "YOUR CUSTOM FIELD ID"
todoId: "YOUR RECORD ID"
text: "+33642526644"
regionCode: "FR"
}
)
}
ប្រទេស:
mutation {
setTodoCustomField(
input: {
customFieldId: "YOUR CUSTOM FIELD ID"
todoId: "YOUR RECORD ID"
countryCodes: ["AF", "AL", "DZ"]
text: "Afghanistan, Albania, Algeria"
}
)
}
ទីតាំង:
mutation {
setTodoCustomField(
input: {
customFieldId: "YOUR CUSTOM FIELD ID"
todoId: "YOUR RECORD ID"
latitude: 42.2923323
longitude: 12.126621199999999
text: "Via Cassia, Querce d'Orlando, Capranica, Italy"
}
)
}
ប្រអប់ត្រួតពិនិត្យ:
mutation {
setTodoCustomField(
input: {
customFieldId: "YOUR CUSTOM FIELD ID"
todoId: "YOUR RECORD ID"
checked: true
}
)
}
អាជ្ញាប័ណ្ណដែលត្រូវការ
អ្នកប្រើត្រូវតែមានការចូលដំណើរការប្រព័ន្ធគម្រោងដែលសមស្របដើម្បីកែប្រែកំណត់ត្រា:
កម្រិតចូល | អាចកែប្រែកំណត់ត្រា |
---|---|
OWNER |
✅ បាទ |
ADMIN |
✅ បាទ |
MEMBER |
✅ បាទ |
CLIENT |
✅ បាទ |
COMMENT_ONLY |
❌ ទេ |
VIEW_ONLY |
❌ ទេ |
អាជ្ញាប័ណ្ណវាលផ្ទាល់ខ្លួនបន្ថែមអាចត្រូវអនុវត្តសម្រាប់ setTodoCustomField
ដោយផ្អែកលើការកំណត់តួនាទី។
តម្លៃត្រឡប់
editTodo
ត្រឡប់មកវិញនូវវត្ថុTodo
ដែលបានកែប្រែពេញលេញsetTodoCustomField
ត្រឡប់មកវិញBoolean!
ដែលបញ្ជាក់ពីភាពជោគជ័យ
កំណត់ចំណាំ
- អត្តសញ្ញាណវាលផ្ទាល់ខ្លួនអាចរកឃើញបានដោយប្រើការស្នើសុំ បញ្ជីវាលផ្ទាល់ខ្លួន
- លេខទូរស័ព្ទត្រូវតែមានក្នុងទ្រង់ទ្រាយ E.164 នៅពេលប្រើ API ដោយផ្ទាល់
- វាលទីតាំងគឺល្អបំផុតក្នុងការគ្រប់គ្រងតាមរយៈអន្តរកម្មកម្មវិធី Blue
- វាល
html
និងtext
ត្រូវបានសមស្របដោយស្វ័យប្រវត្តិនៅពេលhtml
ត្រូវបានផ្តល់ - ប្រតិបត្តិការកែប្រែទាំងអស់នឹងបង្កើតកំណត់ហេតុសកម្មភាព និងការជូនដំណឹង webhook