# Google Sheets

Trước khi sử dụng node này, trước tiên bạn cần cung cấp cho Gemlogin quyền truy cập vào bảng tính.

### <mark style="color:orange;">Chế độ Public</mark>

<figure><img src="https://61021313-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn95B81pvGqTgcoWfRAtb%2Fuploads%2FvKBEOJQCYGq1vorbUCbc%2Fimage.png?alt=media&#x26;token=f18fc701-0983-4aef-9e4f-460a4ecddb58" alt=""><figcaption></figcaption></figure>

* <mark style="color:blue;">Bạn chia sẻ bảng tính công khai</mark> .

Khi bạn chia sẻ bảng tính công khai, Automation chỉ có quyền truy cập đọc vào bảng tính đó.\
Và nếu bạn có kế hoạch cập nhật các giá trị ô của bảng tính, bạn cần chia sẻ bảng tính với tài khoản Automation. Để làm điều đó, hãy mở bảng tính bạn muốn chia sẻ, nhấp vào nút chia sẻ ở trên cùng và chia sẻ công khai.

<figure><img src="https://61021313-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn95B81pvGqTgcoWfRAtb%2Fuploads%2Fd6nptJLzyGXHmoQYnoe0%2Fimage.png?alt=media&#x26;token=e0c3e761-7c8e-4140-be60-a47d16235b2b" alt=""><figcaption></figcaption></figure>

## Id bảng tính[​](https://docs.omnilog.in/blocks/google-sheets.html#id-bang-tinh) <a href="#id-bang-tinh" id="id-bang-tinh"></a>

Id Bảng tính chứa chữ cái, số, dấu gạch nối hoặc dấu gạch dưới. Và bạn có thể tìm thấy nó trong URL Google trang tính  ⇒ phần bôi xanh

<figure><img src="https://61021313-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn95B81pvGqTgcoWfRAtb%2Fuploads%2FBYmiatOSfkQFYrXHy6p1%2Fimage.png?alt=media&#x26;token=52413180-061b-458e-bf30-e433eb04c4e3" alt=""><figcaption></figcaption></figure>

## Phạm vi[​](https://docs.omnilog.in/blocks/google-sheets.html#pham-vi) <a href="#pham-vi" id="pham-vi"></a>

Phạm vi giá trị của các ô mà bạn muốn lấy, cập nhật hoặc xoá. Bạn có thể xác định phạm vi ô bằng cách sử dụng [Kí hiệu A1](https://developers.google.com/sheets/api/guides/concepts#expandable-1) like `Sheet1!A1:B2` hoặc `A1:B2`, hoặc Kí hiệu R1C1 like `Sheet1!R1C1:R2C2` hoặc `R1C1:R2C2`

## Lấy giá trị ô bảng tính[​](https://docs.omnilog.in/blocks/google-sheets.html#lay-gia-tri-o-bang-tinh) <a href="#lay-gia-tri-o-bang-tinh" id="lay-gia-tri-o-bang-tinh"></a>

Lấy giá trị ô của bảng tính bằng đường link của google sheet đó

* **Khoá tham chiếu**\
  Tham chiếu từ khoá để xác định dữ liệu google trang tính.
* **Sử dụng hàng đầu tiên làm từ khoá**\
  Khi chọn sử dụng hàng đầu tiên của bảng tính làm khoá thì các giá trị ở cột tương ứng sẽ được định danh, và các bạn có thể lấy ra các giá trị đó dựa vào khoá đó.

  Ví dụ khi bạn có một bảng tính như thế này.

| Name | Age |
| :--: | :-: |
|  foo |  22 |
|  bar |  23 |

```json
// Không chọn hàng đầu tiên là khoá 
[["name", "age"], ["foo", 22], ["bar", 23]]

// Chọn hàng đầu tiên là khoá
[{ "name": "foo", "age": 22 }, { "name": "bar", "age": 23 }]
```

## **Tên cột dùng làm khoá chính**

Trong trường hợp bạn muốn dùng chính xác dữ liệu với profile đang chạy thì bạn chọn lựa chọn này

Ví dụ khi bạn có một bảng tính như thế này.

<table><thead><tr><th width="100" align="center">profileId</th><th width="100" align="center">name</th><th width="100" align="center">age</th></tr></thead><tbody><tr><td align="center">2</td><td align="center">     foo</td><td align="center">      22</td></tr><tr><td align="center">3</td><td align="center">     bar</td><td align="center">      23</td></tr></tbody></table>

Bạn muốn khi chạy profile có id là 2 thì sẽ dùng giá trị là `foo` thì bạn dùng lựa chọn này, khi đó bạn có thể lấy ra giá trị `foo` bằng biểu thức `{{googleSheets.referenceKey.[profileId].name}}`, khi đó khi chạy profile có id là 2 sẽ lấy ra giá trị `foo`, profile có id là 3 sẽ lấy ra giá trị `bản`

<mark style="background-color:blue;">`Tên cột dùng làm khóa chính`</mark>&#x20;

<div><figure><img src="https://61021313-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn95B81pvGqTgcoWfRAtb%2Fuploads%2FCtjz6XIG5AMv7V4DfuMy%2Fimage.png?alt=media&#x26;token=a9fc57db-8e28-4957-b517-c8fc54ea307e" alt=""><figcaption></figcaption></figure> <figure><img src="https://61021313-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn95B81pvGqTgcoWfRAtb%2Fuploads%2FL4du2ShPZ5iJjmnEAqOP%2Fimage.png?alt=media&#x26;token=5368bd13-306c-4a83-a041-bd32894982d1" alt=""><figcaption></figcaption></figure></div>

⇒ Profileid sẽ được lấy ra làm khóa tham chiếu so sánh trực tiếp.

### Lấy phạm vi bảng tính[​](https://docs.omnilog.in/blocks/google-sheets.html#lay-pham-vi-bang-tinh) <a href="#lay-pham-vi-bang-tinh" id="lay-pham-vi-bang-tinh"></a>

Lấy giá trị phạm vi của bảng tính sau đó gán giá trị đó cho biến hoặc bảng mong muốn

* **Phạm vi bảng tính**
  * **Gán cho biến**: gán phạm vi của dữ liệu cho một biến
  * **Chèn vào bảng**: gán phạm vi của dữ liệu cho một cột

### <mark style="color:orange;">Chế độ Private</mark>

<figure><img src="https://61021313-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn95B81pvGqTgcoWfRAtb%2Fuploads%2FheUHbRNeGzo0Ee0uojXK%2Fimage.png?alt=media&#x26;token=76d8411f-29b2-4018-b049-b0d0b029d3bd" alt=""><figcaption></figcaption></figure>

Tạo file Json trên website <https://console.cloud.google.com>

Video hướng dẫn tạo và cấp quyền file Googleshets Private.&#x20;