如何在 Google Photos API 中为媒体项目添加定位丰富？

Question

阅读有关如何在相册中添加位置媒体项目的 Google Photos API 文档我不明白请求正文应该是什么。 https://developers.google.com/photos/library/guides/add-enrichments#supported-positioning

我想在相册album-1 中将mediaItem-1 移动到mediaItem-2 之前。我的请求正文应该是什么样子？

POST https://photoslibrary.googleapis.com/v1/albums/album-1:addEnrichment
{
    "newEnrichmentItem": {
        enrichment-to-be-added // What goes here?
    },
    "albumPosition": {
        "position": "after-media-item",
        "relativeMediaItemId": "mediaItem-2"
    }
}

编辑：我不想将媒体项目重新上传到云端，因此同一媒体项目只有一个版本。

Answer 1

只能在创建媒体项目或添加丰富内容时指定位置。 无法重新组织相册中的现有媒体项目，因此在添加项目时设置项目的位置很重要。

参考： https://developers.google.com/photos/library/guides/add-enrichments#intro-positions

您使用的方法是用于专辑丰富。

Enrichment Types:

1. 文本丰富

   文本扩充是一个纯文本字符串，可以插入以注释专辑。

2. 位置扩充

   位置扩充是一个标记和可以插入以注释位置的地点名称。

3. 地图丰富

   地图扩充是可以插入相册的具有指定起点和终点的地图。

其他参考： https://developers.google.com/photos/library/reference/rest/v1/albums/addEnrichment?hl=en_US#request-body

---

使用位置创建示例媒体项目： https://developers.google.com/photos/library/reference/rest/v1/mediaItems/batchCreate#request-body

{
  "albumId": string,
  "newMediaItems": [
    {
      object (NewMediaItem)
    }
  ],
  "albumPosition": {
    object (AlbumPosition)
  }
}

专辑位置

• 相册中添加媒体项目的位置。如果未指定，则将媒体项添加到专辑的末尾（按照默认值，即 LAST_IN_ALBUM）。如果设置了该字段且未指定 albumId，则请求失败。如果您设置了该字段并且不是共享相册的所有者，请求也会失败。

---

（更新）

解决方法：

1. 删除专辑 1 中的 mediaItem-2

2. 使用位置参数在专辑 1 中创建 mediaItem-2，将 mediaItem-2 放置在 mediaItem-1 之后 https://developers.google.com/photos/library/reference/rest/v1/AlbumPosition#PositionType

---

您创建媒体项目的请求正文：

{
  "albumId": album-1,
  "newMediaItems": [
    {
      object (mediaItem-2)
    }
  ],
  "albumPosition": {
    "position": AFTER_MEDIA_ITEM.
    "relativeMediaItemId": mediaItem-1
  }
}

---