Skip to content

Commit 56bd248

Browse files
committed
Update AddGooglePhotosCloudSyncTask.md
1 parent 24021e1 commit 56bd248

File tree

1 file changed

+16
-8
lines changed

1 file changed

+16
-8
lines changed

content/SCALE/SCALETutorials/DataProtection/CloudSyncTasks/AddGooglePhotosCloudSyncTask.md

+16-8
Original file line numberDiff line numberDiff line change
@@ -11,16 +11,23 @@ keywords:
1111
- data backup and recovery
1212
---
1313

14-
Configuring a Google Photos cloud sync task requires a Google Photos API key and [rclone](https://rclone.org/) token.
15-
See the [rclone Google Photos backend documentation](https://rclone.org/googlephotos/) for more on using rclone to sync Google Photos, including features and limitations of the Google Photos API.
14+
Google Photos cloud sync tasks in TrueNAS SCALE use the [rclone](https://rclone.org/) backend for the [Google Photos API](https://developers.google.com/photos) to authenticate credentials and transfer data.
1615

17-
This is a multi-part procedure that includes [generating Google API credentials](#creating-the-api-credentials), [installing and configuring rclone](#configuring-rclone) on your client OS, [creating cloud credentials](#creating-google-photos-cloud-credentials) for Google Photos on TrueNAS SCALE, and then [configuring the cloud sync task](#creating-the-cloud-sync-task).
16+
Configuring a Google Photos cloud sync task is a multi-part procedure that includes:
17+
18+
1. [Planning your deployment](#before-you-begin) and selecting a local dataset.
19+
2. [Generating Google API credentials](#creating-the-api-credentials) on the Google Cloud API dashboard.
20+
3. [Installing rclone and generating a token](#configuring-rclone) on your remote client OS.
21+
4. [Adding Google Photos cloud credentials](#adding-google-photos-cloud-credentials) on TrueNAS SCALE.
22+
5. [Configuring the cloud sync task](#creating-the-cloud-sync-task) on SCALE.
1823

1924
## Before You Begin
2025

2126
Review your storage and data protection requirements and consider your options before setting up a Google Photos cloud sync task.
27+
Refer to the rclone Google Photos backend documentation for more information on using rclone to sync Google Photos, including [standard options](https://rclone.org/googlephotos/#standard-options) and [limitations of the Google Photos API](https://rclone.org/googlephotos/#limitations), that might help you plan your deployment.
28+
2229
Consider how you want to manage your media files on Google Photos and in your local dataset.
23-
Select the cloud sync task direction, transfer mode, and remote folder to target that best fit your needs.
30+
Select the cloud sync task [direction and transfer mode](#choosing-a-sync-direction-and-mode), [remote folder](#choosing-a-target-folder) to target, and [new or existing local dataset](#selecting-the-dataset-and-organizing-files) to pull to or push from, that best fit your needs.
2431

2532
### Choosing a Sync Direction and Mode
2633

@@ -33,6 +40,7 @@ Choose to push data to Google Photos if you prefer to manage media files in the
3340

3441
Next, select the data transfer mode that best fits the way you want to manage file retention between the source and destination.
3542
There are three options:
43+
3644
* **SYNC** - Select to change files on the destination to match those on the source.
3745
If a file does not exist on the source, it is also deleted from the destination.
3846
* **COPY** - Select to duplicate each source file into the destination.
@@ -55,9 +63,9 @@ A cloud sync task cannot target the root level folder (<file>/</file>).
5563
| <file>/upload</file> | **No** | Push | Media files pushed from the local dataset to <file>/upload</file> are then uploaded to Google Photos and not sorted into an album. Because <file>/upload</file> is a temporary storage location, it can not accurately synchronize from one task to the next. Pushing to this folder does not preserve metadata and can result in duplicated files, poor performance, file name instability. |
5664
{{< /truetable >}}
5765

58-
### Creating the Dataset and Organizing Files
66+
### Selecting the Dataset and Organizing Files
5967

60-
Next, create a TrueNAS SCALE local dataset to use as the source or destination.
68+
Next, select TrueNAS SCALE local dataset or create a new one to use as the source or destination.
6169

6270
{{< expand "Creating a Dataset" "v" >}}
6371
{{< include file="/static/includes/CreateDatasetSCALE.md" >}}
@@ -152,9 +160,9 @@ Copy and save the type, client_id, client_secret, and token, then enter `y` to s
152160

153161
{{< trueimage src="/images/SCALE/DataProtection/GooglePhotosAPIrcloneConfig3.png" alt="Confirm rclone Configuration" id="Confirm rclone Configuration" >}}
154162

155-
## Creating Google Photos Cloud Credentials
163+
## Adding Google Photos Cloud Credentials
156164

157-
Open your TrueNAS Web UI. Go to **Credentials > Backup Credentials** and click **Add** in the **Cloud Credentials** widget.
165+
On the TrueNAS Web UI, go to **Credentials > Backup Credentials** and click **Add** in the **Cloud Credentials** widget.
158166

159167
{{< trueimage src="/images/SCALE/DataProtection/GooglePhotosAPIAddCloudCredentials.png" alt="Add Cloud Credentials" id="Add Cloud Credentials" >}}
160168

0 commit comments

Comments
 (0)