Untergeordnete Elemente des Ordners auflisten

from frameio import Frameio
client = Frameio(
    token="YOUR_TOKEN_HERE",
)
client.folders.index(
    account_id="5c77ab31-41ee-432a-8013-5ec57eb95e6b",
    folder_id="2cf94114-e51a-44d7-809f-3582226192a1",
    include="media_links.original",
)

{
  "data": [
    {
      "type": "file",
      "created_at": "2023-09-25T19:18:29.614189Z",
      "file_size": 1137444,
      "id": "b4c00e24-9beb-4c38-91ad-8f58a88f5a8a",
      "media_type": "image/png",
      "name": "asset.png",
      "parent_id": "6ecaf9c3-23ab-4031-8dc8-8acbfec1afbd",
      "project_id": "70e467b0-c8ab-4881-9c63-836664103a26",
      "status": "created",
      "updated_at": "2024-02-07T16:44:41.986478Z",
      "view_url": "https://next.frame.io/project/d5e6011c-2bc9-4596-be05-77d562627112/view/5a89a9fb-0900-4b23-826b-127b90e4db4c",
      "adobe_id": "urn:aaid:sc:US:a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "adobe_version_id": "2",
      "creator": {
        "active": true,
        "avatar_url": "https://assets.frame.io/uploads/cd58cb8e-24b3-4448-8d0f-9532fcd04d11/original.png?response-content-disposition=attachment%3B+filename%3D%22foo.png&Expires=1729857600&Signature=L09h0pi82dCrMYjr9lMHBragByWYh1&Key-Pair-Id=KKI497NESTHMN",
        "email": "user_email@example.com",
        "id": "196C1A5666BF4EB00A49411B@176719f5667c82b4494214.e",
        "name": "Jon Doe"
      },
      "media_links": {
        "high_quality": {
          "download_url": "https://assets.frame.io/uploads/cd58cb8e-24b3-4448-8d0f-9532fcd04d11/original.png?response-content-disposition=attachment%3B+filename%3D%22foo.png&Expires=1729857600&Signature=L09h0pi82dCrMYjr9lMHBragByWYh1&Key-Pair-Id=KKI497NESTHMN"
        },
        "original": {
          "download_url": "https://assets.frame.io/uploads/cd58cb8e-24b3-4448-8d0f-9532fcd04d11/original.png?response-content-disposition=attachment%3B+filename%3D%22foo.png&Expires=1729857600&Signature=L09h0pi82dCrMYjr9lMHBragByWYh1&Key-Pair-Id=KKI497NESTHMN",
          "inline_url": "https://assets.frame.io/uploads/cd58cb8e-24b3-4448-8d0f-9532fcd04d11/original.png?response-content-disposition=inline%3B+filename%3D%22foo.png&Expires=1729857600&Signature=L09h0pi82dCrMYjr9lMHBragSDFXDFh&1Key-Pair-Id=KKI497NESTHMN"
        },
        "thumbnail": {
          "download_url": "https://assets.frame.io/uploads/cd58cb8e-24b3-4448-8d0f-9532fcd04d11/original.png?response-content-disposition=attachment%3B+filename%3D%22foo.png&Expires=1729857600&Signature=L09h0pi82dCrMYjr9lMHBragByWYh1&Key-Pair-Id=KKI497NESTHMN",
          "url": "https://picture2.frame.io/image/s3://frameio-assets-development/image/cd58cb8e-24b3-4498-8d0f-9532fcd04d11/image_full.png?alg=HS256&sig=0_u7w_wz2MwQHOXp000ibbQSMRijujyaUu8V3YYPxu4&exp=1729857600"
        }
      },
      "metadata": [
        {
          "field_type": "select",
          "field_definition_id": "36279dd3-a607-432e-ad85-2005522b3c4e",
          "field_definition_name": "Fields definition name",
          "mutable": true,
          "value": [
            {
              "display_name": "Display name",
              "id": "6711d43d-b717-4765-bde4-994bf39f88df"
            }
          ],
          "field_options": [
            {
              "display_name": "Display name",
              "id": "6711d43d-b717-4765-bde4-994bf39f88df"
            },
            {
              "display_name": "Display name 2",
              "id": "6f10a133-919f-43f0-8e67-13efc50ba439"
            }
          ]
        }
      ],
      "project": {
        "created_at": "2024-01-25T19:18:29.614189Z",
        "id": "90d3f72c-abed-463f-8d1b-1c3c084556e1",
        "name": "My Project",
        "root_folder_id": "a8426cb1-5056-4010-92d0-416e2c0d3a78",
        "status": "active",
        "storage": 15000,
        "updated_at": "2024-02-07T16:44:41.986478Z",
        "view_url": "https://next.frame.io/project/d5e6011c-2bc9-4596-be05-77d562627112/",
        "workspace_id": "f9cc69f8-c0f8-4176-9eb1-3049c4b6b647",
        "description": "Project Description",
        "adobe_id": "urn:aaid:sc:US:9f4e4d7a-4b6b-4c4f-9f00-b31a91cfc6f3",
        "restricted": false,
        "owner": {
          "active": true,
          "avatar_url": "https://assets.frame.io/uploads/cd58cb8e-24b3-4448-8d0f-9532fcd04d11/original.png?response-content-disposition=attachment%3B+filename%3D%22foo.png&Expires=1729857600&Signature=L09h0pi82dCrMYjr9lMHBragByWYh1&Key-Pair-Id=KKI497NESTHMN",
          "email": "user_email@example.com",
          "id": "196C1A5666BF4EB00A49411B@176719f5667c82b4494214.e",
          "name": "Jon Doe"
        }
      }
    }
  ],
  "links": {
    "next": "/v4/accounts/123/folders/123/folders"
  },
  "total_count": 10
}

