機械翻訳について

移動先

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

フォルダ・パブリック・リンク取得

get

/documents/api/1.2/publiclinks/folder/{folderId}

指定したフォルダのパブリック・リンクのリストを返します。

リクエスト

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

• application/json
• application/xml

パス・パラメータ

• folderId: string
  フォルダのグローバル一意識別子(GUID)。

トップに戻る

レスポンス

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

• application/json
• application/xml

200レスポンス

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

本文 ()

ルート・スキーマ: FolderLinksResponse

タイプ: object

レスポンス本文には、指定したフォルダに定義されたパブリック・リンクに関する情報が含まれます。

ソースを表示

• count(optional): string
  ページにリストされるアイテムの数
• errorCode(optional): string
  エラー・コードがゼロ(0)の場合は、エラーなしです
• id(optional): string
  フォルダのグローバル一意識別子(GUID)。
• items(optional): array items
  公開リンクのリスト。
• type(optional): string
  アイテム・タイプfolder。

{
    "description":"The response body includes information about public links defined for the specified folder.",
    "properties":{
        "count":{
            "type":"string",
            "description":"The number of items listed on the page."
        },
        "id":{
            "type":"string",
            "description":"Globally unique identifier (GUID) for the folder."
        },
        "type":{
            "type":"string",
            "description":"Item type <code>folder</code>."
        },
        "errorCode":{
            "type":"string",
            "description":"An error code of zero (0) indicates no errors."
        },
        "items":{
            "type":"array",
            "description":"List of public links.",
            "items":{
                "$ref":"#/definitions/PublicLinkDefinition"
            }
        }
    }
}

ネストされたスキーマ: items

タイプ: array

公開リンクのリスト。

ソースを表示

• Array of: object PublicLinkDefinition
  パブリック・リンク情報。

{
    "type":"array",
    "description":"List of public links.",
    "items":{
        "$ref":"#/definitions/PublicLinkDefinition"
    }
}

ネストされたスキーマ: PublicLinkDefinition

タイプ: object

パブリック・リンク情報。

ソースを表示

• assignedUsers(optional): string
  リンクを使用できるユーザーのグループ。
• createdTime(optional): string
  パブリック・リンクが作成された日時。
• expirationTime(optional): string
  パブリック・リンクの期限が切れる日時
• lastModifiedTime(optional): string
  パブリック・リンクが最後に変更された日時
• linkID(optional): string
  パブリック・リンクのグローバル一意識別子(GUID)。
• linkName(optional): string
  パブリック・リンクの名前。
• ownedBy(optional): object User
  ユーザー情報
• password(optional): string
  パブリック・リンクのパスワード。 使用できるのは8文字以上50文字以下です。 パスワードでは、大文字と小文字が区別されます。
• role (オプション): string
  使用可能な値: [ "viewer", "downloader", "contributor" ]

  共有アイテムへのアクセス・レベル
• type(optional): string
  アイテム・タイプpubliclink。

{
    "description":"Public link information.",
    "properties":{
        "linkID":{
            "type":"string",
            "description":"Globally unique identifier (GUID) for the public link."
        },
        "linkName":{
            "type":"string",
            "description":"Name of the public link."
        },
        "assignedUsers":{
            "type":"string",
            "description":"The group of users who can use the link."
        },
        "role":{
            "type":"string",
            "description":"Access level for the shared item.",
            "enum":[
                "viewer",
                "downloader",
                "contributor"
            ]
        },
        "password":{
            "type":"string",
            "description":"Password for the public link. Use a minimum of 8 characters and a maximum of 50 characters. Passwords are case-sensitive."
        },
        "type":{
            "type":"string",
            "description":"Item type <code>publiclink</code>."
        },
        "createdTime":{
            "type":"string",
            "description":"Date and time when the public link was created."
        },
        "expirationTime":{
            "type":"string",
            "description":"Date and time when the public link expires."
        },
        "lastModifiedTime":{
            "type":"string",
            "description":"Date and time when the public link was last modified."
        },
        "ownedBy":{
            "$ref":"#/definitions/User"
        }
    }
}

ネストされたスキーマ: User

タイプ: object

ユーザー情報

ソースを表示

• displayName(optional): string
  ユーザーの表示名
• id(optional): string
  ユーザーのグローバル一意識別子(GUID)。
• loginName(optional): string
  ユーザーのログイン名。
• type(optional): string
  アイテム・タイプuser。

{
    "description":"User information",
    "properties":{
        "id":{
            "type":"string",
            "description":"Globally unique identifier (GUID) for the user."
        },
        "displayName":{
            "type":"string",
            "description":"The display name for the user."
        },
        "loginName":{
            "type":"string",
            "description":"The login name for the user."
        },
        "type":{
            "type":"string",
            "description":"Item type <code>user</code>."
        }
    }
}

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

