Medienelemente verwalten
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
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.
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"
}
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-05-08 (UTC).
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-05-08 (UTC)."],[[["After uploading media items to Google Photos, you can change their descriptions using the Google Photos API."],["Modifying descriptions of app-created content requires the `photoslibrary.edit.appcreateddata` scope and ownership by the authenticated user."],["To update a description, use the `mediaItems/patch` endpoint with the item's ID and a request body containing the new description."],["The `updateMask` parameter in the request URL specifies that only the description is being modified."],["The response to a successful update request will return the complete updated media item object."]]],["To modify a media item's description, use a `media items update call` with a PATCH request, specifying the item's ID and the `updateMask` parameter. Include the new description in the request body, ensuring it's under 1,000 characters. This requires the `photoslibrary.edit.appcreateddata` scope, with the app having uploaded the media, and the authenticated user must be the owner. A successful request returns the updated media item details, including the new description.\n"]]