Die untergeordneten Elemente im angegebenen Ordner auflisten.

Den Abfrageparameter ‘include’ verwenden, um in der Antwort gezielt zusätzliche Eigenschaften einzuschließen.

Hinweis: Wenn Sie ‘media_links.original’ einschließen und der oder die Benutzende keine Berechtigung hat, Dateien im entsprechenden Projekt herunterzuladen, antwortet dieser Endpunkt mit einem Fehler vom Typ ‘403 Forbidden’. Wenn der Inhalt nicht zugänglich ist, weil für diesen Benutzenden oder diese Benutzende ein Wasserzeichen erforderlich ist und dies von den angeforderten media_links nicht unterstützt wird, ist die Anfrage zwar erfolgreich, aber die nicht unterstützten Medienlinks werden auf null gesetzt. Genauso gilt: Wenn für eine bestimmte Datei kein angeforderter Transcode-Link existiert (z. B. wenn Sie ‘media_links.video_h264_180’ bei einer statischen Grafikdatei einschließen) oder der Transcoding-Prozess noch nicht abgeschlossen ist (d. h. der ‘status’ der Datei ist „hochgeladen“ statt „transkodiert“), wird der Medienlink in der Antwort-Payload ebenfalls auf null gesetzt. Kurz gesagt: Der Client muss null-Medienlinks zuverlässig verarbeiten.
Rate-Limits: 100 Aufrufe pro 1,00 Minute(n) pro account_user

Die untergeordneten Elemente im angegebenen Ordner auflisten. <br/> Den Abfrageparameter 'include' verwenden, um in der Antwort gezielt zusätzliche Eigenschaften einzuschließen. <br/> Hinweis: Wenn Sie 'media_links.original' einschließen und der oder die Benutzende keine Berechtigung hat, Dateien im entsprechenden Projekt herunterzuladen, antwortet dieser Endpunkt mit einem Fehler vom Typ '403 Forbidden'. Wenn der Inhalt nicht zugänglich ist, weil für diesen Benutzenden oder diese Benutzende ein Wasserzeichen erforderlich ist und dies von den angeforderten media_links nicht unterstützt wird, ist die Anfrage zwar erfolgreich, aber die nicht unterstützten Medienlinks werden auf null gesetzt. Genauso gilt: Wenn für eine bestimmte Datei kein angeforderter Transcode-Link existiert (z. B. wenn Sie 'media_links.video_h264_180' bei einer statischen Grafikdatei einschließen) oder der Transcoding-Prozess noch nicht abgeschlossen ist (d. h. der 'status' der Datei ist „hochgeladen“ statt „transkodiert“), wird der Medienlink in der Antwort-Payload ebenfalls auf null gesetzt. Kurz gesagt: Der Client muss null-Medienlinks zuverlässig verarbeiten. <br/>Rate-Limits: 100 Aufrufe pro 1,00 Minute(n) pro account_user

