ツールキットの詳細
クラス名:box.Toolkit
インスタンス変数
mostRecentError
インスタンスメソッドの呼び出し時に発生した最新のエラーを示す文字列。
この文字列が存在しても、操作が成功しなかったことを意味するわけではありません。そのエラーが回復可能であった可能性もあります。ただし、この文字列に値がない場合は、操作が成功したことを示しています。
Enum CollaborationType
コラボレーションのタイプを示す列挙型。
可能性のある値: EDITOR、VIEWER、PREVIEWER、UPLOADER、COOWNER、OWNER、PREVIEWERUPLOADER、VIEWERUPLOADER
静的メソッド
deleteServiceUserAssociation
サービスアカウントとBox for Salesforce統合の関連付けをクリアするメソッド。間違ったサービスアカウントが使用されている場合、このメソッドを使用してアカウントを変更できます。
パラメータ:
- なし
- ユーザーのアカウントが存在していたが削除された場合は
true。 - ユーザーのアカウントが何らかの理由 (存在しなかった場合を含む) で削除されなかった場合は
false。
deleteUserAssociation
戻り値:
- ユーザーのアカウントが存在していたが削除された場合は
true。 - ユーザーのアカウントが何らかの理由 (存在しなかった場合を含む) で削除されなかった場合は
false。
インスタンスメソッド - コンストラクタ、デストラクタ
box.Toolkit()
パラメータ:
- なし
commitChanges
このメソッドはbox.Toolkit()メソッドのデストラクタとして扱います。
Salesforceではデータベースの更新/挿入/削除の後の呼び出しは許可されないため、Toolkitクラスではすべての呼び出し操作が完了した後で挿入するオブジェクトのコレクションが保持されます。このメソッドを呼び出さない場合、このようなオブジェクトがデータベースから消去され、ユーザー/レコード/フォルダの関連付けを追跡するテーブルの同期も失われて、高度なデバッグによる修正が必要になります。
パラメータ:
- なし
Void
プラットフォームイベントを使用するcommitChanges
このメソッドはbox.Toolkit()メソッドのデストラクタとして扱います。
このメソッドは、上記のcommitChangesとよく似ています。ただし、別のトランザクションでDMLステートメントを実行し、一部のシナリオでガバナ制限を回避するために、プラットフォームイベントを使用してデータベースに変更をコミットします。
戻り値:
Void
ジェネリックメソッド
Box for Salesforce Developer Toolkitは、パラメータとしてHttpRequestオブジェクトを受け取り、HttpResponseオブジェクトを返すグローバルメソッドを提供します。このメソッドではサービスアカウントの認証の詳細情報を利用してBoxのAPIを呼び出すため、開発者は統合のビジネスロジックに集中して取り組むことができます。sendRequest
戻り値:
- BoxのAPIコールからのレスポンスの詳細情報が含まれたHttpResponseオブジェクト。
- HttpRequestのインプットの情報が不足している場合は
Toolkit.BoxApiException。 - サービスアカウントの認証の詳細情報を取得する際に問題が発生した場合は
null。この場合は、mostRecentErrorを確認してください。
ファイル操作
createFileFromAttachment
バージョン3.46以降で使用可能です。Salesforceの文字列長の上限は600万文字です。base64エンコード/デコードプロセスでは文字列が膨張するため、有効なファイルサイズの上限は、同期Apexの場合は4.3MB、非同期Apexの場合は8.6MBとなっています。
戻り値:
string。作成されたBoxファイルのIDが返されます。- エラーが発生した場合は
null。この場合には、mostRecentErrorを確認してください。
pushFileToBox
Salesforce FilesのContentVersionレコードをBoxフォルダにアップロードします。
戻り値:
- アップロードの詳細を含む
PartnerSyncResponseオブジェクト。 - アップロードに失敗した場合は
null。この場合には、mostRecentErrorを確認してください。
- このメソッドでは、サービスアカウント認証を使用します。
- このメソッドは、アップロードの試行に先立ち、
ContentVersionが存在するかどうかを検証します。 - また、サポートされていないファイルの場合に早期にエラーを出せるよう、ファイルサイズの確認もアップロード前に実施します。
- Box APIのエラーとレート制限エラーは、
mostRecentErrorで確認できます。 - このメソッドで
nullが返された場合には、mostRecentErrorを確認してください。
createFileShareLink
Boxファイルの共有リンクを作成します。
戻り値:
string。共有リンクのURLが返されます。- 共有リンクが作成されなかった場合は
null。この場合には、mostRecentErrorを確認してください。
- このメソッドでは、サービスアカウント認証を使用します。
- 共有リンクは、デフォルトのBox権限を使用して作成されます。
- このメソッドで
nullが返された場合には、mostRecentErrorを確認してください。
moveFile
Boxファイルを別のフォルダに移動します。
戻り値:
- 更新後の親フォルダの情報を保持した
Fileオブジェクト。 - 移動に失敗した場合には、
Fileオブジェクトにstatus値が格納されています。mostRecentErrorで詳細を確認してください。
accessTokenが空であるか、nullの場合には、このメソッドではサービスアカウント資格情報を使用します。- 操作エラーについては、返された
Fileオブジェクトのstatus値を確認してください。 - 操作に失敗した場合には、
mostRecentErrorを確認してください。
フォルダ操作
getRootFolderId
パラメータ:
- なし
string。SalesforceルートフォルダのBoxフォルダIDが返されます。
getObjectFolderByRecordId
戻り値:
string。レコードIDが渡されたオブジェクトルートフォルダのBoxフォルダIDが返されます。
getFolderUrl
- このメソッドは、特定のレコードの埋め込みウィジェットURLを取得します。このため、必要に応じて独自の埋め込みロジックを使用できます。
- このメソッドではシームレスログインの設定が優先されます。このため、シームレスログインが有効になっている場合、ユーザーはURLに自動的にログインされます。
戻り値:
string。渡されたSalesforceレコードIDに関連付けられているフォルダを表すURLが返されます。このURLをBox埋め込みウィジェットで使用して、任意のVisualforceページに埋め込むことができます。
createObjectFolderForRecordId
戻り値:
string。作成されたルートフォルダのBoxフォルダIDが返されます。- ルートフォルダがすでに存在していた場合、そのルートフォルダのBoxフォルダIDが返されます。
createFolder
戻り値:
string。作成されたフォルダのBoxフォルダIDが返されます。- フォルダが作成されなかった場合は
nullが返されます。この場合、mostRecentErrorで詳細を確認してください。
createFolderShareLink
Boxフォルダの共有リンクを作成します。
戻り値:
string。共有リンクのURLが返されます。- 共有リンクが作成されなかった場合は
null。この場合には、mostRecentErrorを確認してください。
- このメソッドでは、サービスアカウント認証を使用します。
- 共有リンクは、デフォルトのBox権限を使用して作成されます。
- このメソッドで
nullが返された場合には、mostRecentErrorを確認してください。
getFolderContents
Boxフォルダからファイルとサブフォルダを取得します。
戻り値:
- Boxフォルダ内のファイルとフォルダに関する情報を格納した
FolderContentsオブジェクト。 - リクエストに失敗した場合には、
FolderContentsオブジェクトにstatus値が格納されています。mostRecentErrorで詳細を確認してください。
accessTokenが空であるか、nullの場合には、このメソッドではサービスアカウント資格情報を使用します。- レスポンスにはファイルとサブフォルダの両方が含まれる場合があります。
- 操作エラーについては、返された
FolderContentsオブジェクトのstatus値を確認してください。 - 操作に失敗した場合には、
mostRecentErrorを確認してください。
createFolderForRecordId
戻り値:
string。作成されたフォルダのBoxフォルダIDが返されます。- フォルダが作成されなかった場合は
nullが返されます。この場合、mostRecentErrorで詳細を確認してください。 - SalesforceレコードがすでにBoxフォルダに関連付けられている場合、既存のBoxフォルダIDが返されます。
moveFolder
戻り値:
- フォルダが正常に移動された場合は
true。 - フォルダが正常に移動されなかった場合は
false。mostRecentErrorで詳細を確認してください。
getUrlForFolder
戻り値:
- 指定されたURLを含む
pageReferenceオブジェクト。 - パラメータが正しくない場合は
null。
createFolderForRecordIdFromTemplate
戻り値:
- 新しく作成されたフォルダID。
- パラメータが正しくない場合は
null。
フォルダ関連付けメソッド
getFolderAssociationsByRecordId
戻り値:
- 返されるリストは、このレコードに関連付けられているすべてのフォルダマッピングエントリのコレクションです。
- 一般に、フォルダマッピングエントリが存在しない場合は空のリストになりますが、状況によって
nullになる場合があります。
getFolderIdByRecordId
戻り値:
string。渡されたSalesforceレコードIDに関連付けられたBoxフォルダIDが返されます。
getFolderIdsByRecordIds
1つ以上のSalesforceレコードIDに関連付けられたBoxフォルダIDを取得します。
戻り値:
- SalesforceレコードIDをキー、関連付けられたBoxフォルダIDを値とする
Map<Id, String>。 - フォルダの関連付けが存在しない場合は空のマップ。
- このメソッドはSalesforceのフォルダ関連付けを照会するもので、Box APIは呼び出しません。
FRUP__cオブジェクトのRecord_ID_Indexed__cフィールドを照会します。Box_Folder_ID__cに値がある関連付けのみを返します。- このメソッドを使用して、1回の呼び出しで複数のレコードとフォルダの関連付けを検索できます。
getRecordIdByFolderId
戻り値:
id。渡されたBoxフォルダIDに関連付けられたSalesforceレコードIDが返されます。
createFolderAssociation
戻り値:
box__FRUP__cオブジェクト - エラーが発生した場合 (mostRecentErrorを確認)、返されるFRUPオブジェクトはnullになります。このFRUPエントリは、commitChangesメソッドの呼び出し時にデータベースに挿入されます。このメソッドでは、同じフォルダの複数レコードへの関連付けやその逆の関連付けが許可されないため、他のフォルダの関連付けとの一貫性が保証されます。
コラボレーションメソッド
createCollaboration
戻り値:
string。作成されたBoxコラボレーションのIDが返されます。- エラーが発生した場合は
nullが返されます。その場合、mostRecentErrorを確認してください。
createCollaborationOnRecord
戻り値:
string。作成されたBoxコラボレーションのIDが返されます。- エラーが発生した場合は
nullが返されます。その場合、mostRecentErrorを確認してください。
editCollaboration
戻り値:
- トランザクションが成功したかどうかを示すブール値。
- パラメータが正しくない場合は
false。
deleteCollaboration
戻り値:
- トランザクションが成功したかどうかを示すブール値。
- パラメータが正しくない場合は
false。
検索と検出
search
サービスアカウントがアクセスできるBoxコンテンツを検索します。
戻り値:
- 一致するファイルとフォルダを含む
SearchResultsオブジェクト。 - 検索が失敗した場合は
null。この場合には、mostRecentErrorを確認してください。
- このメソッドでは、サービスアカウント認証を使用します。
- サービスアカウントがアクセスできるファイル名、説明、およびコンテンツを検索します。
- Boxはデフォルトで最大100件の結果を返します。
- ページネーションや検索スコープの絞り込みが必要な場合は、フィルタを使用した
searchを使用してください。 - このメソッドで
nullが返された場合には、mostRecentErrorを確認してください。
フィルタを使用したsearch
フィルタ、ページネーション、およびスコープ制御を使用してBoxコンテンツを検索します。
戻り値:
- 一致するファイルとフォルダを含む
SearchResultsオブジェクト。 - 検索が失敗した場合は
null。この場合には、mostRecentErrorを確認してください。
- このメソッドでは、サービスアカウント認証を使用します。
- ユーザーコンテンツと企業コンテンツのどちらかを選択するには、
scopeを使用します。 - Box APIは、1つのリクエストにつき最大200件の結果をサポートします。
- 結果セットが大きい場合にページ割りするには、
offsetを使用します。 - 結果を特定のフォルダ階層に限定するには、
ancestorFolderIdsを使用します。 - このメソッドで
nullが返された場合には、mostRecentErrorを確認してください。
getRecentInteractions
現在のユーザーが最近操作したファイルとフォルダを取得します。
パラメータ:
- なし
- 最近アクセスされたコンテンツを含む
RecentItemsオブジェクト。 - リクエストが失敗した場合は
null。この場合には、mostRecentErrorを確認してください。
- このメソッドでは、サービスアカウント認証を使用します。
- 結果は最新の操作順に返されます。
- 操作には、項目を開く、プレビューする、ダウンロードする、編集するなどのアクションが含まれます。
- Boxはレスポンスの数をAPIのデフォルト値に制限します。通常は100項目です。
- このメソッドで
nullが返された場合には、mostRecentErrorを確認してください。
Enterprise Event
getEnterpriseEvents
Boxのアクティビティを監査、監視するためのEnterprise Eventを取得します。
戻り値:
- イベントエントリと次のストリーム位置を含む
EnterpriseEventsオブジェクト。 - リクエストが失敗した場合は
null。この場合には、mostRecentErrorを確認してください。
- このメソッドはサービスアカウント認証を使用し、企業管理者権限が必要です。
- イベントストリームのポーリングを継続するには、前回のレスポンスの
streamPositionを使用します。 - Box APIは、1つのリクエストにつき最大500件のイベントをサポートします。
- 日付フィルタは、
YYYY-MM-DDTHH:MM:SSZなどのISO 8601形式を使用する必要があります。 - このメソッドで
nullが返された場合には、mostRecentErrorを確認してください。
メタデータ
すべてのメソッドに対する詳細なエラーレスポンスについては、
toolkit.mostRecentErrorの値を確認してください。getMetadataTemplateByName
名前とスコープを指定してメタデータテンプレート定義を取得します。
戻り値:
- テンプレート定義を含む
MetadataTemplateオブジェクト。 - テンプレートが取得されなかった場合は
null。この場合には、mostRecentErrorを確認してください。
- このメソッドでは、サービスアカウント認証を使用します。
- メタデータ値を作成または更新する前にメタデータテンプレートを調査または検証するために使用します。
- このメソッドで
nullが返された場合には、mostRecentErrorを確認してください。
getBoxMetadataByFileId
このメソッドでは、を呼び出します。
戻り値:
- メタデータのキー/値ペアを含む
Metadataオブジェクト。 - メタデータが取得されなかった場合は
null。この場合には、mostRecentErrorを確認してください。
- このメソッドでは、サービスアカウント認証を使用します。
- ファイルにメタデータインスタンスが存在しない場合、リクエストはエラーを返します。
- このメソッドで
nullが返された場合には、mostRecentErrorを確認してください。
createBoxMetadataByFileId
このメソッドでは、を呼び出します。
戻り値:
- 作成されたメタデータ値を含む
Metadataオブジェクト。 - メタデータが作成されなかった場合は
null。この場合には、mostRecentErrorを確認してください。
- このメソッドでは、サービスアカウント認証を使用します。
- 指定されたファイル、スコープ、テンプレートにメタデータがすでに存在する場合、このメソッドは失敗します。既存のメタデータを変更するには、
updateBoxMetadataByFileIdを使用します。 - メタデータのキーはテンプレートのフィールド名に一致している必要があります。
- このメソッドで
nullが返された場合には、mostRecentErrorを確認してください。
updateBoxMetadataByFileId
このメソッドでは、を呼び出します。
戻り値:
- 更新されたメタデータ値を含む
Metadataオブジェクト。 - メタデータが更新されなかった場合は
null。この場合には、mostRecentErrorを確認してください。
- このメソッドでは、サービスアカウント認証を使用します。
operationsパラメータはJSON Patch形式を使用します。- 各操作には
op、pathを含める必要があり、操作で必要な場合はvalueも含める必要があります。 - サポートされている操作には、
add、replace、remove、testがあります。 - このメソッドで
nullが返された場合には、mostRecentErrorを確認してください。
deleteBoxMetadataByFileId
このメソッドでは、を呼び出します。
戻り値:
- トランザクションが成功したかどうかを示すブール値。
- メタデータが削除されなかった場合は
false。この場合には、mostRecentErrorを確認してください。
- このメソッドでは、サービスアカウント認証を使用します。
- ファイルからメタデータインスタンスを削除します。メタデータテンプレートは削除されません。
- このメソッドで
falseが返された場合には、mostRecentErrorを確認してください。
getBoxMetadataByFolderId
このメソッドでは、を呼び出します。
戻り値:
- このフォルダ、スコープ、およびテンプレートキーに関連付けられた
FolderMetadataレコード。カスタム値は、このオブジェクトのkeyValuePairs変数で確認できます。 - 以下の場合は
null。- パラメータが正しくない
- フォルダへのアクセス権限がない
- メタデータカスケードポリシーが見つからない
createBoxMetadataByFolderId
このメソッドでは、エンドポイントを呼び出します。
戻り値:
- 新しく作成された
FolderMetadataオブジェクト。 - 以下の場合は
null。- パラメータが正しくない
- フォルダへのアクセス権限がない
- メタデータカスケードポリシーが見つからない
updateBoxMetadataByFolderId
エンドポイントを呼び出します。
戻り値:
- 更新された
FolderMetadataオブジェクト。 - 以下の場合は
null。- パラメータが正しくない
- フォルダへのアクセス権限がない
- メタデータカスケードポリシーが見つからない
deleteBoxMetadataFolderId
このメソッドでは、エンドポイントを呼び出します。
戻り値:
- トランザクションが成功したかどうかを示すブール値。
- パラメータが誤っている場合またはメタデータが見つからない場合は、
falseが返されます。
getMetadataCascadePolicyById
このメソッドでは、エンドポイントを呼び出します。このメソッドはIDを必要とするため、最初にgetMetadataCascadePoliciesByFolderIdメソッドを呼び出す必要があります。
戻り値:
- Boxから取得された
MetadataCascadePolicyオブジェクト。 - 以下の場合は
null。- パラメータが正しくない
- フォルダへのアクセス権限がない
- メタデータカスケードポリシーが見つからない
getMetadataCascadePoliciesByFolderId
このメソッドでは、フォルダIDを指定し、エンドポイントを呼び出すことで、カスケードポリシーを取得します。
戻り値:
- Boxから取得された
MetadataCascadePolicyオブジェクトのリスト。 - 以下の場合は
null。- パラメータが正しくない
- フォルダへのアクセス権限がない
- メタデータカスケードポリシーが見つからない
createMetadataCascadePolicy
このメソッドでは、BoxフォルダID、スコープ、テンプレートキーを指定し、エンドポイントを呼び出すことで、カスケードポリシーを作成します。
戻り値:
- 新しく生成された
MetadataCascadePolicy。 - 以下の場合は
null。- パラメータが正しくない
- フォルダへのアクセス権限がない
- メタデータカスケードポリシーの詳細が見つからない
deleteMetadataCascadePolicy
このメソッドでは、カスケードポリシーIDを指定し、エンドポイントを呼び出すことで、カスケードポリシーを削除します。
戻り値:
- トランザクションが成功したかどうかを示すブール値。
- パラメータが正しくない場合、フォルダへのアクセス権限がない場合、またはメタデータカスケードポリシーが見つからない場合は、
falseが返されます。
enableAppActivity
このメソッドでは、アプリアクティビティに指定されたフォルダにメタデータを適用してカスケードすることで、そのフォルダを有効にします。
戻り値:
- トランザクションが成功したかどうかを示すブール値。
- パラメータが正しくない場合は
false。
SalesforceとSlack
getIntegrationMappings
このツールキットのメソッドでは、エンドポイントを呼び出して既存のマッピングを取得します。
戻り値:
IntegrationMappingオブジェクトのリスト。- パラメータが正しくない場合、アクセス権限がない場合、または統合マッピングが見つからない場合は、
nullが返されます。
createIntegrationMapping
このツールキットのメソッドでは、エンドポイントを呼び出してマッピングを作成します。
Slackチャンネルにマッピングする場合、
access_management_disabledはデフォルトでFALSEに設定されます。これにより、Slackチャンネルのメンバーリストに含まれていないコラボレータは自動的に削除されます。組織がBoxでの共有をどのように設定しているかに応じて、setSlackChannelAccessManagementDisabledメソッドを使用してaccess_management_disabledをTRUEに設定するか、グループを使用することをお勧めします。これにより、Slackの設定に関係なく、どのユーザーも削除されなくなります。ファイルがSlackチャンネルにアップロードされると、コラボレーションはSlackに追加されるかSlackから削除されます。
戻り値:
- トランザクションが成功したかどうかを示すブール値。
deleteIntegrationMapping
このツールキットのメソッドでは、エンドポイントを呼び出してマッピングを削除します。
戻り値:
- トランザクションが成功したかどうかを示すブール値。
mapSfdcRecordToSlackChannel
このツールキットのメソッドでは、上記の統合マッピングメソッドを使用し、以下の4種類のユースケースで使用できるラッパーを提供します。
- SalesforceまたはSlackにマッピングが存在しない場合は、Box for Salesforceフォルダ構造にフォルダが作成され、そのフォルダをSlackチャンネルとリンクするための統合マッピングが作成されます。
- Salesforceからのマッピングのみ存在する場合は、引き続きそのフォルダが使用され、場所は変更されません。そのフォルダをSlackチャンネルとリンクするための統合マッピングを作成します。
- Slackからのマッピングのみ存在する場合は、引き続きそのフォルダが使用され、既存のフォルダを使用するためにSalesforceレコード用にFRUPレコードが作成されます。このフォルダは、Salesforceルートフォルダ外に存在する可能性があります。
- SalesforceとSlackに既存のマッピングがあるものの、相互に関連付けられていない場合は、
Toolkit.mostRecentErrorまたはフローアクション内でエラーがスローされ、マッピングがすでに存在することが示されます。
Create Box Folder/Slack Channel Mappingで提供されるフローテンプレートで使用されています。
Slackチャンネルにマッピングする場合、
access_management_disabledはデフォルトでFALSEに設定されます。これにより、Slackチャンネルのメンバーリストに含まれていないコラボレータは自動的に削除されます。組織がBoxでの共有をどのように設定しているかに応じて、setSlackChannelAccessManagementDisabledメソッドを使用してaccess_management_disabledをTRUEに設定するか、グループを使用することをお勧めします。これにより、Slackの設定に関係なく、どのユーザーも削除されなくなります。ファイルがSlackチャンネルにアップロードされると、コラボレーションはSlackに追加されるかSlackから削除されます。
戻り値:
- トランザクションが成功したかどうかを示すブール値。
setSlackChannelAccessManagementDisabled
このツールキットのメソッドでは、エンドポイントを呼び出して、アクセス管理の非アクティブ化設定を更新します。
このメソッド/呼び出し可能なアクションは、Box for SalesforceパッケージのCreate Box Folder/Slack Channel Mappingで提供されるフローテンプレートで使用されています。
戻り値:
- トランザクションが成功したかどうかを示すブール値。
Box Sign
sendSignRequests
このメソッドでは、エンドポイントを呼び出して、署名用ドキュメントを送信します。
戻り値:
BoxSignResponseオブジェクト (処理されるリクエストごとに1つ) のリスト。各レスポンスには、署名リクエストのID、ステータス、エラー情報 (ある場合) が含まれます。
以下の場合、BoxSignResponseによってエラーの詳細が返されます。
- パラメータが正しくない
- ファイルへのアクセス権限がない
- ファイルのアップロードに失敗した
- Box Sign APIからエラーが返された
ドキュメントの生成
submitDocGenBatch
Boxドキュメント生成テンプレートから生成するドキュメントのバッチを送信します。
戻り値:
- バッチのIDとステータスを含む
DocGenBatchオブジェクト。 - バッチが送信されなかった場合は
null。この場合には、mostRecentErrorを確認してください。
- このメソッドでは、サービスアカウント認証を使用します。
- 各ドキュメント構成には、
fileNameやdataの値など、生成されたファイル名と、テンプレートのマージデータが含まれている必要があります。 - ドキュメント生成は非同期的に実行されます。バッチのステータスを確認するには、
getDocGenBatchを使用してください。 - このメソッドで
nullが返された場合には、mostRecentErrorを確認してください。
getDocGenBatch
ドキュメント生成バッチのステータスと詳細を取得します。
戻り値:
- バッチのステータスと生成されたファイルの詳細を含む
DocGenBatchオブジェクト。 - バッチが取得されなかった場合は
null。この場合には、mostRecentErrorを確認してください。
- このメソッドでは、サービスアカウント認証を使用します。
- このメソッドを定期的にポーリングしてバッチの進行状況を監視してください。
- バッチのステータスには
pending、processing、completed、failedがあります。 - 生成されたファイルの詳細は、バッチ完了後に利用可能になります。
- このメソッドで
nullが返された場合には、mostRecentErrorを確認してください。
ファイルリクエスト
copyFileRequest
カスタマイズ可能なプロパティを備えた既存のファイルリクエストのコピーを作成します。
戻り値:
- 新しいファイルリクエストの詳細を含む
FileRequestオブジェクト。 - ファイルリクエストがコピーされなかった場合は
null。この場合には、mostRecentErrorを確認してください。
- このメソッドでは、サービスアカウント認証を使用します。
- 省略可能なパラメータが
nullの場合、新しいファイルリクエストはそれらの値を元のファイルリクエストから継承します。 - コピーしたファイルリクエストをすぐに有効にするには、
activeを使用します。 - このメソッドで
nullが返された場合には、mostRecentErrorを確認してください。
デフォルト設定を使用したcopyFileRequest
元のファイルリクエストの設定と新しいコピー先フォルダを使用して、既存のファイルリクエストのコピーを作成します。
戻り値:
- 新しいファイルリクエストの詳細を含む
FileRequestオブジェクト。 - ファイルリクエストがコピーされなかった場合は
null。この場合には、mostRecentErrorを確認してください。
- このメソッドでは、サービスアカウント認証を使用します。
- コピーしたファイルリクエストは、元のファイルリクエストから設定を継承し、指定されたフォルダIDを使用します。
- この方法は、コピー先フォルダの変更が必要な場合にのみ使用してください。
- このメソッドで
nullが返された場合には、mostRecentErrorを確認してください。
Box Hubs
Box Hubsの管理
getHubById
このメソッドでは、エンドポイントを呼び出して、特定のHubを取得します。
戻り値:
- Hubの詳細およびメタデータを含むHubオブジェクト。
- 以下の場合は
HubsToolkitException。- Hub IDが空またはnullである
- Hubへのアクセス権限がない
- Hubが見つからない
getAllHubs
このメソッドでは、エンドポイントを呼び出して、すべてのHubのリストを取得します。
戻り値:
- Hubのリストとページネーションの情報を含む
HubsListオブジェクト。 - 以下の場合は
HubsToolkitException。- Hubへのアクセス権限がない
- APIリクエストが失敗した
getEnterpriseHubs
このメソッドでは、エンドポイントを呼び出して、企業レベルのHubを取得します。
戻り値:
- 企業のHubのリストとページネーションの情報を含む
HubsListオブジェクト。 - 以下の場合は
HubsToolkitException。- 企業のHubへのアクセス権限がない
- APIリクエストが失敗した
createHub
このメソッドでは、を呼び出して、新しいHubを作成します。
戻り値:
- 新しく作成されたHubの詳細を含むHubオブジェクト。
- 以下の場合は
HubsToolkitException。- タイトルが空またはnullである
- タイトルが50文字を超えている
- Hubを作成するためのアクセス権限がない
- APIリクエストが失敗した
updateHub
このメソッドでは、を呼び出して、既存のHubを変更します。
戻り値:
- 更新されたHubの詳細を含むHubオブジェクト。
- 以下の場合は
HubsToolkitException。- Hub IDが空またはnullである
- 更新リクエストがnullである
- タイトルが50文字を超えている
- Hubへのアクセス権限がない
- APIリクエストが失敗した
copyHub
このメソッドでは、を呼び出して、既存のHubのコピーを作成します。
戻り値:
- 新しくコピーして作成されたHubの詳細を含むHubオブジェクト。
- 以下の場合は
HubsToolkitException。- Hub IDが空またはnullである
- タイトルが50文字を超えている
- 元のHubへのアクセス権限がない
- APIリクエストが失敗した
Box Hubコラボレーション
createUserCollaboration
このメソッドでは、エンドポイントを呼び出して、Hubにユーザーを追加します。
戻り値:
- コラボレーションの詳細を含む
HubCollaborationオブジェクト。 - 以下の場合は
HubsToolkitException。- Hub IDが空またはnullである
- ユーザーIDが空またはnullである
- ロールが空またはnullである
- Hubへのアクセス権限がない
- APIリクエストが失敗した
createHubCollaboration
このメソッドでは、エンドポイントを呼び出して、Hubにコラボレーションを追加します。
戻り値:
- コラボレーションの詳細を含む
HubCollaborationオブジェクト。 - 以下の場合は
HubsToolkitException。- コラボレーションリクエストがnullである
- IDによるHubの参照がない
- Hubへのアクセス権限がない
- APIリクエストが失敗した
getHubCollaborations
このメソッドでは、エンドポイントを呼び出して、Hubのコラボレーションを取得します。
戻り値:
- コラボレーションのリストとページネーションの情報を含む
HubCollaborationsListオブジェクト。 - 以下の場合は
HubsToolkitException。- Hub IDが空またはnullである
- Hubへのアクセス権限がない
- APIリクエストが失敗した
updateHubCollaboration
このメソッドでは、エンドポイントを呼び出して、コラボレーションを変更します。
戻り値:
- コラボレーションの詳細を含む
HubCollaborationオブジェクト。 - 以下の場合は
HubsToolkitException。- コラボレーションIDが空またはnullである
- ロールが空またはnullである
- コラボレーションへのアクセス権限がない
- APIリクエストが失敗した
Box Hubの項目
addHubItem
このメソッドでは、エンドポイントを呼び出して、Hubに項目を追加します。
戻り値:
- 項目の管理操作の結果を含む
HubItemsManageResponseオブジェクト。 - 以下の場合は
HubsToolkitException。- Hub IDが空またはnullである
- 項目IDが空またはnullである
- 項目タイプが空またはnullである
- Hubへのアクセス権限がない
- APIリクエストが失敗した
デバッグ
setEnhancedDebugging
現在のToolkitインスタンス向けの拡張デバッグログを有効または無効にします。
戻り値:
Void
- 拡張デバッグは、現在のToolkitインスタンスにのみ適用されます。
- 拡張デバッグを有効にすると、追加でHTTPリクエストとレスポンスの詳細がログ記録されます。
- トラブルシューティングに拡張デバッグを使用し、実稼働環境では不要なログ記録が行われないように無効にします。
- この設定はトランザクション間で維持されません。
isEnhancedDebuggingEnabled
現在のToolkitインスタンスに対して拡張デバッグが有効になっているかどうかを確認します。
パラメータ:
- なし
- 拡張デバッグが有効になっている場合は
true。 - 拡張デバッグが無効になっている場合は
false。
- このメソッドは副次的影響を持ちません。
- デバッグのみのロジックを条件付きで実行するために使用します。
- 戻り値には、
setEnhancedDebuggingによって適用された設定が反映されます。
