Untergeordnete Elemente des Versionsstapels auflisten

from frameio import Frameio
client = Frameio(
    token="YOUR_TOKEN_HERE",
)
client.version_stacks.index(
    account_id="a17fe10b-3d45-4fad-b695-fa92651520ec",
    version_stack_id="bbdfd455-6868-4519-b43c-11485e8e9ee3",
    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/version_stacks"
  },
  "total_count": 10
}

Die untergeordneten Elemente (Dateien) in einem bestimmten Versionsstapel auflisten.

Den Abfrageparameter ‘include’ nutzen, um zusätzliche Eigenschaften gezielt in die Antwort aufzunehmen.

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 bzw. diese Benutzende Wasserzeichen erforderlich sind und dies von den angeforderten media_links nicht unterstützt wird, ist die Anfrage zwar erfolgreich, aber die nicht unterstützten Medien-Links werden auf null gesetzt. Wenn ein angeforderter Transcode-Link für eine bestimmte Datei nicht vorhanden ist (z. B. wenn Sie ‘media_links.video_h264_180’ bei einer Grafikdatei einschließen) oder der Transcodierungsvorgang noch nicht abgeschlossen ist (d. h. der ‘status’ der Datei ist „hochgeladen“ statt „transkodiert“), wird ein Medien-Link in der Antwortnutzlast ebenfalls auf null gesetzt. Kurz gesagt: Der Client muss null Medien-Links korrekt verarbeiten.
Rate-Limits: 100 Aufrufe pro 1,00 Minute(n) pro account_user

Die untergeordneten Elemente (Dateien) in einem bestimmten Versionsstapel auflisten. <br/> Den Abfrageparameter 'include' nutzen, um zusätzliche Eigenschaften gezielt in die Antwort aufzunehmen. <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 bzw. diese Benutzende Wasserzeichen erforderlich sind und dies von den angeforderten media_links nicht unterstützt wird, ist die Anfrage zwar erfolgreich, aber die nicht unterstützten Medien-Links werden auf null gesetzt. Wenn ein angeforderter Transcode-Link für eine bestimmte Datei nicht vorhanden ist (z. B. wenn Sie 'media_links.video_h264_180' bei einer Grafikdatei einschließen) oder der Transcodierungsvorgang noch nicht abgeschlossen ist (d. h. der 'status' der Datei ist „hochgeladen“ statt „transkodiert“), wird ein Medien-Link in der Antwortnutzlast ebenfalls auf null gesetzt. Kurz gesagt: Der Client muss null Medien-Links korrekt 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).

version_stack_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

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-100Standardwert ist 50

Seitengröße-Abfrageparameter für Anfragen

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 (Dateien) in einem bestimmten Versionsstapel auflisten.

Den Abfrageparameter ‘include’ nutzen, um zusätzliche Eigenschaften gezielt in die Antwort aufzunehmen.