Authentifizierung

AuthorizationBearer

Bearer-Authentifizierung der Form Bearer <token>, wobei token Ihr Auth-Token ist.

Pfadparameter

account_idstringErforderlich

Eine Frame.io- oder Adobe-Entitäts-ID. Normalerweise eine Frame.io-UUID. Für Konten, Projekte, Ordner, Dateien und Versionsstapel, die sich im Adobe Cloud-Speicher befinden (was bei Workfront-verbundenen Konten und -Projekten der Fall ist), kann aber auch eine von Adobe vergebene ID verwendet werden. Diese IDs müssen das Präfix ‘adobe:’ haben (z. B. ‘adobe:<adobe_org_id>’ für ein Konto, ‘adobe:<adobe_asset_id>’ für ein Projekt oder einen Ordner, ‘adobe:<adobe_asset_id>|<version>’ für ein Datei-Asset).

Eine Frame.io- oder Adobe-Entitäts-ID. Normalerweise eine Frame.io-UUID. Für Konten, Projekte, Ordner, Dateien und Versionsstapel, die sich im Adobe Cloud-Speicher befinden (was bei Workfront-verbundenen Konten und -Projekten der Fall ist), kann aber auch eine von Adobe vergebene ID verwendet werden. Diese IDs müssen das Präfix 'adobe:' haben (z. B. 'adobe:<adobe_org_id>' für ein Konto, 'adobe:<adobe_asset_id>' für ein Projekt oder einen Ordner, 'adobe:<adobe_asset_id>|<version>' für ein Datei-Asset).

folder_idstringErforderlich

Eine Frame.io- oder Adobe-Entitäts-ID. Normalerweise eine Frame.io-UUID. Für Konten, Projekte, Ordner, Dateien und Versionsstapel, die sich im Adobe Cloud-Speicher befinden (was bei Workfront-verbundenen Konten und -Projekten der Fall ist), kann aber auch eine von Adobe vergebene ID verwendet werden. Diese IDs müssen das Präfix 'adobe:' haben (z. B. 'adobe:<adobe_org_id>' für ein Konto, 'adobe:<adobe_asset_id>' für ein Projekt oder einen Ordner, 'adobe:<adobe_asset_id>|<version>' für ein Datei-Asset).

Abfrageparameter

includeenumOptional

Unterstützt werden unter anderem Abfrageparameterwerte für Endpunkte, die Dateien mit Medien-Links ausgeben

typestringOptional

Typ-Filter für untergeordnete Elemente eines Ordners

afterstringOptional

Undurchsichtiger Cursor-Abfrageparameter für Anfragen, die paginierte Ergebnisse zurückgeben.

HINWEIS: Dieser Wert wird automatisch generiert und als Teil von Links aus einer vorherigen Antwort eingefügt. Er ist nicht dafür vorgesehen, für Menschen lesbar zu sein.

page_sizeintegerOptional1-500Standardwert ist 50

Seitengrößen-Abfrageparameter für Asset-Listenanfragen

include_total_countbooleanOptionalStandardwert ist false

Seiten-Abfrageparameter zum Einbeziehen der Anzahl aller Entitäten

Antwort-Header

x-ratelimit-limitinteger

Rate-Limit

x-ratelimit-remaininginteger

Verbleibendes Rate-Limit

x-ratelimit-windowinteger

Rate-Limit-Fenster in Millisekunden

Antwort

datalist of objects

Elemente

linksobject

Links zu paginierten Daten

total_countinteger or nullOptional

Gesamtanzahl

Fehler

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

422

Unprocessable Entity Error

429

Too Many Requests Error

Die untergeordneten Elemente im angegebenen Ordner auflisten.

Den Abfrageparameter ‘include’ verwenden, um in der Antwort gezielt zusätzliche Eigenschaften einzuschließen.