[Pkg-owncloud-commits] [owncloud-doc] 06/16: update google drive app with google's changes

David Prévot taffit at moszumanska.debian.org
Thu Dec 17 18:33:35 UTC 2015


This is an automated email from the git hooks/post-receive script.

taffit pushed a commit to branch master
in repository owncloud-doc.

commit d20fb473d218c8dcbf03d95c1c49ff95e8a46d5d
Author: Carla Schroder <carla at owncloud.com>
Date:   Mon Dec 7 09:19:26 2015 -0800

    update google drive app with google's changes
---
 .../external_storage_configuration_gui.rst         | 147 +++++++++++++--------
 .../images/external-storage-google-drive-0auth.png | Bin 65496 -> 0 bytes
 .../images/external-storage-google-drive-9.png     | Bin 34285 -> 0 bytes
 .../images/external-storage-google-drive-sdk.png   | Bin 45813 -> 0 bytes
 .../images/external-storage-google-drive.png       | Bin 9414 -> 0 bytes
 .../images/external-storage-google-drive1.png      | Bin 20527 -> 0 bytes
 .../images/external-storage-google-drive2.png      | Bin 5359 -> 0 bytes
 .../images/external-storage-google-drive3.png      | Bin 59817 -> 0 bytes
 .../images/external-storage-google-drive4.png      | Bin 62393 -> 0 bytes
 .../images/external-storage-google-drive5.png      | Bin 75172 -> 0 bytes
 .../images/external-storage-google-drive7.png      | Bin 29240 -> 0 bytes
 .../images/external-storage-google-drive8.png      | Bin 11987 -> 0 bytes
 admin_manual/images/google-drive.png               | Bin 0 -> 11950 bytes
 admin_manual/images/google-drive1.png              | Bin 0 -> 11030 bytes
 admin_manual/images/google-drive10.png             | Bin 0 -> 14967 bytes
 admin_manual/images/google-drive11.png             | Bin 0 -> 46479 bytes
 admin_manual/images/google-drive12.png             | Bin 0 -> 31465 bytes
 admin_manual/images/google-drive13.png             | Bin 0 -> 14859 bytes
 admin_manual/images/google-drive2.png              | Bin 0 -> 27860 bytes
 admin_manual/images/google-drive3.png              | Bin 0 -> 8890 bytes
 admin_manual/images/google-drive4.png              | Bin 0 -> 17205 bytes
 admin_manual/images/google-drive5.png              | Bin 0 -> 14608 bytes
 admin_manual/images/google-drive6.png              | Bin 0 -> 47083 bytes
 admin_manual/images/google-drive8.png              | Bin 0 -> 56891 bytes
 admin_manual/images/google-drive9.png              | Bin 0 -> 55514 bytes
 25 files changed, 93 insertions(+), 54 deletions(-)

diff --git a/admin_manual/configuration/external_storage_configuration_gui.rst b/admin_manual/configuration/external_storage_configuration_gui.rst
index 82779d2..5329880 100644
--- a/admin_manual/configuration/external_storage_configuration_gui.rst
+++ b/admin_manual/configuration/external_storage_configuration_gui.rst
@@ -205,74 +205,113 @@ safely tucked inside an SSH tunnel. To connect an SFTP server you need:
 Google Drive
 ------------
 
-All applications that access a Google API must be registered through the 
-`Google Cloud Console <https://console.developers.google.com/>`_. Follow along carefully 
-because the Google is a bit of a maze and it's easy to get lost. 
+ownCloud uses OAuth 2.0 to connect to Google Drive. This requires configuration
+through Google to get an app ID and app secret, as ownCloud registers itself
+as an app.
 
-.. note:: Your ownCloud server must have a registered domain name and be 
-   accessible over the Internet; Google Drive will not connect to a LAN-only 
-   server.
+All applications that access a Google API must be registered through the 
+`Google Cloud Console <https://console.developers.google.com/>`_. Follow along 
+carefully 
+because the Google interface is a bit of a maze and it's easy to get lost. 
 
 If you already have a Google account, such as Groups, Drive, or Mail, you can 
 use your existing login to log into the Google Cloud Console. After logging in 
