Warning, /documentation/digikam-doc/import_tools/google_import.rst is written in an unsupported language. File is not indexed.

0001 .. meta::
0002    :description: digiKam Import from Google Web-Service
0003    :keywords: digiKam, documentation, user manual, photo management, open source, free, learn, easy, google, impport
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_import:
0012 
0013 Import from Google
0014 ==================
0015 
0016 .. contents::
0017 
0018 Overview
0019 --------
0020 
0021 This tool allows the user to upload photos to the `Google Photo <https://en.wikipedia.org/wiki/Google_Photos>`_ web services.
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 The tool can be used to download files from the remote Google Photo server to the image collections on your computer using the Internet. Use the :menuselection:`Import --> Import from Google Photo` :kbd:`Alt+Shift+P` menu entry to access to this tool, or use the icon from the **Tools** tab in the Right Sidebar.
0026 
0027 Login to your Account
0028 ---------------------
0029 
0030 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 to help you loggging in to Google:
0031 
0032 .. figure:: images/import_google_login.webp
0033     :alt:
0034     :align: center
0035 
0036     The Google Dialog to Select Account
0037 
0038 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:
0039 
0040 .. figure:: images/import_google_authorize.webp
0041     :alt:
0042     :align: center
0043 
0044     The Google Dialog to Authorize Application
0045 
0046 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.
0047 
0048 .. note::
0049 
0050     When the tool is invoked for second time, it will remember the previous account automatically.
0051 
0052 Download from your Account
0053 --------------------------
0054 
0055 The download dialog for **Google Photo** web-service is presented below:
0056 
0057 .. figure:: images/import_google_photo_dialog.webp
0058     :alt:
0059     :align: center
0060 
0061     The Google Photo Import Dialog
0062 
0063 With the **Album** options, you can select the online folder to get files to download. You can **Reload** the list on the combo-box if online contents have been changed in Google web interface.
0064 
0065 Below, the main dialog propose the hierarchy of physical **Albums** from your collection. Selected one target entry to import files, or if you want a new one, just press **New Album** button to create a nested entry in the tree-view.
0066 
0067 Press **Start Download** button to transfer items. You can click on the **Close** button to abort the uploading of photos.