ファイルの1つ以上のBox Skillsメタデータカードを更新します。
12345
ファイルを表す一意の識別子。
ファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLがhttps://*.app.box.com/files/123
の場合、file_id
は123
です。
メタデータテンプレートに変更を加えるためのJSON-Patchの指定。
変更は操作オブジェクトのJSON配列として表されます。
"replace"
replace
次の値に固定: replace
"/cards/0"
置き換えるカードを表すJSONパス。ほとんどの場合、これは/cards/{index}
形式になります (index
は、カードのリストにおいてそのカードの位置を示すゼロから始まるインデックスです)。
カードのリスト内のpath
で定義された位置に挿入されるカード。
カスタムテンプレートデータを含め、更新されたメタデータテンプレートを返します。
リクエストしたファイルが見つかりませんでした
予期しないクライアントエラー。
curl -i -X PUT "https://api.box.com/2.0/files/12345/metadata/global/boxSkillsCards" \
-H "authorization: Bearer <ACCESS_TOKEN>" \
-H "content-type: application/json-patch+json" \
-d '[
"op": "replace",
"path": "/cards/0",
"value": {
"type": "skill_card",
"skill_card_type": "keyword",
"skill_card_title": {
"code": "license-plates",
"message": "Licence Plates"
},
"skill": {
"type": "service"
"id": "license-plates-service"
},
"invocation": {
"type": "skill_invocation"
"id": "license-plates-service-123"
},
"entries": {
{ "text": "DD-26-YT" },
{ "text": "DN86 BOX" }
}
}
]'
await client.skills.updateBoxSkillCardsOnFile(file.id, [
{
op: 'replace' as UpdateBoxSkillCardsOnFileRequestBodyOpField,
path: '/cards/0',
value: new KeywordSkillCard({
type: 'skill_card' as KeywordSkillCardTypeField,
skillCardType: 'keyword' as KeywordSkillCardSkillCardTypeField,
skillCardTitle: {
code: 'license-plates',
message: updatedTitleMessage,
} satisfies KeywordSkillCardSkillCardTitleField,
skill: new KeywordSkillCardSkillField({
id: skillId,
type: 'service' as KeywordSkillCardSkillTypeField,
}),
invocation: new KeywordSkillCardInvocationField({
id: invocationId,
type: 'skill_invocation' as KeywordSkillCardInvocationTypeField,
}),
entries: [{ text: 'DN86 BOX' } satisfies KeywordSkillCardEntriesField],
}),
} satisfies UpdateBoxSkillCardsOnFileRequestBody,
]);
client.skills.update_box_skill_cards_on_file(
file.id,
[
UpdateBoxSkillCardsOnFileRequestBody(
op=UpdateBoxSkillCardsOnFileRequestBodyOpField.REPLACE,
path="/cards/0",
value=KeywordSkillCard(
type=KeywordSkillCardTypeField.SKILL_CARD,
skill_card_type=KeywordSkillCardSkillCardTypeField.KEYWORD,
skill_card_title=KeywordSkillCardSkillCardTitleField(
code="license-plates", message=updated_title_message
),
skill=KeywordSkillCardSkillField(
id=skill_id, type=KeywordSkillCardSkillTypeField.SERVICE
),
invocation=KeywordSkillCardInvocationField(
id=invocation_id,
type=KeywordSkillCardInvocationTypeField.SKILL_INVOCATION,
),
entries=[KeywordSkillCardEntriesField(text="DN86 BOX")],
),
)
],
)
{
"$canEdit": true,
"$id": "01234500-12f1-1234-aa12-b1d234cb567e",
"$parent": "folder_59449484661,",
"$scope": "enterprise_27335",
"$template": "properties",
"$type": "properties-6bcba49f-ca6d-4d2a-a758-57fe6edf44d0",
"$typeVersion": 2,
"$version": 1,
"cards": [
{
"created_at": "2018-04-13T13:53:23-07:00",
"entries": [
{
"text": "keyword1"
}
],
"invocation": {
"id": "image-recognition-service-123",
"type": "skill_invocation"
},
"skill": {
"id": "image-recognition-service",
"type": "service"
},
"skill_card_title": {
"code": "labels",
"message": "Labels"
},
"skill_card_type": "keyword",
"type": "skill_card"
}
]
}