google-api-client 0.8.6 → 0.9

data/samples/lib/samples/pubsub.rb

@@ -0,0 +1,114 @@
+# Copyright 2016 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'google/apis/pubsub_v1'
+require 'base_cli'
+
+
+module Samples
+  # Examples for the Google Cloud Pub/Sub API.
+  #
+  # Sample usage session:
+  #
+  #     $ ./google-api-samples pubsub create_topic mytopic --project=623040240964
+  #     # ./google-api-samples pubsub subscribe mysub --topic=mytopic --project=623040240964
+  #     $ ./google-api-samples pubsub publish 'Hello!' --topic=mytopic --project=623040240964
+  #     $ ./google-api-samples pubsub pull mysub --project=623040240964
+  #     Received: Hello!
+  #     $ ./google-api-samples pubsub unsubscribe mysub --project=623040240964
+  #     $ ./google-api-samples pubsub delete_topic mytopic --project=623040240964
+  #
+  class PubSub < BaseCli
+    Pubsub = Google::Apis::PubsubV1
+
+    desc 'create_topic TOPIC_NAME', 'Create a topic'
+    method_option :project, type: :string, required: true
+    def create_topic(name)
+      pubsub = Pubsub::PubsubService.new
+      pubsub.authorization = Google::Auth.get_application_default([Pubsub::AUTH_PUBSUB])
+      topic = "projects/#{options[:project]}/topics/#{name}"
+
+      pubsub.create_topic(topic)
+    end
+
+    desc 'delete_topic TOPIC_NAME', 'Delete a topic'
+    method_option :project, type: :string, required: true
+    def delete_topic(name)
+      pubsub = Pubsub::PubsubService.new
+      pubsub.authorization = Google::Auth.get_application_default([Pubsub::AUTH_PUBSUB])
+
+      topic = "projects/#{options[:project]}/topics/#{name}"
+
+      pubsub.delete_topic(topic)
+    end
+
+    desc 'subscribe SUBSCRIPTION_NAME', 'Subscribe to a topic'
+    method_option :project, type: :string, required: true
+    method_option :topic, type: :string, required: true
+    def subscribe(name)
+      pubsub = Pubsub::PubsubService.new
+      pubsub.authorization = Google::Auth.get_application_default([Pubsub::AUTH_PUBSUB])
+
+      topic = "projects/#{options[:project]}/topics/#{options[:topic]}"
+      subscription = "projects/#{options[:project]}/subscriptions/#{name}"
+      pubsub.create_subscription(subscription, Pubsub::Subscription.new(topic: topic))
+    end
+
+    desc 'unsubscribe subscription_name', 'Ububscribe from a topic'
+    method_option :project, type: :string, required: true
+    def unsubscribe(name)
+      pubsub = Pubsub::PubsubService.new
+      pubsub.authorization = Google::Auth.get_application_default([Pubsub::AUTH_PUBSUB])
+
+      subscription = "projects/#{options[:project]}/subscriptions/#{name}"
+      pubsub.delete_subscription(subscription)
+    end
+
+
+    desc 'publish MESSAGE', 'Publish a message to a topic'
+    method_option :project, type: :string, required: true
+    method_option :topic, type: :string, required: true
+    def publish(message)
+      pubsub = Pubsub::PubsubService.new
+      pubsub.authorization = Google::Auth.get_application_default([Pubsub::AUTH_PUBSUB])
+      topic = "projects/#{options[:project]}/topics/#{options[:topic]}"
+
+      request = Pubsub::PublishRequest.new(messages: [])
+      request.messages << Pubsub::Message.new(data: message)
+
+      pubsub.publish_topic(topic, request)
+    end
+
+    desc 'pull SUBSCRIPTION_NAME', 'Pull message(s) from the topic'
+    method_option :project, type: :string, required: true
+    method_option :max, type: :numeric, default: 5
+    def pull(name)
+      pubsub = Pubsub::PubsubService.new
+      pubsub.authorization = Google::Auth.get_application_default([Pubsub::AUTH_PUBSUB])
+
+      subscription = "projects/#{options[:project]}/subscriptions/#{name}"
+
+      # Pull messages
+      response = pubsub.pull_subscription(subscription, Pubsub::PullRequest.new(max_messages: options[:max]))
+      response.received_messages.each do |received_message|
+        data = received_message.message.data
+        puts "Received: #{data}"
+      end
+
+      # Acknowledge receipt
+      ack_ids = response.received_messages.map{ |msg| msg.ack_id }
+      pubsub.acknowledge_subscription(subscription, Pubsub::AcknowledgeRequest.new(ack_ids: ack_ids))
+    end
+  end
+end

