target.rb in google-cloud-tasks-0.3.0

- old
+ new

@@ -1,6 +1,6 @@
-# Copyright 2018 Google LLC
+# Copyright 2019 Google LLC
 #
 # 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
 #
@@ -58,10 +58,15 @@
         # The task will be delivered to the App Engine app which belongs to the same
         # project as the queue. For more information, see
         # [How Requests are Routed](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed)
         # and how routing is affected by
         # [dispatch files](https://cloud.google.com/appengine/docs/python/config/dispatchref).
+        # Traffic is encrypted during transport and never leaves Google datacenters.
+        # Because this traffic is carried over a communication mechanism internal to
+        # Google, you cannot explicitly set the protocol (for example, HTTP or HTTPS).
+        # The request to the handler, however, will appear to have used the HTTP
+        # protocol.
         #
         # The {Google::Cloud::Tasks::V2beta3::AppEngineRouting AppEngineRouting} used to construct the URL that the task is
         # delivered to can be set at the queue-level or task-level:
         #
         # * If set,
@@ -74,10 +79,18 @@
         # The `url` that the task will be sent to is:
         #
         # * `url =` {Google::Cloud::Tasks::V2beta3::AppEngineRouting#host host} `+`
         #   {Google::Cloud::Tasks::V2beta3::AppEngineHttpRequest#relative_uri relative_uri}
         #
+        # Tasks can be dispatched to secure app handlers, unsecure app handlers, and
+        # URIs restricted with
+        # [`login: admin`](https://cloud.google.com/appengine/docs/standard/python/config/appref).
+        # Because tasks are not run as any user, they cannot be dispatched to URIs
+        # restricted with
+        # [`login: required`](https://cloud.google.com/appengine/docs/standard/python/config/appref)
+        # Task dispatches also do not follow redirects.
+        #
         # The task attempt has succeeded if the app's request handler returns
         # an HTTP response code in the range [`200` - `299`]. `503` is
         # considered an App Engine system error instead of an application
         # error. Requests returning error `503` will be retried regardless of
         # retry configuration and not counted against retry counts.
@@ -161,18 +174,12 @@
         #     an error to set a body on a task with an incompatible {Google::Cloud::Tasks::V2beta3::HttpMethod HttpMethod}.
         class AppEngineHttpRequest; end
 
         # App Engine Routing.
         #
-        # Specifies the target URI. Since this target type dispatches tasks to secure
-        # app handlers, unsecure app handlers, and URIs restricted with
-        # [`login: admin`](https://cloud.google.com/appengine/docs/standard/python/config/appref)
-        # the protocol (for example, HTTP or HTTPS) cannot be explictly specified.
-        # Task dispatches do not follow redirects and cannot target URI paths
-        # restricted with
-        # [`login: required`](https://cloud.google.com/appengine/docs/standard/python/config/appref)
-        # because tasks are not run as any user.
+        # Defines routing characteristics specific to App Engine - service, version,
+        # and instance.
         #
         # For more information about services, versions, and instances see
         # [An Overview of App Engine](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine),
         # [Microservices Architecture on Google App Engine](https://cloud.google.com/appengine/docs/python/microservices-on-app-engine),
         # [App Engine Standard request routing](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed),
@@ -256,9 +263,15 @@
           # HTTP PUT
           PUT = 4
 
           # HTTP DELETE
           DELETE = 5
+
+          # HTTP PATCH
+          PATCH = 6
+
+          # HTTP OPTIONS
+          OPTIONS = 7
         end
       end
     end
   end
 end
\ No newline at end of file