Skip to content

Commit fbd8089

Browse files
bot-docsteambot-docsteam
authored
Merge pull request #613 from segmentio/repo-sync
repo sync
2 parents 8fbfb62 + 4bf838f commit fbd8089

File tree

5 files changed

+207
-5
lines changed

5 files changed

+207
-5
lines changed

‎src/_data/catalog/destinations_private.yml

Lines changed: 160 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
# AUTOGENERATED FROM PUBLIC API. DO NOT EDIT
2-
# destination data last updated 2022-09-19 with Intercom Web (Actions)
2+
# destination data last updated 2022-10-07 with Google Sheets
33
items:
44
- id: 54521fd525e721e32a72ee8e
55
name: AdRoll
@@ -4270,3 +4270,162 @@ items:
42704270
event_metadata:
42714271
'@path': $.properties
42724272
trigger: type = "track"
4273+
- id: 627ea052118e3cd530d28963
4274+
display_name: Google Sheets
4275+
name: Google Sheets
4276+
slug: actions-google-sheets
4277+
previous_names:
4278+
- Google Sheets
4279+
website: https://www.google.com/sheets/about/
4280+
status: PRIVATE_BETA
4281+
logo:
4282+
url: https://cdn.filepicker.io/api/file/5YkyjmfJSzCy09E3pQVK
4283+
mark:
4284+
url: https://cdn.filepicker.io/api/file/pwnFihhWRTqlXE3zND6Q
4285+
methods:
4286+
track: true
4287+
pageview: true
4288+
identify: true
4289+
group: true
4290+
alias: true
4291+
platforms:
4292+
browser: true
4293+
mobile: false
4294+
server: true
4295+
components: []
4296+
browserUnbundlingSupported: false
4297+
browserUnbundlingPublic: false
4298+
replay: false
4299+
settings: []
4300+
actions:
4301+
- id: 6cgExzDArNQSaKL9TwFHTP
4302+
name: Post Sheet
4303+
slug: postSheet
4304+
description: Write values to a Google Sheets spreadsheet.
4305+
platform: CLOUD
4306+
hidden: false
4307+
defaultTrigger: event = "updated" or event = "new"
4308+
fields:
4309+
- id: 3mnKkoj69PYhnMFArQqgwj
4310+
sortOrder: 0
4311+
fieldKey: record_identifier
4312+
label: Record Identifier
4313+
type: STRING
4314+
description: Property which uniquely identifies each row in the spreadsheet.
4315+
placeholder: ''
4316+
defaultValue:
4317+
'@path': $.__segment_id
4318+
required: true
4319+
multiple: false
4320+
choices: null
4321+
dynamic: false
4322+
allowNull: false
4323+
- id: jvr5UEodxuuZGR4stauHqQ
4324+
sortOrder: 1
4325+
fieldKey: operation_type
4326+
label: Operation Type
4327+
type: HIDDEN
4328+
description: >-
4329+
Describes the nature of the operation being performed. Only
4330+
supported values are 'new' and 'updated'.
4331+
placeholder: ''
4332+
defaultValue:
4333+
'@path': $.event
4334+
required: true
4335+
multiple: false
4336+
choices: null
4337+
dynamic: false
4338+
allowNull: false
4339+
- id: 6biHVg61mv8bv3A395zK2
4340+
sortOrder: 2
4341+
fieldKey: spreadsheet_id
4342+
label: Spreadsheet ID
4343+
type: STRING
4344+
description: >-
4345+
The identifier of the spreadsheet. You can find this value in the
4346+
URL of the spreadsheet. e.g.
4347+
https://docs.google.com/spreadsheets/d/{SPREADSHEET_ID}/edit
4348+
placeholder: ''
4349+
defaultValue: ''
4350+
required: true
4351+
multiple: false
4352+
choices: null
4353+
dynamic: false
4354+
allowNull: false
4355+
- id: gpRm7bJCWWWFL2byqWa5dm
4356+
sortOrder: 3
4357+
fieldKey: spreadsheet_name
4358+
label: Spreadsheet Name
4359+
type: STRING
4360+
description: >-
4361+
The name of the spreadsheet. You can find this value on the tab at
4362+
the bottom of the spreadsheet. Please provide a valid name of a
4363+
sheet that already exists.
4364+
placeholder: ''
4365+
defaultValue: Sheet1
4366+
required: true
4367+
multiple: false
4368+
choices: null
4369+
dynamic: false
4370+
allowNull: false
4371+
- id: wgmhCUx43uAymuSeSNdQqq
4372+
sortOrder: 4
4373+
fieldKey: data_format
4374+
label: Data Format
4375+
type: STRING
4376+
description: >-
4377+
The way Google will interpret values. If you select raw, values
4378+
will not be parsed and will be stored as-is. If you select user
4379+
entered, values will be parsed as if you typed them into the UI.
4380+
Numbers will stay as numbers, but strings may be converted to
4381+
numbers, dates, etc. following the same rules that are applied
4382+
when entering text into a cell via the Google Sheets UI.
4383+
placeholder: ''
4384+
defaultValue: RAW
4385+
required: true
4386+
multiple: false
4387+
choices:
4388+
- label: Raw
4389+
value: RAW
4390+
- label: User Entered
4391+
value: USER_ENTERED
4392+
dynamic: false
4393+
allowNull: false
4394+
- id: eqRFLYHkkHpmLVPz8oMU2h
4395+
sortOrder: 5
4396+
fieldKey: fields
4397+
label: Fields
4398+
type: OBJECT
4399+
description: |2-
4400+
4401+
The fields to write to the spreadsheet.
4402+
4403+
On the left-hand side, input the name of the field as it will appear in the Google Sheet.
4404+
4405+
On the right-hand side, select the field from your data model that maps to the given field in your sheet.
4406+
4407+
---
4408+
4409+
4410+
placeholder: ''
4411+
required: true
4412+
multiple: false
4413+
choices: null
4414+
dynamic: false
4415+
allowNull: false
4416+
- id: arRP9FWVYmYQ9NhKKs5tEJ
4417+
sortOrder: 6
4418+
fieldKey: enable_batching
4419+
label: Batch Data to Google Sheets
4420+
type: BOOLEAN
4421+
description: >-
4422+
Set as true to ensure Segment sends data to Google Sheets in
4423+
batches. Please do not set to false.
4424+
placeholder: ''
4425+
defaultValue: true
4426+
required: false
4427+
multiple: false
4428+
choices: null
4429+
dynamic: false
4430+
allowNull: false
4431+
presets: []