-click ``Go to my console``, and then click the ``Create Project`` button. It 
-takes a minute or two to create your new project.
-
-.. figure:: ../images/external-storage-google-drive.png
-
-In the next screen give your project a name, accept the default ``Project ID`` 
-or create your own, click the Terms of Service box, and click the ``Create`` 
-button.
-
-.. figure:: ../images/external-storage-google-drive1.png
-
-The next screen is your ``Project Dashboard``. In the left sidebar click ``APIs 
-& Auth > APIs``, and then enable the ``Drive API`` and ``Drive SDK`` by 
-toggling the boxes in the far-right ``Status`` column to the green On buttons.
-
-.. figure:: ../images/external-storage-google-drive2.png
-
-This brings you to the ``Google Drive SDK`` screen. Click ``API Access``.
-
-.. figure:: ../images/external-storage-google-drive-sdk.png
+click  the **Create Project** button.
+
+.. figure:: ../images/google-drive.png
+   :alt: Google Drive app "create project" screen
+
+Give your project a name, and either accept the default **Project ID** or 
+create 
+your own, then click the **Create** button.
+
+.. figure:: ../images/google-drive1.png
+   :alt: New project creation screen.
+
+You'll be returned to your dashboard.
+
+.. figure:: ../images/google-drive2.png
+   :alt: Project dashboard, with all project options.
+   :scale: 75% 
+   
+Google helpfully highlights your next step in blue, the **Use Google APIs** 
+box. Make sure that your new project is selected, click on **Use Google APIs** 
+, 
+and it takes you to Google's APIs screen. There are many Google APIs; look for 
+the **Google Apps APIs** and click **Drive API.**
+
+.. figure:: ../images/google-drive3.png
+   :alt: Drive API link.
+
+**Drive API** takes you to the API Manager overview. Click the blue **Enable 
+API** button.
+
+.. figure::../ images/google-drive4.png
+   :alt: API dashboard.
+
+Now you must create your credentials, so click on **Go to credentials**.
+   
+.. figure:: ../images/google-drive5.png
+   :alt: Create Client ID screen.
+   
+For some reason Google warns us again that we need to create credentials. We 
+will use 0Auth 2.0.
+
+.. figure:: ../images/google-drive6.png
+   :alt: Another warning to create credentials.
+   
+Now we have to create a consent screen. This is the information in the screen 
+Google shows you when you connect your new Google app to ownCloud the first 
+time. Click **Configure consent screen**. Then fill in the required form 
+fields. 
+Your logo must be hosted, as you cannot upload it, so enter its URL. When 
+you're finished click **Save**.
+
+.. figure:: ../images/google-drive8.png
+   :alt: Creating the consent screen.
+
+The next screen that opens is **Create Client ID**. Check **Web Application**,  
+then enter your app name. **Authorized JavaScript Origins** is your root 
+domain, 
+for example ``https://www.example.com``, without a trailing slash. You need two 
+**Authorized Redirect URIs**, and they must be in this form::
 
-This opens the ``API Access`` screen. Click the ``Create a 0Auth 2.0 Client 
-ID`` button. 
-
-.. figure:: ../images/external-storage-google-drive-0auth.png
-
-The next screen that opens is ``Create Client ID: Branding Information``. Google 
-requires to you to fill this out. When you're finished move on to the ``Create 
-Client ID: Client ID Settings`` screen.
+  https://example.com/owncloud/index.php/settings/personal
+  https://example.com/owncloud/index.php/settings/admin
+  
+Replace ``https://example.com/owncloud/`` with your own ownCloud server URL, 
+then click **Create**.
 
-.. figure:: ../images/external-storage-google-drive5.png
+.. figure:: ../images/google-drive9.png
+   :alt: Creating client credentials.
 