{
    "count":"2",
    "id":"F4E111D0D0645CD368453C2BT0000000000100000001",
    "type":"folder",
    "errorCode":"0",
    "items":[
        {
            "linkID":"LF31C09DE51854DBBDA37A90T0000000000100000001",
            "linkName":"hasSecondLink",
            "assignedUsers":"@everybody",
            "role":"viewer",
            "type":"publiclink",
            "createdTime":"2015-06-02T19:30:37Z",
            "lastModifiedTime":"2015-06-02T19:30:37Z",
            "ownedBy":{
                "id":"U0EAA20910FAF3052ACB79E4T00000000001",
                "displayName":"User AA",
                "type":"user"
            }
        },
        {
            "linkID":"LF5E5F73A444FFB8924EF8ACT0000000000100000001",
            "linkName":"hasFirstLink",
            "assignedUsers":"@serviceinstance",
            "role":"contributor",
            "type":"publiclink",
            "createdTime":"2015-06-10T16:15:37Z",
            "lastModifiedTime":"2015-06-10T16:15:37Z",
            "ownedBy":{
                "id":"U0EAA20910FAF3052ACB79E4T00000000001",
                "displayName":"User AA",
                "type":"user"
            }
        }
    ]
}

400レスポンス

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

403レスポンス

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

404レスポンス

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

トップに戻る

例

次の例では、指定したフォルダに定義されたパブリック・リンクに関する情報が返されます。

GET .../publiclinks/folder/F4E111D0D0645CD368453C2BT0000000000100000001

リクエスト・ヘッダー

なし。

リクエスト本文

なし。

HTTPステータス・コード

HTTP_STATUS = 200

JSONレスポンス

{
    "count": "2",
    "errorCode": "0",
    "id": "F4E111D0D0645CD368453C2BT0000000000100000001",
    "type": "folder",
    "items": [
        {
            "type": "publiclink",
            "linkID": "LF31C09DE51854DBBDA37A90T0000000000100000001",
            "linkName": "hasSecondLink",
            "ownedBy": {
		            "displayName": "User AA",
		            "loginName": "userAALoginName",
		            "id": "U0EAA20910FAF3052ACB79E4T00000000001",
		            "type": "user"
            },
            "role": "viewer",
            "assignedUsers": "@everybody",
            "createdTime": "2015-06-02T19:30:37Z",
            "lastModifiedTime": "2015-06-02T19:30:37Z"
        },
        {
            "type": "publiclink",
            "linkID": "LF5E5F73A444FFB8924EF8ACT0000000000100000001",
            "linkName": "hasFirstLink",
            "ownedBy": {
		            "displayName": "User AA",
		            "loginName": "userAALoginName",
		            "id": "U0EAA20910FAF3052ACB79E4T00000000001",
		            "type": "user"
            },
            "role": "contributor",
            "assignedUsers": "@serviceinstance",
            "createdTime": "2015-06-10T16:15:37Z",
            "lastModifiedTime": "2015-06-10T16:15:37Z"
        }
    ]
}

例2

次の例は正常に返されますが、フォルダIDにはパブリック・リンクがありません。

GET .../publiclinks/file/F2CD745706AEC8BD04260B2F45B3E9DD64907CA0D19F

リクエスト・ヘッダー

なし。

リクエスト本文

なし。

HTTPステータス・コード

HTTP_STATUS = 200

JSONレスポンス

{
    "count": "0",
    "errorCode": "0",
    "id": "F2CD745706AEC8BD04260B2F45B3E9DD64907CA0D19F",
    "type": "folder"
}

例3

次の例では、フォルダIDが無効なためにエラーが返されます。

GET .../publiclinks/folder/FDDD745706AEC8BD04260B2F45B3E9DD64907CA0D19F

リクエスト・ヘッダー

なし。

リクエスト本文

なし。

HTTPステータス・コード

HTTP_STATUS = 404

JSONレスポンス

{
    "count": "0",
    "errorCode": "-16",
    "errorKey": "!csUnableToRetrieveSharedLinkInfo!csSecurityValidationFailed!csFldDoesNotExist,FDDD745706AEC8BD04260B2F45B3E9DD64907CA0D19F!csUnprivilegedSystemError",
    "errorMessage": "Failed to retrieve shared link information. Security validation failed. 'FDDD745706AEC8BD04260B2F45B3E9DD64907CA0D19F' does not exist. The error was caused by an internally generated issue. The error has been logged.",
    "errorType": "folder",
    "id": "FDDD745706AEC8BD04260B2F45B3E9DD64907CA0D19F",
    "title": "Failed to retrieve shared link information. Security validation failed. 'FDDD745706AEC8BD04260B2F45B3E9DD64907CA0D19F' does not exist. The error was caused by an internally generated issue. The error has been logged.",
    "type": "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html"
}

先頭に戻る