Medienelemente verwalten

Sie können Medienelemente nach dem Hochladen nicht nur aufrufen und abrufen, sondern auch deren Beschreibung ändern.

Erforderlicher Autorisierungsbereich

Zum Ändern von Beschreibungen von in Apps erstellten Inhalten ist die Rolle photoslibrary.edit.appcreateddata erforderlich. Weitere Informationen zu Bereichen finden Sie unter Autorisierungsbereiche.

Beschreibungen von Medienelementen ändern

Wenn du die Beschreibung eines Medienelements ändern möchtest, erstelle eine media items update call mit der ID des Medienelements und füge die neue Beschreibung in die Anfrage ein.

Damit du die Beschreibung eines Medienelements ändern kannst, muss deine App das Medienelement hochgeladen haben und der aktuell authentifizierte Nutzer muss der Eigentümer sein. Beschreibungen dürfen maximal 1.000 Zeichen lang sein.

REST

Hier ist ein PATCH-Anfrageheader zum Aktualisieren der Beschreibung eines Medienelements:

PATCH https://photoslibrary.googleapis.com/v1/mediaItems/media-item-id?updateMask=description

Diese Anfrage bestimmt, welche Attribute aktualisiert werden, indem eine Feldmaske eingefügt wird, die durch den Parameter updateMask in der URL angegeben wird.

Fügen Sie die neue Beschreibung in den Text der Anfrage ein:

{
  "description": "new-media-item-description"
}

Bei Erfolg gibt die Antwort das aktualisierte Medienelement zurück:

{
  "id": "media-item-id",
  "description": "new-media-item-description",
  "productUrl": "media-item-product-url",
  "baseUrl": "media-items-in-album",
  "mimeType": "mime-type-of-media",
  "mediaMetadata": {
    ...
  },
  "contributorInfo": {
    ...
  },
  "fileName": "item-filename"
}