data/samples/lib/samples/translate.rb

@@ -0,0 +1,44 @@
+# Copyright 2016 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'google/apis/translate_v2'
+require 'base_cli'
+
+
+module Samples
+  # Examples for the Google Translate API
+  #
+  # Sample usage:
+  #
+  #      $ ./google-api-samples translate 'Hola!' --target='en'
+  #      Hello
+  #
+  class Translate < BaseCli
+    Translate = Google::Apis::TranslateV2
+
+    desc 'translate PHRASE', 'Translate a phrase'
+    method_option :source, type: :string
+    method_option :target, type: :string, required: true
+    def translate(phrase)
+      translate = Translate::TranslateService.new
+      translate.key = api_key
+
+      result = translate.list_translations(phrase, options[:target], source: options[:source])
+      puts result.translations.first.translated_text
+    end
+
+    default_task :translate
+
+  end
+end

data/samples/lib/samples/you_tube.rb

@@ -0,0 +1,44 @@
+# Copyright 2016 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'google/apis/youtube_v3'
+require 'base_cli'
+
+
+module Samples
+  # Examples for the YouTube APIs
+  #
+  # Sample usage:
+  #
+  #     $ ./google-api-samples youtube upload ~/myvideo.mov --title="So funny!"
+  #
+  class YouTube < BaseCli
+    YT = Google::Apis::YoutubeV3
+
+    desc 'upload FILE', 'Upload a video to YouTube'
+    method_option :title, type: :string
+    def upload(file)
+      youtube = YT::YouTubeService.new
+      youtube.authorization = user_credentials_for(YT::AUTH_YOUTUBE)
+
+      metadata  = {
+        snippet: {
+          title: options[:title] || file
+        }
+      }
+      result = youtube.insert_video('snippet', metadata, upload_source: file)
+      say "Upload complete"
+    end
+  end
+end

data/script/generate

@@ -0,0 +1,95 @@
+#!/usr/bin/env bash
+# Usage: script/generate
+# Update packaged APIs
+
+DIR=$(dirname $( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd ))
+
+APIS=(adexchangebuyer:v1.3 \
+	adexchangeseller:v2.0 \
+	admin:directory_v1 \
+  admin:datatransfer_v1 \
+	admin:reports_v1 \
+	adsense:v1.4 \
+	adsensehost:v4.1 \
+	analytics:v3 \
+	androidenterprise:v1 \
+	androidpublisher:v2 \
+  appengine:v1beta4 \
+	appsactivity:v1 \
+	appstate:v1 \
+	autoscaler:v1beta2 \
+	bigquery:v2 \
+	blogger:v3 \
+	books:v1 \
+	calendar:v3 \
+	civicinfo:v2 \
+	classroom:v1 \
+  cloudbilling:v1 \
+  clouddebugger:v2 \
+  cloudmonitoring:v2beta2 \
+	cloudresourcemanager:v1beta1 \
+  cloudtrace:v1 \
+	clouduseraccounts:beta \
+	compute:v1 \
+	compute:beta \
+	container:v1 \
+	content:v2 \
+	coordinate:v1 \
+	customsearch:v1 \
+	datastore:v1beta2 \
+  deploymentmanager:v2 \
+	dfareporting:v2.1 \
+	discovery:v1 \
+	dns:v1 \
+	doubleclickbidmanager:v1 \
+	doubleclicksearch:v2 \
+	drive:v2 \
+	drive:v3 \
+	fitness:v1 \
+	fusiontables:v2 \
+	games:v1 \
+	gamesConfiguration:v1configuration \
+	gamesManagement:v1management \
+	gan:v1beta1 \
+	genomics:v1 \
+	gmail:v1 \
+	groupsmigration:v1 \
+	groupssettings:v1 \
+	identitytoolkit:v3 \
+	kgsearch:v1 \
+	licensing:v1 \
+	logging:v1beta3 \
+	manager:v1beta2 \
+	mapsengine:v1 \
+	mirror:v1 \
+	oauth2:v2 \
+	pagespeedonline:v2 \
+  partners:v2 \
+	plus:v1 \
+	plusDomains:v1 \
+	prediction:v1.6 \
+  proximitybeacon:v1beta1 \
+	pubsub:v1 \
+	qpxExpress:v1 \
+	replicapool:v1beta2 \
+	replicapoolupdater:v1beta1 \
+	reseller:v1 \
+	resourceviews:v1beta2 \
+	script:v1 \
+	siteVerification:v1 \
+	sqladmin:v1beta4 \
+	storage:v1 \
+	storagetransfer:v1 \
+	tagmanager:v1 \
+	taskqueue:v1beta2 \
+	tasks:v1 \
+	translate:v2 \
+	urlshortener:v1 \
+	webmasters:v3 \
+	youtube:v3 \
+	youtubeAnalytics:v1 \
+	youtubereporting:v1 \
+)
+
+
+echo 'a' | bundle exec bin/generate-api gen generated --from-discovery=true --names_out=$DIR/api_names_out.yaml --url='https://content.googleapis.com/discovery/v1/apis/compute/beta/rest'  --id=${APIS[*]}