-The ``Application Type`` is Web application.
+Now Google reveals to you your **Client ID** and **Client Secret**. Click 
+**OK**.
 
-Click ``Your site or hostname (more options)`` to expose  ``Authorized 
-Redirect URIs``. Enter two Redirect URIs like these examples, replacing 
-``https://example.com/owncloud/`` with your own ownCloud server 
-URL. You must use a registered domain name, and you cannot use the server's 
-IP address.
+.. figure:: ../images/google-drive10.png
+   :alt: Client ID and client secret.
 
-  https://example.com/owncloud/index.php/settings/personal
-  https://example.com/owncloud/index.php/settings/admin
-  
-Click ``Create client ID`` and you'll see a screen like this:
+You can see these anytime in your Google console; just click on your app name 
+to see complete information.   
 
-.. figure:: ../images/external-storage-google-drive-9.png
+.. figure:: ../images/google-drive11.png
+   :alt: Client ID and client secret
+   
+Now you have everything you need to mount your Google Drive in ownCloud. 
 
-This contains your ``Client ID`` and ``Client Secret``, which you need to set up 
-your ownCloud connection. Go to your ``Admin`` page in ownCloud, create your new 
-folder name, enter the Client ID and Client Secret, select your users and 
-groups, and click ``Grant Access``.
+Go to the External Storage section of your Admin page, create your new folder 
+name, enter the Client ID and Client Secret, and click **Grant Access**. Your 
+consent page appears when ownCloud makes a successful connection. Click 
+**Allow**.
 
-.. figure:: ../images/external-storage-google-drive8.png
+.. figure:: ../images/google-drive12.png
+   :alt: Google Drive consent page.
 
-Google will open a dialogue asking for permission to connect to ownCloud. Click 
-``Accept`` and you're finished.
+When you see the green light confirming a successful connection
+you're finished.
 
-.. figure:: ../images/external-storage-google-drive7.png
+.. figure:: ../images/google-drive13.png
+   :alt: Google Drive mount in ownCloud.
 
 SMB/CIFS
 --------
