mirrors/n8n-docs
2
0
Fork 0
mirror of https://github.com/n8n-io/n8n-docs.git synced 2025-11-20 17:48:34 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

⚡Add FAQs and general update

Browse Source
This commit is contained in:
Harshil 2020-12-08 15:30:35 +05:30
parent cbc6ab3e55
commit ca141dc7d6
1 changed files with 30 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

37
docs/nodes/nodes-library/nodes/Gmail/README.md
View File

@ -56,46 +56,69 @@ The start node exists by default when you create a new workflow.
### 2. Gmail node (getAll: message)
This node will return 10 messages with the label `n8n` from Gmail. If you want to return all the messages toggle ***Return All*** to `true`.
1. First of all, you'll have to enter credentials for the Gmail node. You can find out how to do that [here](../../../credentials/Google/README.md).
2. Select 'Message' from the ***Resource*** dropdown list.
3. Select 'Get All' from the ***Operation*** dropdown list.
4. Click on ***Add Field*** button and select 'Format' from the dropdown list.
5. Select 'Full' from ***Format*** dropdown menu.
6. Click on ***Add Field*** button and select 'Label IDs' from the dropdown list.
7. Select the label from ***Label IDs*** dropdown list.
4. Click on the ***Add Field*** button and select 'Format' from the dropdown list.
5. Select 'Full' from ***Format*** dropdown menu. This option will return the full email message data with the body content parsed in the payload field.
6. Click on the ***Add Field*** button and select 'Label IDs' from the dropdown list.
7. Select the label from the ***Label IDs*** dropdown list.
8. Click on ***Execute Node*** to run the node.
In the screenshot below, you will notice that the node returns 10 email messages with the label `n8n`.
![Using the Gmail node to get all messages with a particular label](./Gmail_node.png)
::: v-pre
### 3. Gmail1 node (remove: messageLabel)
This node will remove the label `n8n` from all the messages that you received in the previous node. If you want to remove a different label, select that label instead.
1. Select the credentials that you entered in the previous Gmail node.
2. Select 'Message Label' from the ***Resource*** dropdown list.
3. Select 'Remove' from the ***Operation*** dropdown list.
4. Click on the gears icon next to the ***Message ID*** field and click on ***Add Expression***.
5. Select the following in the ***Variable Selector*** section: Nodes > Gmail > Output Data > JSON > id. You can also add the following expression: `{{$node["Gmail"].json["id"]}}`.
6. Select the label from ***Label IDs*** dropdown list.
6. Select the label from the ***Label IDs*** dropdown list.
7. Click on ***Execute Node*** to run the node.
:::
In the screenshot below, you will notice that the node removes the `n8n` label from the messages that we received from the previous node.
![Using the Gmail node to remove a label from the messages](./Gmail1_node.png)
::: v-pre
### 4. Gmail2 node (add: messageLabel)
This node will add a new label `nodemation` to the messages that we received from the Gmail node. If you want to add a different label, select that label instead.
1. Select the credentials that you entered in the previous Gmail node.
2. Select 'Message Label' from the ***Resource*** dropdown list.
3. Click on the gears icon next to the ***Message ID*** field and click on ***Add Expression***.
4. Select the following in the ***Variable Selector*** section: Nodes > Gmail > Output Data > JSON > id. You can also add the following expression: `{{$node["Gmail"].json["id"]}}`.
5. Select the label from ***Label IDs*** dropdown list.
5. Select the label from the ***Label IDs*** dropdown list.
6. Click on ***Execute Node*** to run the node.
:::
In the screenshot below, you will notice that the node adds a new label `nodemation` to the messages that we received from the Gmail node.
![Using the Gmail node to add a label to the messages](./Gmail2_node.png)
## FAQs
### 1. How to return all the messages with a particular label?
To return all the messages with a particular label, follow the steps mentioned below.
1. Select 'Message' from the ***Resource*** dropdown list.
2. Select 'Get All' from the ***Operation*** dropdown list.
3. If you want to all return all the messages with a particular, toggle ***Return All*** to `true`.
4. Click on ***Add Field*** and select 'Query'.
5. Enter `label:LABEL_NAME` in the ***Query*** field. Replace `LABEL_NAME` with your label name.
6. Click on ***Execute Node*** to run the node.
Refer to [Search operators you can use with Gmail](https://support.google.com/mail/answer/7190?hl=en) to learn more about how to filter your search results.
## Further Reading