機械翻訳について

移動先

• リクエスト
• レスポンス
• 例

フォルダの所有権の変更

post

/documents/api/1.2/folders/{folderId}/changeOwnership

指定したフォルダの所有権を変更し、リクエスト者マネージャに指定したフォルダへのアクセス権を付与します。

ノート:

フォルダの所有権を変更するには、依頼者はフォルダの管理者権限を持っている必要があります。 つまり、リクエスタは所有者であるか、管理者ロールが必要ということです。

リクエスト

サポートされるメディア・タイプ

• application/json
• application/xml

パス・パラメータ

• folderId: string

  変更するフォルダのグローバル一意識別子(GUID)。

本文 ()

リクエスト本文では、フォルダ・リクエストの所有権の変更の詳細を定義します。 すべてのパラメータが必要です。

ルート・スキーマ : FolderChangeOwnershipBody

タイプ: object

リクエスト本文では、フォルダ・リクエストの所有権の変更の詳細を定義します。 すべてのパラメータが必要です。

ソースを表示

• targetUserID: string
  (必須)グローバル一意識別子(GUID)またはフォルダの新規所有者のログイン名を指定します。

{
    "description":"<p>The request body defines details of the change ownership of the folder request. All parameters are required.</p>",
    "properties":{
        "targetUserID":{
            "type":"string",
            "description":"(Required) Specify the globally unique identifier (GUID) or the login name of the new owner of the folder."
        }
    },
    "required":[
        "targetUserID"
    ]
}

リクエストの例(application/json)

{
    "targetUserID":"cecsadminb"
}

トップに戻る

レスポンス

サポートされるメディア・タイプ

• application/json
• application/xml

200レスポンス

リクエストが処理されました。

本文 ()

ルート・スキーマ : FolderChangeOwnershipResponse

タイプ: object

レスポンス本文には、フォルダの変更所有権に関する情報が含まれます。

ソースを表示

• errorCode(optional): string
  エラー・コードがゼロ(0)の場合は、エラーなしです
• id(optional): string
  変更されたフォルダのグローバル一意識別子(GUID)。
• targetUserID(optional): string
  グローバルに一意の識別子(GUID)またはフォルダの新しい所有者のログイン名。
• type(optional): string
  アイテム・タイプfolder。

{
    "description":"The response body includes information about the change ownership of the folder.",
    "properties":{
        "targetUserID":{
            "type":"string",
            "description":"Globally unique identifier (GUID) or the login name of the new owner of the folder."
        },
        "id":{
            "type":"string",
            "description":"Globally unique identifier (GUID) of the folder that was changed."
        },
        "type":{
            "type":"string",
            "description":"Item type <code>folder</code>."
        },
        "errorCode":{
            "type":"string",
            "description":"An error code of zero (0) indicates no errors."
        }
    }
}

レスポンスの例(application/json)

{
    "targetUserID":"cecsadminb",
    "id":"FC6FB38E75C284E70934F6221B1E5B8F7FDF5701EE84",
    "type":"folder",
    "errorCode":"0"
}

400レスポンス

リクエスト・パラメータが正しい形式ではありません。

403レスポンス

ユーザーに読取り権限がない場合は禁止されています。

404レスポンス

フォルダIDが見つかりません。

トップに戻る

例

例1

次の例では、フォルダID FB47F0210E3ED563650E2A1C2B885A869C3D3E4453A5の所有権をユーザーID U50736B544D00DF1EED770AC72F1B43EEA1Fに変更し、そのフォルダをリクエスト者に共有します。

POST ...folders/FB47F0210E3ED563650E2A1C2B885A869C3D3E4453A5/changeOwnership

リクエスト・ヘッダー

なし。

リクエスト本文

{
  "targetUserID":"U50736B544D00DF1EED770AC72F1B43EEA1F"
}

HTTPステータス・コード

HTTP_STATUS = 200

JSONレスポンス

{
   "errorCode": "0", 
   "id": "FB47F0210E3ED563650E2A1C2B885A869C3D3E4453A5", 
   "targetUserID": "U50736B544D00DF1EED770AC72F1B43EEA1F",
   "type": "folder"
}

先頭に戻る