any.rb in google-cloud-video_intelligence-1.1.1

- old
+ new

@@ -10,10 +10,11 @@
 # 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.
 
+
 module Google
   module Protobuf
     # +Any+ contains an arbitrary serialized protocol buffer message along with a
     # URL that describes the type of the serialized message.
     #
@@ -93,27 +94,32 @@
     #       "@type": "type.googleapis.com/google.protobuf.Duration",
     #       "value": "1.212s"
     #     }
     # @!attribute [rw] type_url
     #   @return [String]
-    #     A URL/resource name whose content describes the type of the
-    #     serialized protocol buffer message.
+    #     A URL/resource name that uniquely identifies the type of the serialized
+    #     protocol buffer message. The last segment of the URL's path must represent
+    #     the fully qualified name of the type (as in
+    #     +path/google.protobuf.Duration+). The name should be in a canonical form
+    #     (e.g., leading "." is not accepted).
     #
-    #     For URLs which use the scheme +http+, +https+, or no scheme, the
-    #     following restrictions and interpretations apply:
+    #     In practice, teams usually precompile into the binary all types that they
+    #     expect it to use in the context of Any. However, for URLs which use the
+    #     scheme +http+, +https+, or no scheme, one can optionally set up a type
+    #     server that maps type URLs to message definitions as follows:
     #
     #     * If no scheme is provided, +https+ is assumed.
-    #     * The last segment of the URL's path must represent the fully
-    #       qualified name of the type (as in +path/google.protobuf.Duration+).
-    #       The name should be in a canonical form (e.g., leading "." is
-    #       not accepted).
     #     * An HTTP GET on the URL must yield a {Google::Protobuf::Type}
     #       value in binary format, or produce an error.
     #     * Applications are allowed to cache lookup results based on the
     #       URL, or have them precompiled into a binary to avoid any
     #       lookup. Therefore, binary compatibility needs to be preserved
     #       on changes to types. (Use versioned type names to manage
     #       breaking changes.)
+    #
+    #     Note: this functionality is not currently available in the official
+    #     protobuf release, and it is not used for type URLs beginning with
+    #     type.googleapis.com.
     #
     #     Schemes other than +http+, +https+ (or the empty scheme) might be
     #     used with implementation specific semantics.
     # @!attribute [rw] value
     #   @return [String]
\ No newline at end of file