youtube data api 操作中的 body 参数是什么？

Question

我正在使用 python 学习 Youtube Data API。
我关注了他们的guide，并且能够了解哪些资源及其支持的操作是什么。我知道part 和filed 参数从同一页面传入操作。

例如

    playlists_insert_response = youtube.playlists().insert(
       part="snippet,status",
       body=dict(
          snippet=dict(
             title="Test Playlist",
             description="A private playlist created with the YouTube API v3"
             ),
          status=dict(
             privacyStatus="private"
         )
       )
    ).execute()

在这个示例代码中，我们必须将参数传递给insert() 可能的参数是part 和fields。但有些例子我也将 body 视为参数。我无法理解。

谁能告诉我为什么我们在操作中传递body 参数？它到底是什么？
我正在尝试理解来自here 的示例代码。

Answer 1

Youtube 实际上提供了一种 REST API，其中每个请求都是对某个 URL 的 HTTP 请求。您使用的 python 客户端库只是此 API 的前端，它将实际的 HTTP 请求隐藏在函数调用后面。

python 库中的 body 参数允许您指定 HTTP 请求正文。例如，要插入播放列表，您需要提供 playlist 资源作为请求正文。

此参数仅适用于 PUT 和 POST 请求（插入和更新），当您需要指定一些资源内容时。