画像メタデータとDAMについて

{
   "BoxNormalized": 1 attribute,
   "File": 9 attributes,
   "JFIF": 4 attributes,
   "EXIF": 49 attributes,
   "MakerNotes": 19 attributes,
   "MPF": 9 attributes,
   "ICC_Profile": 17 attributes,
   "JPEG": 1 attribute 
}  
Sample quicktime video file
 {
   "BoxNormalized": 1 attribute,
   "File": 3 attributes,
   "QuickTime": 52 attributes 
}

def fetch_representation(
   client: BoxClient,
   file_id: str,
   rep_hint: str,
   token: str,
   asset_path: str = "",
   max_wait_seconds: int = 30,
   poll_interval: int = 3,
) -> bytes | None:
    file = client.files.get_file_by_id(
       file_id,
       fields=["representations"],
       x_rep_hints=rep_hint,
   )


   entries = (
       file.representations.entries
   )
   rep = entries[0]
   state = rep.status.state


   state_str = state.value if state else "unknown"
   url_template = rep.content.url_template
   print(f"state: {state_str}  |  url_template: {url_template}")

state: none  |  url_template: https://dl.boxcloud.com/api/2.0/internal_files/2163735367009/versions/2392182789409/representations/embedded_metadata/content/{+asset_path}

if state == FileFullRepresentationsEntriesStatusStateField.NONE:
       print("State is 'none' - triggering generation via info URL...")
       if rep.info and rep.info.url:
           requests.get(rep.info.url, headers={"Authorization": f"Bearer {token}"})
       state = FileFullRepresentationsEntriesStatusStateField.PENDING


   # Poll until ready or timed out
   elapsed = 0
   while state == FileFullRepresentationsEntriesStatusStateField.PENDING:
       if elapsed >= max_wait_seconds:
           print(f"Timed out after {max_wait_seconds}s waiting for representation.")
           return None
       print(f"  State is 'pending' - waiting {poll_interval}s... (elapsed: {elapsed}s)")
       time.sleep(poll_interval)
       elapsed += poll_interval


       file = client.files.get_file_by_id(
           file_id,
           fields=["representations"],
           x_rep_hints=rep_hint,
       )
       entries = (
           file.representations.entries
       )
       rep = entries[0]
       state = rep.status.state if rep.status else None


   ready_states = {
       FileFullRepresentationsEntriesStatusStateField.SUCCESS,
       FileFullRepresentationsEntriesStatusStateField.VIEWABLE,
   }
   if state not in ready_states:
       print(f"Representation ended in unexpected state: {state}")
       return None


   url_template = rep.content.url_template


   download_url = url_template.replace("{+asset_path}", asset_path)
   response = requests.get(
       download_url,
       headers={"Authorization": f"Bearer {token}"},
       allow_redirects=True,
   )
   response.raise_for_status()
   return response.content

[
  {
    "BoxNormalized": {
      "PageCount": null
    },
    "File": {
      "FileType": "JPEG",
      "FileTypeExtension": "jpg",
      "MIMEType": "image/jpeg",
     …truncated 5 fields
    },
    "JFIF": {
      "JFIFVersion": 1.01,
      "ResolutionUnit": "inches",
      "XResolution": 300,
      "YResolution": 300
    },
    "EXIF": {
      "Make": "Apple",
      "Model": "iPhone 14",
      "Orientation": "Horizontal (normal)",
     …truncated 48 fields
    },
    "MakerNotes": {
      "MakerNoteVersion": 15,
      "RunTimeFlags": "Valid",
      "RunTimeValue": 6241807022333,
    …truncated 15 fields
    },
    "MPF": {
      "MPFVersion": "0100",
      "NumberOfImages": 2,
      "MPImageFlags": "(none)",
     …truncated 6 fields
    },
    "ICC_Profile": {
      "ProfileCMMType": "Apple Computer Inc.",
      "ProfileVersion": "4.0.0",
      …truncated 19 fields
    },
    "JPEG": {
      "HDRGainCurve": "(Binary data 1392 bytes, use -b option to extract)"
    }
  }
]