‎src/api/config-api/fql.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,7 @@
11
---
22
title: Destination Filter Query Language
3+
redirect_from:
4+
- '/docs/config-api/fql'
35
---
46

57
{% include content/papi-ga.html %}

‎src/connections/destinations/catalog/actions-google-sheets/index.md

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
---
2+
title: Google Sheets Destination
3+
hide-boilerplate: true
4+
hide-dossier: false
5+
hidden: true
6+
private: true
7+
id: 627ea052118e3cd530d28963
8+
---
9+
10+
The Google Sheets destination allows you to sync your warehouse data to a Google spreadsheet, and automate updates to that spreadsheet as your data changes. This destination allows you to automate the workflow of exporting CSVs from your warehouse.
11+
12+
The Google Sheets destination is intended for use with **Reverse ETL sources only**.
13+
14+
> info ""
15+
> The Google Sheets destination is in beta and is in active development. Some functionality may change before it becomes generally available.
16+
17+
## Getting started
18+
19+
### Create a spreadsheet
20+
1. [Create a new Google spreadsheet](https://docs.google.com/spreadsheets/u/0/create?usp=sheets_home&ths=true){:target="_blank"} in your Google account.
21+
2. Copy the spreadsheet ID from the spreadsheet URL. The spreadsheet ID is the value after `d/` and before `/edit`. For example, if your URL is `https://docs.google.com/spreadsheets/d/1ejq5-UVP0SWZezRsdggzFxMqOmaJwZh7NkKPkQfi0Bb/edit#gid=0` the ID is `1ejq5-UVP0SWZezRsdggzFxMqOmaJwZh7NkKPkQfi0Bb`. You will need this ID when you configure the destination.
22+
23+
### Connect Google Sheets
24+
1. Create and configure your Reverse ETL source.
25+
2. Create a model for the data you plan to sync to Google Sheets.
26+
3. Navigate to the **Reverse ETL > Destinations** tab and click **Add Destination**.
27+
4. Select Google Sheets and click **Next**. Select the source you configured and name the destination.
28+
5. On the **Settings** tab, authenticate the Google Sheets API using OAuth. Select the email account that owns the spreadsheet you created above. Make sure you enable the `See, edit, create, and delete all your Google Sheets spreadsheets` permission.
29+
6. On the **Mappings** tab, click **Add Mapping** and create a Post Sheet mapping. Follow the steps in the Destinations Actions documentation on [Customizing mappings](/docs/connections/destinations/actions/#customizing-mappings).
30+
7. Enable the destination and configured mappings.
31+
32+
> info ""
33+
> The Google Sheets destination only supports sending new or updated rows to your spreadsheet. Deleting rows is not supported.
34+
35+
{% include components/actions-fields.html %}
36+
37+
## FAQ
38+
39+
### How does Segment know if a row should be added or updated?
40+
41+
The Record Identifier mapping is used to make a distinction between adding a new row or updating an existing row. If two rows have the same Record Identifier, they are considered to be pertaining the same object and will live in the same row. Please ensure Record Identifier is set to a unique field.
42+
43+
### How do I define the columns in my spreadsheet?
44+
45+
The Fields mapping controls which fields in your model will be written as columns. Input the desired column name(s) on the left, and select the data variable that will populate the value for that column on the right. Please note,at least one Field must be configured to send data to Google Sheets otherwise no columns will be created or synced.

‎src/connections/destinations/catalog/actions-intercom-cloud/index.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,6 @@
22
title: Intercom Cloud Mode (Actions) Destination
33
hide-boilerplate: true
44
hide-dossier: false
5-
hidden: true
6-
private: true
75
id: 62ded0cf5753c743883ca0f3
86
versions:
97
- name: 'Intercom Web (Actions)'

‎src/connections/destinations/catalog/actions-intercom-web/index.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,6 @@
22
title: Intercom Web (Actions) Destination
33
hide-boilerplate: true
44
hide-dossier: false
5-
hidden: true
6-
private: true
75
id: 62d9daff84a6bf190da9f592
86
hide_action:
97
- id: 5W984Qq59XEQnFYKXKHGeZ

0 commit comments

Comments
 (0)