Xamarin.Forms调用Google Sheets API使用UserCredential授权报错如何解决

问题根因 #

• 第一个NullReference异常：你构造UserCredential时传入了null的授权码/Token参数，没有完成完整的OAuth授权流程，生成的credential本身就是无效对象；同时你没有在SheetsService初始化阶段传入有效凭证，仅后续手动赋值HttpClientInitializer不会被客户端库识别，导致请求时Credential属性为null。
• 第二个浏览器启动异常：GoogleWebAuthorizationBroker是为桌面端（控制台、WPF、WinForm）设计的授权类，没有适配Xamarin.Forms移动端的浏览器唤起逻辑，所以无法拉起授权页直接报错。
• GoogleCredential无法访问私有表：你使用的是无身份的匿名凭证，或者服务账号模式下未将服务账号的邮箱地址添加到目标私有表格的共享用户列表中，没有授予对应读写权限。

可行解决方案 #

方案一：服务账号模式（最适合你的场景，无需用户手动授权） #

你仅需要修改固定的私有表格，不需要区分不同用户身份，用服务账号方案最简单：

1. 在Google Cloud控制台创建服务账号，下载JSON格式的密钥文件，嵌入到你的Xamarin项目资源中。
2. 打开目标私有Google Sheet，点击共享，将服务账号JSON中的client_email字段对应的邮箱地址添加为共享用户，授予编辑权限。
3. 初始化凭证和服务的代码如下：

// 读取嵌入的服务账号密钥文件流
using var stream = Assembly.GetExecutingAssembly().GetManifestResourceStream("你的项目命名空间.服务账号密钥.json");
var credential = GoogleCredential.FromStream(stream)
    .CreateScoped(SheetsService.Scope.Spreadsheets);

// 正确初始化SheetsService
var service = new SheetsService(new BaseClientService.Initializer
{
    HttpClientInitializer = credential,
    ApplicationName = "你的应用名称"
});

// 后续请求逻辑不变
string spreadsheetId = "你的表格ID", range = "你的单元格范围";
var request = service.Spreadsheets.Values.Get(spreadsheetId, range);
var resp = request.Execute();

方案二：用户OAuth授权模式（需要用户登录谷歌账号） #

如果必须用指定用户的身份访问表格，就自己实现移动端适配的授权流程：

1. 在Google Cloud控制台分别创建Android、iOS端的OAuth客户端ID，填入对应端的包名、签名哈希信息。
2. 使用Xamarin.Essentials的WebAuthenticator完成谷歌OAuth授权流程，拿到授权码后交换为access_token和refresh_token，自行构造UserCredential对象。
3. 初始化SheetsService时将有效UserCredential传入构造参数的HttpClientInitializer字段即可。

内容的提问来源于stack exchange，提问作者Łukasz Włodarczyk