Giter VIP home page Giter VIP logo

zoomus's Introduction

zoomus

Build Status PyPI Downloads Python Versions PyPI Version PyPI License Code Style: black

https://github.com/prschmid/zoomus

Python wrapper around the Zoom.us REST API v1 and v2.

This work is heavily inspired by the Ruby GEM of the same name, Zoomus

Installation

The easy way

pip install zoomus

Compatibility

zoomus has been tested for Python 3.6, 3.7, and 3.8 using Travis CI

Note, as this library heavily depends on the requests library, official compatibility is limited to the official compatibility of requests.

Example Usage

Create the client v2 (default)

As Zoom's default is now the V2 API, the client will default to the V2 version of the API.

import json
from zoomus import ZoomClient

client = ZoomClient('API_KEY', 'API_SECRET')

user_list_response = client.user.list()
user_list = json.loads(user_list_response.content)

for user in user_list['users']:
    user_id = user['id']
    print(json.loads(client.meeting.list(user_id=user_id).content))

What one will note is that the returned object from a call using the client is a requests Response object. This is done so that if there is any error working with the API that one has complete control of handling all errors. As such, to actually get the list of users in the example above, one will have to load the JSON from the content of the Response object that is returned.

Create the client v1

Zoom has yet to officially remove support for the V1 API, and so to use the V1 API one can instantiate a client as follows.

import json
from zoomus import ZoomClient

client = ZoomClient('API_KEY', 'API_SECRET', version=1)

user_list_response = client.user.list()
user_list = json.loads(user_list_response.content)

for user in user_list['users']:
    user_id = user['id']
    print(json.loads(client.meeting.list(host_id=user_id).content))

Using with a manage context

with ZoomClient('API_KEY', 'API_SECRET') as client:
    user_list_response = client.users.list()
    ...

Available methods

  • client.user.create(...)

  • client.user.cust_create(...)

  • client.user.update(...)*

  • client.user.list(...)

  • client.user.pending(...)

  • client.user.get(...)

  • client.user.get_by_email(...)

  • client.meeting.get(...)

  • client.meeting.end(...)

  • client.meeting.create(...)

  • client.meeting.delete(...)

  • client.meeting.list(...)

  • client.meeting.update(...)

  • client.report.get_account_report(...)

  • client.report.get_user_report(...)

  • client.webinar.create(...)

  • client.webinar.update(...)

  • client.webinar.delete(...)

  • client.webinar.list(...)

  • client.webinar.get(...)

  • client.webinar.end(...)

  • client.webinar.register(...)

  • client.phone.call_logs(...)

  • client.phone.calling_plans(...)

  • client.phone.numbers_get(...)

  • client.phone.numbers_list(...)

  • client.phone.users(...)

Running the Tests

Simple

First, make sure to install the testing requirements

pip install -r requirements-tests.txt

Then run the tests via nose

nosetests

Contributing

Please see the CONTRIBUTING.md for the contribution guidelines for this project.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.