jcwatson11 / nggapi

AngularJS Google API Client

ngGAPI

ngGAPI is a Google APIs client for AngularJS.

Status

Currently Youtube, Google+, Google Calendar, and parts of Blogger and Google Drive are implemented. I'm working (as of 10/20/2013) in my spare time to support the rest of the APIs. Erik Isaksen is helping with this and an example app. Glad to spend some time pair programming with anyone else that wants to contribute. If you want to use ngGAPI but something is missing or doesn't work as expected, please submit an issue, or better yet a pull request. Thanks in advance!

Install

Bower is the quickest way to include ngGAPI in your project.

$ bower install https://github.com/christiansmith/ngGAPI.git --save

<script src="bower_components/ngGAPI/gapi.js"></script>

If you don't use Bower, just download gapi.js into your scripts directory.

$ curl -O https://raw.github.com/christiansmith/ngGAPI/master/gapi.js

<script src="your/js/path/gapi.js"></script>

Usage

Be sure to include "gapi" as a dependency in your main app module.

angular.module('myApp', ['gapi'])

After you register your app in the Google APIs Console, configure ngGAPI with credentials and whatever scopes you need for your app.

angular.module('myApp')
  .value('GoogleApp', {
    apiKey: 'YOUR_API_KEY',
    clientId: 'YOUR_CLIENT_ID',
    scopes: [
      // whatever scopes you need for your app, for example:
      'https://www.googleapis.com/auth/drive',
      'https://www.googleapis.com/auth/youtube',
      'https://www.googleapis.com/auth/userinfo.profile'
      // ...
    ]
  })

To use a specific service, inject it into your controllers by name. All GAPI methods return a promise.

angular.module('myApp')
  .controller('VideosCtrl', function ($scope, Youtube) {
    $scope.videos = Youtube.search({ part: 'snippet', q: 'Search terms' })
  });

Services

GAPI authorization

• GAPI.init()

Admin Directory::users

• Users
  • AdminDirectory.insertUsers(params)
  • AdminDirectory.updateUsers(id, params)
  • AdminDirectory.patchUsers(id, params)
  • AdminDirectory.deleteUsers(id, params)
  • AdminDirectory.makeAdmin(id)
  • AdminDirectory.unMakeAdmin(id)
  • AdminDirectory.getUsers(id)
  • AdminDirectory.listUsers(params)

Admin Directory::groups

• Users
  • AdminDirectory.insertGroups(params)
  • AdminDirectory.updateGroups(id, params)
  • AdminDirectory.patchGroups(id, params)
  • AdminDirectory.deleteGroups(id, params)
  • AdminDirectory.getGroups(id)
  • AdminDirectory.listGroups(params)

Drive

• Files

  • Drive.getFiles(fileId, params)
  • Drive.insertFiles(data, params)
  • Drive.patchFiles(fileId, data, params)
  • Drive.updateFiles(fileId, data, params)
  • Drive.copyFiles(fileId, data, params)
  • Drive.deleteFiles(fileId)
  • Drive.listFiles(params)
  • Drive.touchFiles(fileId)
  • Drive.trashFiles(fileId)
  • Drive.untrashFiles(fileId)
  • Drive.watchFiles(fileId, data)

• About

  • Drive.about(params)

• Changes

  • Drive.getChanges(changeId)
  • Drive.listChanges(params)
  • Drive.watchChanges(data)

• Children

  • Drive.deleteChildren(folderId, childId)
  • Drive.getChildren(folderId, childId)
  • Drive.insertChildren(folderId, data)
  • Drive.listChildren(folderId, params)

• Parents

  • Drive.deleteParents(fileId, parentId)
  • Drive.getParents(fileId, parentId)
  • Drive.insertParents(fileId, data)
  • Drive.listParents(fileId)

• Permissions

  • Drive.deletePermissions(fileId, permissionId)
  • Drive.getPermissions(fileId, permissionId)
  • Drive.insertPermissions(fileId, data, params)
  • Drive.listPermissions(fileId)
  • Drive.patchPermissions(fileId, permissionId, data, params)
  • Drive.updatePermissions(fileId, permissionId, data, params)
  • Drive.getPermissionIdForEmail(email)

• Revisions

  • Drive.deleteRevisions(fileId, revisionId)
  • Drive.getRevisions(fileId, revisionId)
  • Drive.listRevisions(fileId)
  • Drive.patchRevisions(fileId, revisionId, data)
  • Drive.updateRevisions(fileId, revisionId, data, params)

• Apps

  • Drive.listApps()
  • Drive.getApps(appId)

• Comments

  • Drive.deleteComments(fileId, commentId)
  • Drive.getComments(fileId, commentId, params)
  • Drive.insertComments(fileId, data, params)
  • Drive.listComments(fileId, params)
  • Drive.patchComments(fileId, commentId, data, params)
  • Drive.updateComments(fileId, commentId, data, params)

