airtable

Golang Airtable API

一个简单的#Golang软件包，可访问可播放的API。

目录

• Golang Airtable API
• 目录
  • 安装
  • 基本用法
    • 初始化客户端
    • 获取表
    • 列表记录
    • 添加记录
    • 通过ID获取记录
    • 更新记录
    • 删除记录
    • 批量删除记录
  • 特别感谢

安装

Golang Airtable API已测试与GO 1.13兼容。

 go get github.com/mehanizm/airtable

基本用法

初始化客户端

您应该在“ airtable帐户”页面中获得your_api_token

 client := airtable . NewClient ( "your_api_token" )

您可以在此处使用自定义HTTP客户端

 client . SetCustomClient ( http . DefaultClient )

自定义上下文

下面的每种方法都可以与自定义上下文一起使用。只需使用MethodNameContext调用并提供上下文作为第一个参数。

列表基础

 bases , err := client . GetBases (). WithOffset ( "" ). Do ()

获取基本模式

 schema , err := client . GetBaseSchema ( "your_database_ID" ). Do ()

获取表

要获取your_database_ID您应该转到主API页面并选择数据库。

 table := client . GetTable ( "your_database_ID" , "your_table_name" )

列表记录

要从桌子上获取记录，您可以使用类似的东西

 records , err := table . GetRecords ().
	FromView ( "view_1" ).
	WithFilterFormula ( "AND({Field1}='value_1',NOT({Field2}='value_2'))" ).
	WithSort ( sortQuery1 , sortQuery2 ).
	ReturnFields ( "Field1" , "Field2" ).
	InStringFormat ( "Europe/Moscow" , "ru" ).
	Do ()
if err != nil {
	// Handle error
}

添加记录

 recordsToSend := & airtable. Records {
    Records : [] * airtable. Record {
        {
            Fields : map [ string ] any {
                "Field1" : "value1" ,
                "Field2" : true ,
            },
        },
    },
}
receivedRecords , err := table . AddRecords ( recordsToSend )
if err != nil {
	// Handle error
}

通过ID获取记录

 record , err := table . GetRecord ( "recordID" )
if err != nil {
	// Handle error
}

更新记录

部分更新一个记录

 res , err := record . UpdateRecordPartial ( map [ string ] any { "Field_2" : false })
if err != nil {
	// Handle error
}

完整更新记录

 toUpdateRecords := & airtable. Records {
    Records : [] * airtable. Record {
        {
            Fields : map [ string ] any {
                "Field1" : "value1" ,
                "Field2" : true ,
            },
        },
        {
            Fields : map [ string ] any {
                "Field1" : "value1" ,
                "Field2" : true ,
            },
        },
    },
}
updatedRecords , err := table . UpdateRecords ( toUpdateRecords )
if err != nil {
	// Handle error
}

删除记录

 res , err := record . DeleteRecord ()
if err != nil {
	// Handle error
}

批量删除记录

删除多达10个记录

 records , err := table . DeleteRecords ([] string { "recordID1" , "recordsID2" })
if err != nil {
	// Handle error
}

特别感谢

受到Go Trello API的启发