diff --git a/admin_manual/images/external-storage-google-drive-0auth.png b/admin_manual/images/external-storage-google-drive-0auth.png
deleted file mode 100644
index f4decc5..0000000
Binary files a/admin_manual/images/external-storage-google-drive-0auth.png and /dev/null differ
diff --git a/admin_manual/images/external-storage-google-drive-9.png b/admin_manual/images/external-storage-google-drive-9.png
deleted file mode 100644
index 9135f6b..0000000
Binary files a/admin_manual/images/external-storage-google-drive-9.png and /dev/null differ
diff --git a/admin_manual/images/external-storage-google-drive-sdk.png b/admin_manual/images/external-storage-google-drive-sdk.png
deleted file mode 100644
index fbee712..0000000
Binary files a/admin_manual/images/external-storage-google-drive-sdk.png and /dev/null differ
diff --git a/admin_manual/images/external-storage-google-drive.png b/admin_manual/images/external-storage-google-drive.png
deleted file mode 100644
index 0598d4d..0000000
Binary files a/admin_manual/images/external-storage-google-drive.png and /dev/null differ
diff --git a/admin_manual/images/external-storage-google-drive1.png b/admin_manual/images/external-storage-google-drive1.png
deleted file mode 100644
index 4313e2d..0000000
Binary files a/admin_manual/images/external-storage-google-drive1.png and /dev/null differ
diff --git a/admin_manual/images/external-storage-google-drive2.png b/admin_manual/images/external-storage-google-drive2.png
deleted file mode 100644
index 1c22e94..0000000
Binary files a/admin_manual/images/external-storage-google-drive2.png and /dev/null differ
diff --git a/admin_manual/images/external-storage-google-drive3.png b/admin_manual/images/external-storage-google-drive3.png
deleted file mode 100644
index 8101e10..0000000
Binary files a/admin_manual/images/external-storage-google-drive3.png and /dev/null differ
diff --git a/admin_manual/images/external-storage-google-drive4.png b/admin_manual/images/external-storage-google-drive4.png
deleted file mode 100644
index 8e1e139..0000000
Binary files a/admin_manual/images/external-storage-google-drive4.png and /dev/null differ
diff --git a/admin_manual/images/external-storage-google-drive5.png b/admin_manual/images/external-storage-google-drive5.png
deleted file mode 100644
index 6c28b0e..0000000
Binary files a/admin_manual/images/external-storage-google-drive5.png and /dev/null differ
diff --git a/admin_manual/images/external-storage-google-drive7.png b/admin_manual/images/external-storage-google-drive7.png
deleted file mode 100644
index fd039b8..0000000
Binary files a/admin_manual/images/external-storage-google-drive7.png and /dev/null differ
diff --git a/admin_manual/images/external-storage-google-drive8.png b/admin_manual/images/external-storage-google-drive8.png
deleted file mode 100644
index 330f2e7..0000000
Binary files a/admin_manual/images/external-storage-google-drive8.png and /dev/null differ
diff --git a/admin_manual/images/google-drive.png b/admin_manual/images/google-drive.png
new file mode 100644
index 0000000..cf5edb2
Binary files /dev/null and b/admin_manual/images/google-drive.png differ
diff --git a/admin_manual/images/google-drive1.png b/admin_manual/images/google-drive1.png
new file mode 100644
index 0000000..4663874
Binary files /dev/null and b/admin_manual/images/google-drive1.png differ
diff --git a/admin_manual/images/google-drive10.png b/admin_manual/images/google-drive10.png
new file mode 100644
index 0000000..136ee34
Binary files /dev/null and b/admin_manual/images/google-drive10.png differ
diff --git a/admin_manual/images/google-drive11.png b/admin_manual/images/google-drive11.png
new file mode 100644
index 0000000..b92521c
Binary files /dev/null and b/admin_manual/images/google-drive11.png differ
diff --git a/admin_manual/images/google-drive12.png b/admin_manual/images/google-drive12.png
new file mode 100644
index 0000000..d9f5679
Binary files /dev/null and b/admin_manual/images/google-drive12.png differ
diff --git a/admin_manual/images/google-drive13.png b/admin_manual/images/google-drive13.png
new file mode 100644
index 0000000..59f116c
Binary files /dev/null and b/admin_manual/images/google-drive13.png differ
diff --git a/admin_manual/images/google-drive2.png b/admin_manual/images/google-drive2.png
new file mode 100644
index 0000000..f3c6da8
Binary files /dev/null and b/admin_manual/images/google-drive2.png differ
diff --git a/admin_manual/images/google-drive3.png b/admin_manual/images/google-drive3.png
new file mode 100644
index 0000000..58612c6
Binary files /dev/null and b/admin_manual/images/google-drive3.png differ
diff --git a/admin_manual/images/google-drive4.png b/admin_manual/images/google-drive4.png
new file mode 100644
index 0000000..79151c0
Binary files /dev/null and b/admin_manual/images/google-drive4.png differ
diff --git a/admin_manual/images/google-drive5.png b/admin_manual/images/google-drive5.png
new file mode 100644
index 0000000..0b60208
Binary files /dev/null and b/admin_manual/images/google-drive5.png differ
diff --git a/admin_manual/images/google-drive6.png b/admin_manual/images/google-drive6.png
new file mode 100644
index 0000000..de522e7
Binary files /dev/null and b/admin_manual/images/google-drive6.png differ
diff --git a/admin_manual/images/google-drive8.png b/admin_manual/images/google-drive8.png
new file mode 100644
index 0000000..7ad55c8
Binary files /dev/null and b/admin_manual/images/google-drive8.png differ
diff --git a/admin_manual/images/google-drive9.png b/admin_manual/images/google-drive9.png
new file mode 100644
index 0000000..2ce998e
Binary files /dev/null and b/admin_manual/images/google-drive9.png differ

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-owncloud/owncloud-doc.git



More information about the Pkg-owncloud-commits mailing list