• Replies

  • Drive.deleteReplies(fileId, commentId, replyId)
  • Drive.getReplies(fileId, commentId, replyId, params)
  • Drive.insertReplies(fileId, commentId, data)
  • Drive.listReplies(fileId, commentId, params)
  • Drive.patchReplies(fileId, commentId, replyId, data)
  • Drive.updateReplies(fileId, commentId, replyId, data)

• Properties

  • Drive.deleteProperties(fileId, propertyKey)
  • Drive.getProperties(fileId, propertyKey)
  • Drive.insertProperties(fileId, data)
  • Drive.listProperties(fileId)
  • Drive.patchProperties(fileId, propertyKey, data, params)
  • Drive.updateProperties(fileId, propertyKey, data, params)

• Channels

  • Drive.stopChannels(data)

• Realtime

  • Drive.getRealtime(fileId)
  • Drive.updateRealtime(fileId, params)

Youtube

Official Youtube DATA API (v3) reference documentation

• Activities

  • Youtube.listActivities(params)
  • Youtube.insertActivities(data, params)

• ChannelBanners

  • Youtube.insertChannelBanners()

• Channels

  • Youtube.listChannels(params)
  • Youtube.updateChannels(data, params)

• GuideCategories

  • Youtube.listGuideCategories(params)

• PlaylistItems

  • Youtube.listPlaylistItems(params)
  • Youtube.insertPlaylistItems(data, params)
  • Youtube.updatePlaylistItems(data, params)
  • Youtube.deletePlaylistItems(params)

• Playlists

  • Youtube.listPlaylists(params)
  • Youtube.insertPlaylists(data, params)
  • Youtube.updatePlaylists(data, params)
  • Youtube.deletePlaylists(params)

• Search

  • Youtube.search()

• Subscriptions

  • Youtube.listSubscriptions(params)
  • Youtube.insertSubscriptions(data, params)
  • Youtube.deleteSubscriptions(params)

• Thumbnails

  • Youtube.setThumbnails(params)

• VideoCategories

  • Youtube.listVideoCategories(params)

• Videos

  • Youtube.listVideos(params)
  • Youtube.insertVideos(data, params)
  • Youtube.updateVideos(data, params)
  • Youtube.deleteVideos(params)
  • Youtube.rateVideos(params)
  • Youtube.getVideoRatings(params)

• Watermarks

  • Youtube.setWatermarks()
  • Youtube.unsetWatermarks()

Google+

• People

  • Plus.getPeople(userId)
  • Plus.searchPeople(params)
  • Plus.listPeopleByActivity(activityId, collection)
  • Plus.listPeople(userId, collection, params)

• Activities

  • Plus.listActivities(userId, collection, params)
  • Plus.getActivities(activityId)
  • Plus.searchActivities(params)

• Comments

  • Plus.listComments(activityId, params)
  • Plus.getComments(commentId)

• Moments

  • Plus.insertMoments(userId, collection, data, params)
  • Plus.listMoments(userId, collection, params)
  • Plus.removeMoments(id)

Calendar API

• ACL

  • Calendar.deleteAcl(calendarId, ruleId)
  • Calendar.getAcl(calendarId, ruleId)
  • Calendar.insertAcl(calendarId, data)
  • Calendar.listAcl(calendarId)
  • Calendar.updateAcl(calendarId, ruleId, data)
  • Calendar.patchAcl(calendarId, ruleId, data)

• CalendarList

  • Calendar.deleteCalendarList(calendarId)
  • Calendar.getCalendarList(calendarId)
  • Calendar.insertCalendarList(data)
  • Calendar.listCalendarList(params)
  • Calendar.updateCalendarList(calendarId, data)
  • Calendar.patchCalendarList(calendarId, data)

• Calendars

  • Calendar.clearCalendars(calendarId)
  • Calendar.deleteCalendars(calendarId)
  • Calendar.getCalendars(calendarId)
  • Calendar.insertCalendars(data)
  • Calendar.updateCalendars(calendarId, data)
  • Calendar.patchCalendars(calendarId, data)

• Colors

  • Calendar.getColors()

• Events

  • Calendar.deleteEvents(calendarId, eventId)
  • Calendar.getEvents(calendarId, eventId, params)
  • Calendar.importEvents(calendarId, data, params)
  • Calendar.insertEvents(calendarId, data, params)
  • Calendar.listEventInstances(calendarId, eventId, params)
  • Calendar.listEvents(calendarId, params)
  • Calendar.moveEvents(calendarId, eventId, params)
  • Calendar.quickAdd(calendarId, params)
  • Calendar.updateEvents(calendarId, eventId, data, params)
  • Calendar.patchEvents(calendarId, eventId, data, params)
  • Calendar.watchEvents(calendarId, data)

• FreeBusy

  • Calendar.freeBusy(data)

• Settings

  • Calendar.getSettings(setting)
  • Calendar.listSettings()

• Channels

  • Calendar.stopWatching(data)

Development

Installing the Karma test runner with npm install karma -g, then run the tests with karma start.

Copyright and License

The library is Copyright (c) 2013 Christian Smith, and distributed under the MIT License.