Rust Google Play API库google-androidpublisher3的使用指南

概述

google-androidpublisher3是一个Rust库，提供了与Google Play Developer API的集成，允许开发者通过Rust程序管理Android应用发布、内购商品和订阅等内容。

主要功能

• 管理应用发布和更新
• 处理应用内购买和订阅
• 获取应用统计数据和评论
• 管理测试版和Alpha/Beta发布渠道

安装

在Cargo.toml中添加依赖：

[dependencies]
google-androidpublisher3 = "3.0.0"
hyper = "0.14"
hyper-rustls = "0.23"
yup-oauth2 = "7.0"

基本使用方法

1. 认证设置

首先需要设置Google Play API的认证凭据：

use google_androidpublisher3::{AndroidPublisher, oauth2, hyper, hyper_rustls};

async fn get_android_publisher() -> Result<AndroidPublisher, Box<dyn std::error::Error>> {
    let secret: oauth2::ServiceAccountKey = oauth2::read_service_account_key("service-account.json")
        .await?;
    
    let auth = oauth2::ServiceAccountAuthenticator::builder(secret)
        .build()
        .await?;
    
    let hub = AndroidPublisher::new(
        hyper::Client::builder().build(
            hyper_rustls::HttpsConnectorBuilder::new()
                .with_native_roots()
                .https_or_http()
                .enable_http1()
                .build()
        ),
        auth
    );
    
    Ok(hub)
}

2. 获取应用信息

async fn get_app_info(package_name: &str) -> Result<(), Box<dyn std::error::Error>> {
    let hub = get_android_publisher().await?;
    
    let result = hub.apps().get(package_name)
        .doit()
        .await?;
    
    println!("App Info: {:?}", result.1);
    Ok(())
}

3. 上传APK

async fn upload_apk(package_name: &str, apk_path: &str) -> Result<(), Box<dyn std::error::Error>> {
    let hub = get_android_publisher().await?;
    
    let mut apk_file = std::fs::File::open(apk_path)?;
    let mut apk_data = Vec::new();
    apk_file.read_to_end(&mut apk_data)?;
    
    let result = hub.edits()
        .apks_upload(package_name, &Default::default())
        .upload(apk_data, "application/vnd.android.package-archive".parse()?)
        .await?;
    
    println!("Uploaded APK: {:?}", result.1);
    Ok(())
}

4. 管理内购商品

async fn list_in_app_products(package_name: &str) -> Result<(), Box<dyn std::error::Error>> {
    let hub = get_android_publisher().await?;
    
    let result = hub.inappproducts()
        .list(package_name)
        .doit()
        .await?;
    
    println!("In-app products: {:?}", result.1);
    Ok(())
}

高级用法

发布新版本

async fn publish_release(package_name: &str, version_code: i32, track: &str) -> Result<(), Box<dyn std::error::Error>> {
    let hub = get_android_publisher().await?;
    
    // 1. 创建新的编辑
    let edit = hub.edits().insert(package_name, &Default::default())
        .doit()
        .await?;
    let edit_id = edit.1.id.as_ref().unwrap();
    
    // 2. 更新轨道
    let track_update = google_androidpublisher3::api::Track {
        track: Some(track.to_string()),
        version_codes: Some(vec![version_code]),
        ..Default::default()
    };
    
    hub.edits().tracks_update(track_update, package_name, edit_id, track)
        .doit()
        .await?;
    
    // 3. 提交编辑
    hub.edits().commit(package_name, edit_id)
        .doit()
        .await?;
    
    println!("Successfully published version {} to {} track", version_code, track);
    Ok(())
}

完整示例代码

use google_androidpublisher3::{AndroidPublisher, oauth2, hyper, hyper_rustls};
use std::fs::File;
use std::io::Read;

// 认证设置
async fn get_android_publisher() -> Result<AndroidPublisher, Box<dyn std::error::Error>> {
    let secret: oauth2::ServiceAccountKey = oauth2::read_service_account_key("service-account.json")
        .await?;
    
    let auth = oauth2::ServiceAccountAuthenticator::builder(secret)
        .build()
        .await?;
    
    let hub = AndroidPublisher::new(
        hyper::Client::builder().build(
            hyper_rustls::HttpsConnectorBuilder::new()
                .with_native_roots()
                .https_or_http()
                .enable_http1()
                .build()
        ),
        auth
    );
    
    Ok(hub)
}

// 完整应用管理示例
async fn manage_android_app(package_name: &str, apk_path: Option<&str>) -> Result<(), Box<dyn std::error::Error>> {
    // 1. 获取API客户端
    let hub = get_android_publisher().await?;
    
    // 2. 获取应用信息
    let app_info = hub.apps().get(package_name)
        .doit()
        .await?;
    println!("应用信息: {:?}", app_info.1);
    
    // 3. 如果有APK路径，则上传APK
    if let Some(path) = apk_path {
        let mut apk_file = File::open(path)?;
        let mut apk_data = Vec::new();
        apk_file.read_to_end(&mut apk_data)?;
        
        let upload_result = hub.edits()
            .apks_upload(package_name, &Default::default())
            .upload(apk_data, "application/vnd.android.package-archive".parse()?)
            .await?;
        println!("APK上传结果: {:?}", upload_result.1);
    }
    
    // 4. 获取内购商品列表
    let products = hub.inappproducts()
        .list(package_name)
        .doit()
        .await?;
    println!("内购商品列表: {:?}", products.1);
    
    Ok(())
}

#[tokio::main]
async fn main() {
    let package_name = "com.example.myapp";
    
    if let Err(e) = manage_android_app(package_name, Some("path/to/app.apk")).await {
        eprintln!("应用管理出错: {}", e);
        if let Some(source) = e.source() {
            eprintln!("错误原因: {}", source);
        }
    }
}

注意事项

1. 需要先在Google Play Console中设置服务账号并下载JSON凭证文件
2. 服务账号需要有适当的权限（如"Release Manager"或"Financial Data"等）
3. 某些操作可能需要等待Google Play处理完成才能看到效果

错误处理

建议对API调用进行适当的错误处理：

match hub.apps().get(package_name).doit().await {
    Ok((_response, app_info)) => {
        println!("App info: {:?}", app_info);
    }
    Err(e) => {
        eprintln!("Error getting app info: {}", e);
        if let Some(err) = e.source() {
            eprintln!("Caused by: {}", err);
        }
    }
}

这个库提供了对Google Play Developer API的全面访问，可以自动化许多应用发布和管理任务。