メインコンテンツへスキップ

ツールキットの詳細

クラス名: box.Toolkit

インスタンス変数

mostRecentError

インスタンスメソッドの呼び出し時に発生した最新のエラーを示す文字列。 この文字列が存在しても、操作が成功しなかったことを意味するわけではありません。そのエラーが回復可能であった可能性もあります。ただし、この文字列に値がない場合は、操作が成功したことを示しています。

Enum CollaborationType

コラボレーションのタイプを示す列挙型。 可能性のある値: EDITORVIEWERPREVIEWERUPLOADERCOOWNEROWNERPREVIEWERUPLOADERVIEWERUPLOADER

静的メソッド

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フォルダにアップロードします。
サポートされているファイルサイズは25 MB (26,214,400バイト) までです。この上限を超えているファイルはアップロードが拒否され、ファイル名とサイズを示したエラーメッセージが表示されます。
戻り値:
  • アップロードの詳細を含むPartnerSyncResponseオブジェクト。
  • アップロードに失敗した場合はnull。この場合には、mostRecentErrorを確認してください。
使用上の注意事項:
  • このメソッドでは、サービスアカウント認証を使用します。
  • このメソッドは、アップロードの試行に先立ち、ContentVersionが存在するかどうかを検証します。
  • また、サポートされていないファイルの場合に早期にエラーを出せるよう、ファイルサイズの確認もアップロード前に実施します。
  • Box APIのエラーとレート制限エラーは、mostRecentErrorで確認できます。
  • このメソッドでnullが返された場合には、mostRecentErrorを確認してください。
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で詳細を確認してください。
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
  • フォルダが正常に移動されなかった場合はfalsemostRecentErrorで詳細を確認してください。

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メソッドの呼び出し時にデータベースに挿入されます。このメソッドでは、同じフォルダの複数レコードへの関連付けやその逆の関連付けが許可されないため、他のフォルダの関連付けとの一貫性が保証されます。

コラボレーションメソッド

Box for Salesforce Developer Toolkitによって作成されたコラボレーションは、コラボレータにコラボレーションメールを送信しません。Box for Salesforce統合に使用されるサービスアカウントのみがコラボレーションメールを受け取ります。

createCollaboration

戻り値:
  • string。作成されたBoxコラボレーションのIDが返されます。
  • エラーが発生した場合はnullが返されます。その場合、mostRecentErrorを確認してください。

createCollaborationOnRecord

戻り値:
  • string。作成されたBoxコラボレーションのIDが返されます。
  • エラーが発生した場合はnullが返されます。その場合、mostRecentErrorを確認してください。

editCollaboration

戻り値:
  • トランザクションが成功したかどうかを示すブール値。
  • パラメータが正しくない場合はfalse

deleteCollaboration

戻り値:
  • トランザクションが成功したかどうかを示すブール値。
  • パラメータが正しくない場合はfalse

検索と検出

サービスアカウントがアクセスできる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形式を使用します。
  • 各操作にはoppathを含める必要があり、操作で必要な場合はvalueも含める必要があります。
  • サポートされている操作には、addreplaceremovetestがあります。
  • このメソッドで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_disabledTRUEに設定するか、グループを使用することをお勧めします。これにより、Slackの設定に関係なく、どのユーザーも削除されなくなります。ファイルがSlackチャンネルにアップロードされると、コラボレーションはSlackに追加されるかSlackから削除されます。
戻り値:
  • トランザクションが成功したかどうかを示すブール値。

deleteIntegrationMapping

このツールキットのメソッドでは、エンドポイントを呼び出してマッピングを削除します。 戻り値:
  • トランザクションが成功したかどうかを示すブール値。

mapSfdcRecordToSlackChannel

このツールキットのメソッドでは、上記の統合マッピングメソッドを使用し、以下の4種類のユースケースで使用できるラッパーを提供します。
  1. SalesforceまたはSlackにマッピングが存在しない場合は、Box for Salesforceフォルダ構造にフォルダが作成され、そのフォルダをSlackチャンネルとリンクするための統合マッピングが作成されます。
  2. Salesforceからのマッピングのみ存在する場合は、引き続きそのフォルダが使用され、場所は変更されません。そのフォルダをSlackチャンネルとリンクするための統合マッピングを作成します。
  3. Slackからのマッピングのみ存在する場合は、引き続きそのフォルダが使用され、既存のフォルダを使用するためにSalesforceレコード用にFRUPレコードが作成されます。このフォルダは、Salesforceルートフォルダ外に存在する可能性があります。
  4. SalesforceとSlackに既存のマッピングがあるものの、相互に関連付けられていない場合は、Toolkit.mostRecentErrorまたはフローアクション内でエラーがスローされ、マッピングがすでに存在することが示されます。
このメソッド/呼び出し可能なアクションは、Box for SalesforceパッケージのCreate Box Folder/Slack Channel Mappingで提供されるフローテンプレートで使用されています。
Slackチャンネルにマッピングする場合、access_management_disabledはデフォルトでFALSEに設定されます。これにより、Slackチャンネルのメンバーリストに含まれていないコラボレータは自動的に削除されます。組織がBoxでの共有をどのように設定しているかに応じて、setSlackChannelAccessManagementDisabledメソッドを使用してaccess_management_disabledTRUEに設定するか、グループを使用することをお勧めします。これにより、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を確認してください。
使用上の注意事項:
  • このメソッドでは、サービスアカウント認証を使用します。
  • 各ドキュメント構成には、fileNamedataの値など、生成されたファイル名と、テンプレートのマージデータが含まれている必要があります。
  • ドキュメント生成は非同期的に実行されます。バッチのステータスを確認するには、getDocGenBatchを使用してください。
  • このメソッドでnullが返された場合には、mostRecentErrorを確認してください。

getDocGenBatch

ドキュメント生成バッチのステータスと詳細を取得します。 戻り値:
  • バッチのステータスと生成されたファイルの詳細を含むDocGenBatchオブジェクト。
  • バッチが取得されなかった場合はnull。この場合には、mostRecentErrorを確認してください。
使用上の注意事項:
  • このメソッドでは、サービスアカウント認証を使用します。
  • このメソッドを定期的にポーリングしてバッチの進行状況を監視してください。
  • バッチのステータスにはpendingprocessingcompletedfailedがあります。
  • 生成されたファイルの詳細は、バッチ完了後に利用可能になります。
  • このメソッドで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によって適用された設定が反映されます。
最終更新日 2026年7月8日