go>> google-drive-python>> 返回
项目作者： eduardogr

项目描述 ：
Library and cli to manage and interact with your Google Drive. https://pypi.org/project/google-drive/
高级语言： Python
项目地址: git://github.com/eduardogr/google-drive-python.git
创建时间： 2020-11-14T00:45:11Z
项目社区：https://github.com/eduardogr/google-drive-python
开源协议：Apache License 2.0
下载


google drive python


Library and cli to manage and interact with your Google Drive, sheets and docs

Table of Contents

  1. Introduction
  2. Obtaining credentials for Google APIs
  3. Installing google-drive CLI
  4. CLI documentation
  5. Library documentation
  6. Contributing
  7. License

Introduction

Build Status
Python
PRs Welcome
GitHub license

Obtaining credentials for Google APIs

Google API credentials

Create a Google project :zap:

Just access to Google APIs.

Create credentials for your project :key:

Once you have created your project, you can create your project’s credentials.

To manage project’s credentials you have the section api/credentials within Google APIs. But if this is your first credentials creation you better follow these steps:

  • First, you have to create the consent for your project
  • Once the consent is already created and you have a name for you google app you can create your credentials:
    • Go to + Create Credentials and select OAuth ID client
    • Or access to api/credentials/oauthclient
    • The OAuth client type is other and choose the name you prefer :smiley:

You have already created your credentials! :fireworks:

Just place them in a credentials.json file in the root of this repository. :heavy_exclamation_mark::heavy_exclamation_mark:

Enable Google APIs :books:

You can see where you have to access for each google api in the doc google apis usage

Generating your token.pickle :unlock:

To authenticate us we have to send a token.pickle to Google APIs, this token.pickle is generated using the file credentials.json.

To generate this we have the make target google-auth, so, you just have to tun

  • make google-auth

:warning: Credentials files to authenticate yourself are included in our .gitignore

:angel: So, you don’t have to worry about that :smiley:

Installing google-drive CLI

Using pipx

  1. pipx install git+https://github.com/eduardogr/google-drive-python.git

Using pip

  1. pip install google-drive

With specific version

Look for available versions with:

  1. pip install google-drive==

And select one and run:

  1. pip install google-drive==<VERSION>

CLI documentation

google-drive —help

Shows the help message

Usage

  1. > google-drive --help
  2. Usage: google-drive [OPTIONS] COMMAND [ARGS]...
  4. Options:
  5.   --help  Show this message and exit.
  7. Commands:
  8.   get    Get file metadata
  9.   get-mimetypes  Get Mimetypes availables in this API implementation
  10.   login  Perform a login with google oauth
  11.   ls     List directory contents
  12.   mkdir  Make directory

google-drive get-mimetypes

Get Mimetypes availables in this API implementation

Usage

  1. >  google-drive get-mimetypes credentials.json
  2.   - application/vnd.google-apps.folder
  3.   - application/vnd.google-apps.document
  4.   - application/vnd.google-apps.spreadsheet
  5.   - application/pdf

google-drive login

Perform a login with google oauth.

Usage

  1. > google-drive login <path-to-credentials-file.json>

google-drive ls

List directory contents

Usage

  1. > google-drive ls <directory>/<maybe-some-subdir> <path-to-credentials-file.json>
  2. - (<GOOGLE_DOC_ID_1>, <FILENAME_1>, <FILE_MIMETYPE_1>)
  3. - (<GOOGLE_DOC_ID_2>, <FILENAME_2>, <FILE_MIMETYPE_2>)
  4. - (<GOOGLE_DOC_ID_3>, <FILENAME_3>, <FILE_MIMETYPE_3>)
  5. ...
  6. - (<GOOGLE_DOC_ID_N>, <FILENAME_N>, <FILE_MIMETYPE_N>)

google-drive get

Get file metadata

Usage

  1. > google-drive get <GOOGLE_DOC_ID> <path-to-credentials-file.json>
  3. File Metadata:
  4. ==
  5. id: <GOOGLE_DOC_ID>
  6. name: <FILENAME>
  7. parents: ['<GOOGLE_DOC__PARENT_ID>']
  8. mime_type: <FILE_MIMETYPE>
  9. export_links:
  10.   - application/rtf: https://docs.google.com/feeds/download/documents/export/Export?id=<GOOGLE_DOC_ID>&exportFormat=rtf
  11.   - application/vnd.oasis.opendocument.text: https://docs.google.com/feeds/download/documents/export/Export?id=<GOOGLE_DOC_ID>&exportFormat=odt
  12.   - text/html: https://docs.google.com/feeds/download/documents/export/Export?id=<GOOGLE_DOC_ID>&exportFormat=html
  13.   - application/pdf: https://docs.google.com/feeds/download/documents/export/Export?id=<GOOGLE_DOC_ID>&exportFormat=pdf
  14.   - application/epub+zip: https://docs.google.com/feeds/download/documents/export/Export?id=<GOOGLE_DOC_ID>&exportFormat=epub
  15.   - application/zip: https://docs.google.com/feeds/download/documents/export/Export?id=<GOOGLE_DOC_ID>&exportFormat=zip
  16.   - application/vnd.openxmlformats-officedocument.wordprocessingml.document: https://docs.google.com/feeds/download/documents/export/Export?id=<GOOGLE_DOC_ID>&exportFormat=docx
  17.   - text/plain: https://docs.google.com/feeds/download/documents/export/Export?id=<GOOGLE_DOC_ID>&exportFormat=txt

google-drive mkdir

Make directory

Usage

  1. > google-drive mkdir <DIR_NAME> <path-to-credentials-file.json>
  2. (<GOOGLE_DOC_ID>, <DIR_NAME>, application/vnd.google-apps.folder)

google-drive touch

Create empty file of specified mimetype

Usage

  1. > google-drive touch <EXISTING_DIR>/<FILENAME> <SOME_MYMETYPE> <path-to-credentials-file.json>
  2. (<GOOGLE_DOC_ID>, <FILENAME>, <SOME_MYMETYPE>)

It could raise MissingGoogleDriveFolderException when parent directories do not exist.

Library documentation

Using googledrive as a library.

TBC

Contributing

PRs Welcome

Contributions are welcome! Please see our Contributing Guide and Style Guide for more
details.

You can visit our TODO list :)

License

This project is licensed under the Apache license.