Warning, /documentation/digikam-doc/export_tools/google_export.rst is written in an unsupported language. File is not indexed.
0001 .. meta:: 0002 :description: digiKam Export to Google Web-Service 0003 :keywords: digiKam, documentation, user manual, photo management, open source, free, learn, easy, google, export 0004 0005 .. metadata-placeholder 0006 0007 :authors: - digiKam Team 0008 0009 :license: see Credits and License page for details (https://docs.digikam.org/en/credits_license.html) 0010 0011 .. _google_export: 0012 0013 Export To Google 0014 ================ 0015 0016 .. contents:: 0017 0018 Overview 0019 -------- 0020 0021 This tool allows the user to upload photos to the Google web services. Two online applications are supported: `Google Photo <https://en.wikipedia.org/wiki/Google_Photos>`_ and `Google Drive <https://en.wikipedia.org/wiki/Google_Drive>`_. 0022 0023 **Google Photos** is a photo sharing which automatically analyzes photos, identifying various visual features and subjects. Users can search for anything in photos including faces and group similar ones together. 0024 0025 **Google Drive** allows users to store files in the cloud, synchronize files across devices, and share files. Users can change privacy settings for individual files and can search for a content by describing its visuals, and use natural language to find specific files. 0026 0027 .. important:: 0028 0029 digiKam is not currently compatible with the **Google Advanced Protection Program (GAPP)** account settings. This protection serves for journalists and people who could be exposed to increased attacks. digiKam is compatible with a Google normal account. 0030 0031 For a normal Google account the amount of files which can be downloaded at once is currently limited to 1000. 0032 0033 The tools can be used to upload an image collections from your computer to the remote Google server using the Internet. Use respectively the :menuselection:`Export --> Export to Google Photo` :kbd:`Ctrl+Alt+Shift+P` and by the :menuselection:`Export --> Export to Google Drive` :kbd:`Ctrl+Alt+Shift+D` menu entries to access to these tools, or uses the icons from **Tools** in Right sidebar. 0034 0035 .. warning:: 0036 0037 Google Photo is only suitable for showing images on the web, not as a backup solution. Google recompresses uploaded images and changes or removes metadata, e.g. GPS. 0038 0039 Login to your Account 0040 --------------------- 0041 0042 When accessing the tool for the first time you are taken through the process of obtaining a token which is used for authentication purposes. The following dialog will popup and a browser window will be launched you will log in to Google: 0043 0044 .. figure:: images/export_google_login.webp 0045 :alt: 0046 :align: center 0047 0048 The Google Dialog to Select Account 0049 0050 After successful signup digiKam will be allowed to send photos to the Google website. You will be presented with the following page on successful signup: 0051 0052 .. figure:: images/export_google_authorize.webp 0053 :alt: 0054 :align: center 0055 0056 The Google Dialog to Authorize Application 0057 0058 Then, simply authorize application and close the web browser. Return to the host application dialog, you will see the interface used to upload photos to Google. 0059 0060 .. note:: 0061 0062 When the tool is invoked for second time, it will remember the previous account automatically. 0063 0064 Upload to your Account 0065 ---------------------- 0066 0067 The upload dialogs for **Google Photo** and **Google Drive** uses mostly the same interface: 0068 0069 .. figure:: images/export_google_photo.webp 0070 :alt: 0071 :align: center 0072 0073 The Google Photo Export Dialog 0074 0075 .. figure:: images/export_google_drive.webp 0076 :alt: 0077 :align: center 0078 0079 The Google Drive Export Dialog 0080 0081 By default, the tools proposes to export the currently selected items from the icon-view. The **+** Photos button can be used to append more items on the list. 0082 0083 With the **Album** options, you can select the online folder to store files to upload. You can **Create** new one and **Reload** the list on the combo-box if online contents have been changed in Google web interface. 0084 0085 If the **Resize photos before uploading** option is selected, the photos will be resized before transferring to Google. The values will be read from the **Maximum Dimension** combo-box, which can be used to adjust the maximum height. The width calculation will be done so as to have the aspect ratio conserved. 0086 0087 With **Google Photo** uploader, a special option is available to **Write the photo ID to the source image**. The identification number used to upload to your Google account will be recorded in the XMP metadata from file in your collection. 0088 0089 .. figure:: images/export_google_progress.webp 0090 :alt: 0091 :align: center 0092 0093 The Google Export Uploading in Progress 0094 0095 Press **Start Upload** button to transfer items. You can click on the **Close** button to abort the uploading of photos. 0096 0097 Finally, you can view the uploaded photos by visiting the Google websites. 0098 0099 .. figure:: images/export_google_photo_stream.webp 0100 :alt: 0101 :align: center 0102 0103 The Google Photo Online Account Displaying the Uploaded Contents 0104 0105 .. figure:: images/export_google_drive_stream.webp 0106 :alt: 0107 :align: center 0108 0109 The Google Drive Online Account Displaying the Uploaded Contents