Google docs credentials

.gitignore

@@ -1,3 +1,4 @@
+__pycache__/
 node_modules
 *.mo
 dist

backend/exporter/gdocs.py

@@ -9,7 +9,7 @@
 from django.conf import settings
 from django.core.files.base import ContentFile
 from django.core.files.storage import default_storage
-from google.oauth2.credentials import Credentials
+from google.oauth2.service_account import Credentials
 from googleapiclient.discovery import build
 from googleapiclient.errors import HttpError, ResumableUploadError
 from googleapiclient.http import MediaFileUpload
@@ -31,7 +31,7 @@ def __init__(self, main_template_id: str):
         # TODO: use default_storage
         if os.path.exists(settings.TOKEN_PATH):
             with open(settings.TOKEN_PATH) as f:
-                self.creds = Credentials.from_authorized_user_info(json.load(f))
+                self.creds = Credentials.from_service_account_info(json.load(f))
                 self.drive_service = build("drive", "v3", credentials=self.creds, cache_discovery=False)
         else:
             raise RuntimeError("Unable to find token file")

docs/contributing/index.rst

@@ -66,6 +66,15 @@ Install development dependencies:
 
    npm install
 
+Export to Google Docs
+~~~~~~~~~~~~~~~~~~~~~
+
+For exporting to Google Docs, we use a Google `Service Account <https://developers.google.com/workspace/guides/create-credentials?hl=en#service-account/>`__.
+
+For managing that account someone with the admin role can go to the `OCP Google Cloud console <https://console.cloud.google.com/apis/credentials?referrer=search&orgonly=true&project=pelican-289615&supportedpurview=organizationId/>`__.
+
+For a guide on how to create a new account or download the account credentials, you can refer to the `official documentation <https://developers.google.com/workspace/guides/create-credentials?hl=en#service-account/>`__.
+
 .. _development:
 
 Development

docs/export.rst

@@ -7,6 +7,12 @@ The exported *document* is built from *templates* in Google Docs.
 
 *Tags* are added to templates to generate content within the document.
 
+.. note::
+
+   The main template, sub-templates and the export folder must be shared with the
+   `Service Account <https://developers.google.com/workspace/guides/create-credentials?hl=en#service-account/>`__
+   [email protected]
+
 Tag syntax
 ----------