sheets

床单

这是一个与Google Sheets API的版本4相匹配的API。因此，如果您想了解如何使用此API的文档，则必须咨询其API，并使用C＃绑定。顶部还有一个较小的高级层，这对于只需要从2D数组访问数据的人很有用。

要求

• .NET框架4.5

设置序列化器

存在一个抽象的SheetSerializer类，因此您可以使用任何想要的JSON序列化器。

统一序列化器

 using UnityEngine ;

public class JSONSerializer : SheetsSerializer
{
    public override T DeserializeObject < T > ( string data )
    {
        return JsonUtility . FromJson < T > ( data ) ;
    }

    public override string SerializeObject ( object data )
    {
        return JsonUtility . ToJson ( data ) ;
    }
}

NetWonsoft.json Serializer

 using Newtonsoft . Json ;

public class JSONSerializer : SheetsSerializer
{
    public override T DeserializeObject < T > ( string data )
    {
        return JsonConvert . DeserializeObject < T > ( data ) ;
    }

    public override string SerializeObject ( object data )
    {
        return JsonConvert . SerializeObject ( data ) ;
    }
} 

例子

使用Google表API的要求是具有电子表格和访问令牌。可以从URL检索电子表格。您还需要为SheetsSerializer.Serializer提供serializer属性，并带有您自己的序列化器对象。

https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}

可以从Google API控制台创建API令牌，有关此信息，请访问Google这篇文章

 public async void Start ( )
{
    SheetsSerializer . Serializer = new SheetsSerializer ( ) ; //TODO: Create your own custom serializer/deserializer
    string spreadsheetId = "" ; //TODO: Get your own spreadsheetId
    string key = "" ;         //TODO: Get your own key token
    
    Authorization authorization = await Authorization . Authorize ( key ) ;
    Spreadsheet spreadsheet = await Spreadsheet . Get ( spreadsheetId , authorization ) ;

    Debug . Log ( "URL: " + spreadsheet . URL ) ;
    Debug . Log ( "Title: " + spreadsheet . Title ) ;
    
    Sheet sheet = spreadsheet . Sheets [ 0 ] ;
    Debug . Log ( "Rows: " + sheet . Rows ) ;
    Debug . Log ( "Columns: " + sheet . Columns ) ;
    
    Cell [ , ] data = sheet . Data ;
    for ( int x = 0 ; x < sheet . Columns ; x ++ )
    {
        for ( int y = 0 ; y < sheet . Rows ; y ++ )
        {
            Debug . Log ( data [ x , y ] . Value ) ;
        }
    }
}

如果您想使用低级API，则可以使用GetRaw()方法而不是Get() 。原始方法替代方案将给出一个与Google API参考相同的SpreadsheetRaw对象。

如果您想同时使用低水平和高级别，则可以通过将其传递到构造函数中创建一个从低级别的电子表格创建电子表格。可以将原始纸转换为高级床单也可以做同样的事情。这不能以相反的方式及其设计。

 SheetsSerializer . Serializer = new SheetsSerializer ( ) ;
string key = "" ; //TODO: Get a key
Authorization authorization = await Authorization . Authorize ( key ) ;

SpreadsheetRaw raw = await SpreadsheetRaw . Get ( spreadsheetId , token , includeGridData ) ;
Spreadsheet spreadsheet = await Spreadsheet . Get ( spreadsheetId , token , serializer ) ;

//create a new spreadsheet from the raw data
Spreadsheet spreadsheetConverted = new Spreadsheet ( raw ) ; 

授权

实施了两种授权方法。使用OAUTH客户端ID和客户端秘密，或使用Google开发人员控制台提供的提供的密钥。

使用键

 string key = "" ;
Authorizer authorizer = await Authorizer . Authorizer ( key ) ;

使用Oauth

 string clientId = "" ;
string clientSecret = "" ;
Authorizer authorizer = await Authorizer . Authorize ( clientId , clientSecret ) ;

注意：修改呼叫需要OAuth授权

常问问题

• 如何将其添加到我的Unity项目中？从发行版中下载dll文件，然后将其放入插件文件夹中。
• 为什么我不能做new SheetSerializer() ？因为这是一个抽象类，因此您必须自己对此课程进行实施。
• 什么名称空间？ popcron.sheets
• 我得到了某种禁止的例外，请确保您的API密钥有效，并且您的散布表可以公开访问。
• 是行然后列或列然后行的行？不。
• 有XML文档吗？是的。
• batchupdate方法是否有效？未经测试，我不知道。
• 那创建方法呢？未经测试。
• 什么有效？ GET方法以及大多数高级别和低水平API。
• 我正在使用低级API，但我不知道x做什么？看Google表API，因为我都不是。
• 我可以发送拉请求吗？当然。
• 我遇到了一个错误，请给我重现它的步骤，我将尝试修复它。