field_mask.rb in google-cloud-pubsub-0.32.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
     # +FieldMask+ represents a set of symbolic field paths, for example:
     #
     #     paths: "f.a"
@@ -213,9 +214,15 @@
     #       paths: "sub_message"
     #     }
     #
     # Note that oneof type names ("test_oneof" in this case) cannot be used in
     # paths.
+    #
+    # == Field Mask Verification
+    #
+    # The implementation of any API method which has a FieldMask type field in the
+    # request should verify the included field paths, and return an
+    # +INVALID_ARGUMENT+ error if any path is duplicated or unmappable.
     # @!attribute [rw] paths
     #   @return [Array<String>]
     #     The set of field mask paths.
     class FieldMask; end
   end
\ No newline at end of file