Skip to content
This repository was archived by the owner on Feb 16, 2023. It is now read-only.

Commit e2048e4

Browse files
bazarnovJordan Scott
authored and
Jordan Scott
committed
🎉 Destination Google Sheets: update docs (airbytehq#13151)
1 parent 5ad8d67 commit e2048e4

File tree

4 files changed

+48
-21
lines changed

4 files changed

+48
-21
lines changed

.gitignore

+1
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,7 @@ data
1010
.classpath
1111
.project
1212
.settings
13+
.vscode
1314
**/gmon.out
1415
static_checker_reports/
1516

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
#
2+
# Copyright (c) 2021 Airbyte, Inc., all rights reserved.
3+
#
4+
5+
# fixture for the unit_tests
6+
def test_fixture():
7+
assert True
1.27 KB
Loading

docs/integrations/destinations/google-sheets.md

+40-21
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,43 @@
11
# Google Sheets
22

3-
## Sync overview
3+
The Google Sheets Destination is configured to push data to a single Google Sheets spreadsheet with multiple Worksheets as streams. To replicate data to multiple spreadsheets, you can create multiple instances of the Google Sheets Destination in your Airbyte instance.
4+
This page guides you through the process of setting up the Google Sheets destination connector.
45

5-
The Google Sheets Destination is configured to push data to a single Google Sheets spreadsheet with multiple Worksheets as streams. To replicate data to multiple spreadsheets, you can create multiple instances of the Google Sheets Destination in your Airbyte instance.
6-
Please be aware of the [Google Spreadsheet limitations](#limitations) before you configure your airbyte data replication using Destination Google Sheets
6+
7+
## Prerequisites
8+
9+
* Google Account
10+
* Google Spreadsheet URL
11+
12+
## Step 1: Set up Google Sheets
13+
14+
### Google Account
15+
16+
#### If you don't have a Google Account
17+
18+
Visit the [Google Support](https://support.google.com/accounts/answer/27441?hl=en) and create your Google Account.
19+
20+
### Google Sheets (Google Spreadsheets)
21+
22+
1. Once you acquire your Google Account, simply open the [Google Support](https://support.google.com/docs/answer/6000292?hl=en&co=GENIE.Platform%3DDesktop) to create the fresh empty Google to be used as a destination for your data replication, or if already have one - follow the next step.
23+
2. You will need the link of the Spreadsheet you'd like to sync. To get it, click Share button in the top right corner of Google Sheets interface, and then click Copy Link in the dialog that pops up.
24+
These two steps are highlighted in the screenshot below:
25+
26+
![](../../.gitbook/assets/google_spreadsheet_url.png)
27+
28+
## Step 2: Set up the Google Sheets destination connector in Airbyte
29+
30+
**For Airbyte Cloud:**
31+
32+
1. [Log into your Airbyte Cloud](https://cloud.airbyte.io/workspaces) account.
33+
2. In the left navigation bar, click **Destinations**. In the top-right corner, click **+ new destination**.
34+
3. On the source setup page, select **Google Sheets** from the Source type dropdown and enter a name for this connector.
35+
4. Select `Sign in with Google`.
36+
5. Log in and Authorize to the Instagram account and click `Set up source`.
37+
38+
**For Airbyte OSS:**
39+
40+
At this moment the `Google Sheets Destination` works only with Airbyte Cloud.
741

842
### Output schema
943

@@ -55,7 +89,7 @@ EXAMPLE:
5589
| :--- | :--- |
5690
| Any Type | `string` |
5791

58-
### Features
92+
### Features & Supported sync modes
5993

6094
| Feature | Supported?\(Yes/No\) |
6195
| :--- | :--- |
@@ -64,9 +98,10 @@ EXAMPLE:
6498
| Incremental Append | Yes |
6599
| Incremental Append-Deduplicate | Yes |
66100

67-
### Performance considerations
101+
### Rate Limiting & Performance Considerations
68102

69103
At the time of writing, the [Google API rate limit](https://developers.google.com/sheets/api/limits) is 100 requests per 100 seconds per user and 500 requests per 100 seconds per project. Airbyte batches requests to the API in order to efficiently pull data and respects these rate limits. It is recommended that you use the same service user \(see the "Creating a service user" section below for more information on how to create one\) for no more than 3 instances of the Google Sheets Destination to ensure high transfer speeds.
104+
Please be aware of the [Google Spreadsheet limitations](#limitations) before you configure your airbyte data replication using Destination Google Sheets
70105

71106
### <a name="limitations"></a>Google Sheets Limitations
72107

@@ -85,22 +120,6 @@ At max, you can have 18,278 columns in Google Sheets in a worksheet.
85120
You cannot create more than 200 worksheets within single spreadsheet.
86121

87122

88-
## Getting Started (Airbyte Cloud Only)
89-
To configure the connector you'll need to:
90-
91-
* [Authorize your Google account via OAuth](#oauth)
92-
* [The Full URL or Spreadsheet ID you'd like to sync](#sheetlink)
93-
94-
### <a name="oauth"></a> Authorize your Google account via OAuth
95-
Click on the "Sign in with Google" button and authorize via your Google account.
96-
97-
### <a name="sheetlink"></a>Spreadsheet Link
98-
You will need the link of the Spreadsheet you'd like to sync. To get it, click Share button in the top right corner of Google Sheets interface, and then click Copy Link in the dialog that pops up.
99-
These two steps are highlighted in the screenshot below:
100-
101-
![](../../.gitbook/assets/google_spreadsheet_url.png)
102-
103-
104123
#### Future improvements:
105124
- Handle multiple spreadsheets to split big amount of data into parts, once the main spreadsheet is full and cannot be extended more, due to [limitations](#limitations).
106125

0 commit comments

Comments
 (0)