2025 年 4 月 1 日,我们移除了 Library API 中的部分镜重。
点击此处了解详情。
  
        
 
     
  
  
  
    
  
  
  
    
      Method: albums.create
    
    
      
    
    
      
      使用集合让一切井井有条
    
    
      
      根据您的偏好保存内容并对其进行分类。
    
  
    
  
      
    
  
  
  
  
  
  
    
    
    
    
    
    
      
      
      
      
        
          HTTP 请求
          POST https://photoslibrary.googleapis.com/v1/albums
网址采用 gRPC 转码语法。
        
        
          请求正文
          请求正文中包含结构如下的数据:
          
            
              
                
                  | JSON 表示法 | 
              
              
                
                  | {
  "album": {
    object (Album)
  }
} | 
              
            
          
          
            
              
                
                
              
              
                
                  | 字段 | 
              
              
                
                  | album | object (Album)
 必需。要创建的影集。 | 
              
            
          
        
        
          响应正文
          如果成功,响应正文将包含一个新创建的 Album 实例。
        
        
          授权范围
          需要以下 OAuth 范围之一:
          
            - https://www.googleapis.com/auth/photoslibrary.appendonly
 
  
    
    
      
    
    
  
       
    
    
  
  
  如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
  最后更新时间 (UTC):2025-07-25。
  
  
  
    
      [[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["没有我需要的信息","missingTheInformationINeed","thumb-down"],["太复杂/步骤太多","tooComplicatedTooManySteps","thumb-down"],["内容需要更新","outOfDate","thumb-down"],["翻译问题","translationIssue","thumb-down"],["示例/代码问题","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2025-07-25。"],[],["This document details creating albums in a user's Google Photos library via the API.  It uses a `POST` request to `https://photoslibrary.googleapis.com/v1/albums`. The request body, formatted as JSON, requires an `album` object. Successful requests return the newly created `Album` instance. Authorization necessitates specific OAuth scopes: `photoslibrary`, `photoslibrary.appendonly`, or `photoslibrary.sharing`.  Note that scopes will limit interactions with media items, created by the app, after March 31, 2025.\n"]]