data/script/package

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+# Usage: script/gem
+# Updates the gemspec and builds a new gem in the pkg directory.
+
+mkdir -p pkg
+gem build *.gemspec
+mv *.gem pkg
+

data/script/release

@@ -0,0 +1,15 @@
+#!/usr/bin/env bash
+# Usage: script/release
+# Build the package, tag a commit, push it to origin, and then release the
+# package publicly.
+
+set -e
+
+version="$(script/package | grep Version: | awk '{print $2}')"
+[ -n "$version" ] || exit 1
+
+git commit --allow-empty -a -m "Release $version"
+git tag "$version"
+git push --tags origin
+gem push pkg/*-${version}.gem
+

data/spec/fixtures/files/api_names.yaml

@@ -0,0 +1,3 @@
+---
+"/test:v1/TestAnotherThing": another_thing
+

data/spec/fixtures/files/auth_stored_credentials.json

@@ -0,0 +1,8 @@
+{   "access_token":"access_token_123456789",
+    "authorization_uri":"https://accounts.google.com/o/oauth2/auth",
+    "client_id":"123456789p.apps.googleusercontent.com",
+    "client_secret":"very_secret",
+    "expires_in":3600,
+    "refresh_token":"refresh_token_12345679",
+    "token_credential_uri":"https://accounts.google.com/o/oauth2/token",
+    "issued_at":1386053761}

data/spec/fixtures/files/client_secrets.json

@@ -0,0 +1 @@
+{"installed":{"auth_uri":"https://accounts.google.com/o/oauth2/auth","client_secret":"i8YaXdGgiQ4_KrTVNGsB7QP1","token_uri":"https://accounts.google.com/o/oauth2/token","client_email":"","client_x509_cert_url":"","client_id":"898243283568.apps.googleusercontent.com","auth_provider_x509_cert_url":"https://www.googleapis.com/oauth2/v1/certs"}}

data/spec/fixtures/files/invalid.json

@@ -0,0 +1 @@
+{"invalid"}

data/spec/fixtures/files/test.blah

@@ -0,0 +1 @@
+test

data/spec/fixtures/files/test.txt

@@ -0,0 +1 @@
+Hello world

data/spec/fixtures/files/test_api.json

@@ -0,0 +1,440 @@
+{
+  "kind": "discovery#describeItem",
+  "name": "test",
+  "version": "v1",
+  "id": "test:v1",
+  "description": "Discovery doc API used for testing the code generator",
+  "basePath": "/test/",
+  "rootUrl": "https://www.googleapis.com/",
+  "servicePath": "test/v1/",
+  "rpcPath": "/rpc",
+  "auth": {
+    "oauth2": {
+     "scopes": {
+      "https://www.googleapis.com/auth/test": {
+       "description": "View and manage things"
+      },
+      "https://www.googleapis.com/auth/test.readonly": {
+       "description": "View things"
+      }
+     }
+    }
+   },
+   "parameters": {
+    "alt": {
+      "type": "string",
+      "description": "Data format for the response.",
+      "default": "json",
+      "enum": [
+        "json"
+      ],
+      "enumDescriptions": [
+        "Responses with Content-Type of application/json"
+      ],
+      "location": "query"
+    },
+    "fields": {
+      "type": "string",
+      "description": "Selector specifying which fields to include in a partial response.",
+      "location": "query"
+    },
+    "key": {
+      "type": "string",
+      "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
+      "location": "query"
+    },
+    "oauth_token": {
+      "type": "string",
+      "description": "OAuth 2.0 token for the current user.",
+      "location": "query"
+    },
+    "prettyPrint": {
+      "type": "boolean",
+      "description": "Returns response with indentations and line breaks.",
+      "default": "true",
+      "location": "query"
+    },
+    "quotaUser": {
+      "type": "string",
+      "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. Overrides userIp if both are provided.",
+      "location": "query"
+    },
+    "userIp": {
+      "type": "string",
+      "description": "IP address of the site where the request originates. Use this if you want to enforce per-user limits.",
+      "location": "query"
+    }
+  },
+  "schemas": {
+    "Thing": {
+      "id": "Thing",
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "etag": {
+          "type": "string"
+        },
+        "kind": {
+          "type": "string",
+          "default": "test#thing"
+        },
+        "name": {
+          "type": "string"
+        },
+        "enabled": {
+          "type": "boolean"
+        },
+        "hat": {
+          "$ref": "Hat"
+        },
+        "properties": {
+          "$ref": "HashLikeThing"
+        },
+        "photo": {
+          "type": "object",
+          "properties": {
+            "filename": {
+              "type": "string"
+            },
+            "hash": {
+              "type": "string"
+            },
+            "hashAlgorithm": {
+              "type": "string"
+            },
+            "size": {
+              "type": "integer"
+            },
+            "type": {
+              "type": "string"
+            }
+          }
+        }
+      }
+    },
+    "Hat": {
+      "type": "object",
+      "variant": {
+        "discriminant": "type",
+        "map": [
+          {
+            "type_value": "topHat",
+            "$ref": "TopHat"
+          },
+          {
+            "type_value": "baseballHat",
+            "$ref": "BaseballHat"
+          }
+        ]
+      }
+    },
+    "TopHat": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string"
+        },
+        "height": {
+          "type": "number"
+        }
+      }
+    },
+    "BaseballHat": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string"
+        },
+        "color": {
+          "type": "string"
+        }
+      }
+    },
+    "HashLikeThing": {
+      "id": "HashLikeThing",
+      "type": "object",
+      "additionalProperties": {
+        "type": "string",
+        "description": "A mapping from export format to URL"
+      }
+    },
+    "TestThing": {
+      "id": "TestThing",
+      "type": "object",
+      "properties" :{}
+    },
+    "TestAnotherThing": {
+      "id": "TestAnotherThing",
+      "type": "object",
+      "properties" :{}
+    },
+    "ThingList": {
+      "id": "ThingList",
+      "type": "object",
+      "properties": {
+        "items": {
+          "type": "array",
+          "description": "The actual list of files.",
+          "items": {
+            "$ref": "Thing"
+          }
+        },
+        "kind": {
+          "type": "string",
+          "default": "test#thinglist"
+        }
+      }
+    },
+    "QueryResults": {
+      "id": "QueryResults",
+      "type": "object",
+      "properties": {
+        "rows": {
+          "$ref": "Rows"
+        }
+      }
+    },
+    "Rows": {
+      "id": "QueryResults",
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "value": {
+            "type": "string"
+          }
+        }
+      }
+    }
+  },
+  "methods": {
+    "query": {
+      "path": "query",
+      "id": "test.query",
+      "httpMethod": "GET",
+      "response": {
+        "$ref": "QueryResults"
+        //"$ref": "Rows" TODO: Support naked collections as a return value
+      },
+      "parameters": {
+        "s": {
+          "type": "string",
+          "location": "query",
+          "required": false,
+          "repeated": false
+        },
+        "i": {
+          "type": "integer",
+          "location": "query",
+          "required": false,
+          "repeated": false,
+          "minimum": "0",
+          "maximum": "4294967295",
+          "default": "20"
+        },
+        "n": {
+          "type": "number",
+          "location": "query",
+          "required": false,
+          "repeated": false
+        },
+        "b": {
+          "type": "boolean",
+          "location": "query",
+          "required": false,
+          "repeated": false
+        },
+        "a": {
+          "type": "any",
+          "location": "query",
+          "required": false,
+          "repeated": false
+        },
+        "e": {
+          "type": "string",
+          "location": "query",
+          "required": false,
+          "repeated": false,
+          "enum": [
+            "foo",
+            "bar"
+          ]
+        },
+        "er": {
+          "type": "string",
+          "location": "query",
+          "required": false,
+          "repeated": true,
+          "enum": [
+            "one",
+            "two",
+            "three"
+          ]
+        },
+        "sr": {
+          "type": "string",
+          "location": "query",
+          "required": false,
+          "repeated": true,
+          "pattern": "[a-z]+"
+        },
+        "do": {
+          "type": "string",
+          "location": "query",
+          "required": false
+        }
+      }
+    }
+  },
+  "resources": {
+    "things": {
+      "resources": {
+        "subthings": {
+          "methods": {
+            "list": {
+              "path": "things",
+              "id": "test.things.subthings.list",
+              "httpMethod": "GET",
+              "parameters": {
+                "max-results": {
+                  "type": "number",
+                  "location": "query",
+                  "required": false
+                }
+              },
+              "response": {
+                "$ref": "ThingList"
+              }
+            }
+          }
+        }
+      },
+      "methods": {
+        "list": {
+          "path": "things",
+          "id": "test.things.list",
+          "httpMethod": "GET",
+          "parameters": {
+            "max-results": {
+              "type": "number",
+              "location": "query",
+              "required": false
+            }
+          },
+          "response": {
+            "$ref": "ThingList"
+          }
+        },
+        "delete": {
+          "path": "things/{id}",
+          "id": "test.things.delete",
+          "httpMethod": "DELETE",
+          "description": "Delete things",
+          "parameters": {
+            "id": {
+              "location": "path",
+              "required": true,
+              "description": "ID of the thing to delete",
+              "type": "string"
+            }
+          },
+          "parameterOrder": [
+            "id"
+          ]
+        },
+        "get": {
+          "path": "things/{id}",
+          "id": "test.things.get",
+          "httpMethod": "GET",
+          "description": "Get things",
+          "supportsMediaDownload": true,
+          "parameters": {
+            "id": {
+              "location": "path",
+              "required": true,
+              "description": "ID of the thing to get",
+              "type": "string"
+            }
+          },
+          "supportsMediaDownload": true,
+          "parameterOrder": [
+            "id"
+          ],
+          "response": {
+            "$ref": "Thing"
+          }
+        },
+        "create": {
+          "path": "things",
+          "id": "test.things.create",
+          "httpMethod": "POST",
+          "description": "Create things",
+          "request": {
+            "$ref": "Thing"
+          },
+          "response": {
+            "$ref": "Thing"
+          },
+          "supportsMediaUpload": true,
+          "mediaUpload": {
+            "accept": [
+              "*/*"
+            ],
+            "maxSize": "1KB",
+            "protocols": {
+              "simple": {
+                "multipart": true,
+                "path": "upload/things/{id}"
+              },
+              "resumable": {
+                "multipart": true,
+                "path": "/resumable/upload/things/{id}"
+              }
+            }
+          }
+        },
+        "update": {
+          "path": "things/{id}",
+          "id": "test.things.update",
+          "httpMethod": "PUT",
+          "description": "Update things",
+          "parameters": {
+            "id": {
+              "location": "path",
+              "description": "ID of the thing to update",
+              "type": "string"
+            }
+          },
+          "parameterOrder": [
+            "id"
+          ],
+          "request": {
+            "$ref": "Thing"
+          },
+          "response": {
+            "$ref": "Thing"
+          },
+          "supportsMediaUpload": true,
+          "mediaUpload": {
+            "accept": [
+              "*/*"
+            ],
+            "maxSize": "1KB",
+            "protocols": {
+              "simple": {
+                "multipart": true,
+                "path": "upload/things/{id}"
+              },
+              "resumable": {
+                "multipart": true,
+                "path": "/resumable/upload/things/{id}"
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}