Merge "Upgrade rust/crates/protobuf to 2.22.0"

1 files changed, 132 insertions, 126 deletions

diff --git a/src/well_known_types/field_mask.rs b/src/well_known_types/field_mask.rs
index c9db6c0..dc0ed10 100644
--- a/src/well_known_types/field_mask.rs
+++ b/src/well_known_types/field_mask.rs
@@ -1,4 +1,4 @@
-// This file is generated by rust-protobuf 2.19.0-pre. Do not edit
+// This file is generated by rust-protobuf 2.22.0-pre. Do not edit
 // @generated
 
 // https://github.com/rust-lang/rust-clippy/issues/702
@@ -20,7 +20,7 @@
 //! Generated file from `google/protobuf/field_mask.proto`
 
 #[derive(PartialEq,Clone,Default)]
-#[cfg_attr(feature = "with-serde", derive(Serialize, Deserialize))]
+#[cfg_attr(feature = "with-serde", derive(::serde::Serialize, ::serde::Deserialize))]
 pub struct FieldMask {
     // message fields
     pub paths: crate::RepeatedField<::std::string::String>,
@@ -182,9 +182,10 @@ impl crate::reflect::ProtobufValue for FieldMask {
 
 static file_descriptor_proto_data: &'static [u8] = b"\
     \n\x20google/protobuf/field_mask.proto\x12\x0fgoogle.protobuf\"!\n\tFiel\
-    dMask\x12\x14\n\x05paths\x18\x01\x20\x03(\tR\x05pathsBN\n\x13com.google.\
-    protobufB\x0eFieldMaskProtoP\x01\xa2\x02\x03GPB\xaa\x02\x1eGoogle.Protob\
-    uf.WellKnownTypesJ\x929\n\x07\x12\x05\x1e\0\xf4\x01\x01\n\xcc\x0c\n\x01\
+    dMask\x12\x14\n\x05paths\x18\x01\x20\x03(\tR\x05pathsB\x85\x01\n\x13com.\
+    google.protobufB\x0eFieldMaskProtoP\x01Z2google.golang.org/protobuf/type\
+    s/known/fieldmaskpb\xf8\x01\x01\xa2\x02\x03GPB\xaa\x02\x1eGoogle.Protobu\
+    f.WellKnownTypesJ\xa1;\n\x07\x12\x05\x1e\0\xf4\x01\x01\n\xcc\x0c\n\x01\
     \x0c\x12\x03\x1e\0\x122\xc1\x0c\x20Protocol\x20Buffers\x20-\x20Google's\
     \x20data\x20interchange\x20format\n\x20Copyright\x202008\x20Google\x20In\
     c.\x20\x20All\x20rights\x20reserved.\n\x20https://developers.google.com/\
@@ -223,124 +224,124 @@ static file_descriptor_proto_data: &'static [u8] = b"\
     \x08\n\x01\x08\x12\x03#\0,\n\t\n\x02\x08\x01\x12\x03#\0,\n\x08\n\x01\x08\
     \x12\x03$\0/\n\t\n\x02\x08\x08\x12\x03$\0/\n\x08\n\x01\x08\x12\x03%\0\"\
     \n\t\n\x02\x08\n\x12\x03%\0\"\n\x08\n\x01\x08\x12\x03&\0!\n\t\n\x02\x08$\
-    \x12\x03&\0!\n\xcd*\n\x02\x04\0\x12\x06\xf1\x01\0\xf4\x01\x01\x1a\xbe*\
-    \x20`FieldMask`\x20represents\x20a\x20set\x20of\x20symbolic\x20field\x20\
-    paths,\x20for\x20example:\n\n\x20\x20\x20\x20\x20paths:\x20\"f.a\"\n\x20\
-    \x20\x20\x20\x20paths:\x20\"f.b.d\"\n\n\x20Here\x20`f`\x20represents\x20\
-    a\x20field\x20in\x20some\x20root\x20message,\x20`a`\x20and\x20`b`\n\x20f\
-    ields\x20in\x20the\x20message\x20found\x20in\x20`f`,\x20and\x20`d`\x20a\
-    \x20field\x20found\x20in\x20the\n\x20message\x20in\x20`f.b`.\n\n\x20Fiel\
-    d\x20masks\x20are\x20used\x20to\x20specify\x20a\x20subset\x20of\x20field\
-    s\x20that\x20should\x20be\n\x20returned\x20by\x20a\x20get\x20operation\
-    \x20or\x20modified\x20by\x20an\x20update\x20operation.\n\x20Field\x20mas\
-    ks\x20also\x20have\x20a\x20custom\x20JSON\x20encoding\x20(see\x20below).\
-    \n\n\x20#\x20Field\x20Masks\x20in\x20Projections\n\n\x20When\x20used\x20\
-    in\x20the\x20context\x20of\x20a\x20projection,\x20a\x20response\x20messa\
-    ge\x20or\n\x20sub-message\x20is\x20filtered\x20by\x20the\x20API\x20to\
-    \x20only\x20contain\x20those\x20fields\x20as\n\x20specified\x20in\x20the\
-    \x20mask.\x20For\x20example,\x20if\x20the\x20mask\x20in\x20the\x20previo\
-    us\n\x20example\x20is\x20applied\x20to\x20a\x20response\x20message\x20as\
-    \x20follows:\n\n\x20\x20\x20\x20\x20f\x20{\n\x20\x20\x20\x20\x20\x20\x20\
-    a\x20:\x2022\n\x20\x20\x20\x20\x20\x20\x20b\x20{\n\x20\x20\x20\x20\x20\
-    \x20\x20\x20\x20d\x20:\x201\n\x20\x20\x20\x20\x20\x20\x20\x20\x20x\x20:\
-    \x202\n\x20\x20\x20\x20\x20\x20\x20}\n\x20\x20\x20\x20\x20\x20\x20y\x20:\
-    \x2013\n\x20\x20\x20\x20\x20}\n\x20\x20\x20\x20\x20z:\x208\n\n\x20The\
-    \x20result\x20will\x20not\x20contain\x20specific\x20values\x20for\x20fie\
-    lds\x20x,y\x20and\x20z\n\x20(their\x20value\x20will\x20be\x20set\x20to\
-    \x20the\x20default,\x20and\x20omitted\x20in\x20proto\x20text\n\x20output\
-    ):\n\n\n\x20\x20\x20\x20\x20f\x20{\n\x20\x20\x20\x20\x20\x20\x20a\x20:\
-    \x2022\n\x20\x20\x20\x20\x20\x20\x20b\x20{\n\x20\x20\x20\x20\x20\x20\x20\
-    \x20\x20d\x20:\x201\n\x20\x20\x20\x20\x20\x20\x20}\n\x20\x20\x20\x20\x20\
-    }\n\n\x20A\x20repeated\x20field\x20is\x20not\x20allowed\x20except\x20at\
-    \x20the\x20last\x20position\x20of\x20a\n\x20paths\x20string.\n\n\x20If\
-    \x20a\x20FieldMask\x20object\x20is\x20not\x20present\x20in\x20a\x20get\
-    \x20operation,\x20the\n\x20operation\x20applies\x20to\x20all\x20fields\
-    \x20(as\x20if\x20a\x20FieldMask\x20of\x20all\x20fields\n\x20had\x20been\
-    \x20specified).\n\n\x20Note\x20that\x20a\x20field\x20mask\x20does\x20not\
-    \x20necessarily\x20apply\x20to\x20the\n\x20top-level\x20response\x20mess\
-    age.\x20In\x20case\x20of\x20a\x20REST\x20get\x20operation,\x20the\n\x20f\
-    ield\x20mask\x20applies\x20directly\x20to\x20the\x20response,\x20but\x20\
-    in\x20case\x20of\x20a\x20REST\n\x20list\x20operation,\x20the\x20mask\x20\
-    instead\x20applies\x20to\x20each\x20individual\x20message\n\x20in\x20the\
-    \x20returned\x20resource\x20list.\x20In\x20case\x20of\x20a\x20REST\x20cu\
-    stom\x20method,\n\x20other\x20definitions\x20may\x20be\x20used.\x20Where\
-    \x20the\x20mask\x20applies\x20will\x20be\n\x20clearly\x20documented\x20t\
-    ogether\x20with\x20its\x20declaration\x20in\x20the\x20API.\x20\x20In\n\
-    \x20any\x20case,\x20the\x20effect\x20on\x20the\x20returned\x20resource/r\
-    esources\x20is\x20required\n\x20behavior\x20for\x20APIs.\n\n\x20#\x20Fie\
-    ld\x20Masks\x20in\x20Update\x20Operations\n\n\x20A\x20field\x20mask\x20i\
-    n\x20update\x20operations\x20specifies\x20which\x20fields\x20of\x20the\n\
-    \x20targeted\x20resource\x20are\x20going\x20to\x20be\x20updated.\x20The\
-    \x20API\x20is\x20required\n\x20to\x20only\x20change\x20the\x20values\x20\
-    of\x20the\x20fields\x20as\x20specified\x20in\x20the\x20mask\n\x20and\x20\
-    leave\x20the\x20others\x20untouched.\x20If\x20a\x20resource\x20is\x20pas\
-    sed\x20in\x20to\n\x20describe\x20the\x20updated\x20values,\x20the\x20API\
-    \x20ignores\x20the\x20values\x20of\x20all\n\x20fields\x20not\x20covered\
-    \x20by\x20the\x20mask.\n\n\x20If\x20a\x20repeated\x20field\x20is\x20spec\
-    ified\x20for\x20an\x20update\x20operation,\x20the\x20existing\n\x20repea\
-    ted\x20values\x20in\x20the\x20target\x20resource\x20will\x20be\x20overwr\
-    itten\x20by\x20the\x20new\x20values.\n\x20Note\x20that\x20a\x20repeated\
-    \x20field\x20is\x20only\x20allowed\x20in\x20the\x20last\x20position\x20o\
-    f\x20a\x20`paths`\n\x20string.\n\n\x20If\x20a\x20sub-message\x20is\x20sp\
-    ecified\x20in\x20the\x20last\x20position\x20of\x20the\x20field\x20mask\
-    \x20for\x20an\n\x20update\x20operation,\x20then\x20the\x20existing\x20su\
-    b-message\x20in\x20the\x20target\x20resource\x20is\n\x20overwritten.\x20\
-    Given\x20the\x20target\x20message:\n\n\x20\x20\x20\x20\x20f\x20{\n\x20\
+    \x12\x03&\0!\n\x08\n\x01\x08\x12\x03'\0I\n\t\n\x02\x08\x0b\x12\x03'\0I\n\
+    \x08\n\x01\x08\x12\x03(\0\x1f\n\t\n\x02\x08\x1f\x12\x03(\0\x1f\n\xb2,\n\
+    \x02\x04\0\x12\x06\xf1\x01\0\xf4\x01\x01\x1a\xa3,\x20`FieldMask`\x20repr\
+    esents\x20a\x20set\x20of\x20symbolic\x20field\x20paths,\x20for\x20exampl\
+    e:\n\n\x20\x20\x20\x20\x20paths:\x20\"f.a\"\n\x20\x20\x20\x20\x20paths:\
+    \x20\"f.b.d\"\n\n\x20Here\x20`f`\x20represents\x20a\x20field\x20in\x20so\
+    me\x20root\x20message,\x20`a`\x20and\x20`b`\n\x20fields\x20in\x20the\x20\
+    message\x20found\x20in\x20`f`,\x20and\x20`d`\x20a\x20field\x20found\x20i\
+    n\x20the\n\x20message\x20in\x20`f.b`.\n\n\x20Field\x20masks\x20are\x20us\
+    ed\x20to\x20specify\x20a\x20subset\x20of\x20fields\x20that\x20should\x20\
+    be\n\x20returned\x20by\x20a\x20get\x20operation\x20or\x20modified\x20by\
+    \x20an\x20update\x20operation.\n\x20Field\x20masks\x20also\x20have\x20a\
+    \x20custom\x20JSON\x20encoding\x20(see\x20below).\n\n\x20#\x20Field\x20M\
+    asks\x20in\x20Projections\n\n\x20When\x20used\x20in\x20the\x20context\
+    \x20of\x20a\x20projection,\x20a\x20response\x20message\x20or\n\x20sub-me\
+    ssage\x20is\x20filtered\x20by\x20the\x20API\x20to\x20only\x20contain\x20\
+    those\x20fields\x20as\n\x20specified\x20in\x20the\x20mask.\x20For\x20exa\
+    mple,\x20if\x20the\x20mask\x20in\x20the\x20previous\n\x20example\x20is\
+    \x20applied\x20to\x20a\x20response\x20message\x20as\x20follows:\n\n\x20\
+    \x20\x20\x20\x20f\x20{\n\x20\x20\x20\x20\x20\x20\x20a\x20:\x2022\n\x20\
     \x20\x20\x20\x20\x20\x20b\x20{\n\x20\x20\x20\x20\x20\x20\x20\x20\x20d\
     \x20:\x201\n\x20\x20\x20\x20\x20\x20\x20\x20\x20x\x20:\x202\n\x20\x20\
-    \x20\x20\x20\x20\x20}\n\x20\x20\x20\x20\x20\x20\x20c\x20:\x201\n\x20\x20\
-    \x20\x20\x20}\n\n\x20And\x20an\x20update\x20message:\n\n\x20\x20\x20\x20\
+    \x20\x20\x20\x20\x20}\n\x20\x20\x20\x20\x20\x20\x20y\x20:\x2013\n\x20\
+    \x20\x20\x20\x20}\n\x20\x20\x20\x20\x20z:\x208\n\n\x20The\x20result\x20w\
+    ill\x20not\x20contain\x20specific\x20values\x20for\x20fields\x20x,y\x20a\
+    nd\x20z\n\x20(their\x20value\x20will\x20be\x20set\x20to\x20the\x20defaul\
+    t,\x20and\x20omitted\x20in\x20proto\x20text\n\x20output):\n\n\n\x20\x20\
+    \x20\x20\x20f\x20{\n\x20\x20\x20\x20\x20\x20\x20a\x20:\x2022\n\x20\x20\
+    \x20\x20\x20\x20\x20b\x20{\n\x20\x20\x20\x20\x20\x20\x20\x20\x20d\x20:\
+    \x201\n\x20\x20\x20\x20\x20\x20\x20}\n\x20\x20\x20\x20\x20}\n\n\x20A\x20\
+    repeated\x20field\x20is\x20not\x20allowed\x20except\x20at\x20the\x20last\
+    \x20position\x20of\x20a\n\x20paths\x20string.\n\n\x20If\x20a\x20FieldMas\
+    k\x20object\x20is\x20not\x20present\x20in\x20a\x20get\x20operation,\x20t\
+    he\n\x20operation\x20applies\x20to\x20all\x20fields\x20(as\x20if\x20a\
+    \x20FieldMask\x20of\x20all\x20fields\n\x20had\x20been\x20specified).\n\n\
+    \x20Note\x20that\x20a\x20field\x20mask\x20does\x20not\x20necessarily\x20\
+    apply\x20to\x20the\n\x20top-level\x20response\x20message.\x20In\x20case\
+    \x20of\x20a\x20REST\x20get\x20operation,\x20the\n\x20field\x20mask\x20ap\
+    plies\x20directly\x20to\x20the\x20response,\x20but\x20in\x20case\x20of\
+    \x20a\x20REST\n\x20list\x20operation,\x20the\x20mask\x20instead\x20appli\
+    es\x20to\x20each\x20individual\x20message\n\x20in\x20the\x20returned\x20\
+    resource\x20list.\x20In\x20case\x20of\x20a\x20REST\x20custom\x20method,\
+    \n\x20other\x20definitions\x20may\x20be\x20used.\x20Where\x20the\x20mask\
+    \x20applies\x20will\x20be\n\x20clearly\x20documented\x20together\x20with\
+    \x20its\x20declaration\x20in\x20the\x20API.\x20\x20In\n\x20any\x20case,\
+    \x20the\x20effect\x20on\x20the\x20returned\x20resource/resources\x20is\
+    \x20required\n\x20behavior\x20for\x20APIs.\n\n\x20#\x20Field\x20Masks\
+    \x20in\x20Update\x20Operations\n\n\x20A\x20field\x20mask\x20in\x20update\
+    \x20operations\x20specifies\x20which\x20fields\x20of\x20the\n\x20targete\
+    d\x20resource\x20are\x20going\x20to\x20be\x20updated.\x20The\x20API\x20i\
+    s\x20required\n\x20to\x20only\x20change\x20the\x20values\x20of\x20the\
+    \x20fields\x20as\x20specified\x20in\x20the\x20mask\n\x20and\x20leave\x20\
+    the\x20others\x20untouched.\x20If\x20a\x20resource\x20is\x20passed\x20in\
+    \x20to\n\x20describe\x20the\x20updated\x20values,\x20the\x20API\x20ignor\
+    es\x20the\x20values\x20of\x20all\n\x20fields\x20not\x20covered\x20by\x20\
+    the\x20mask.\n\n\x20If\x20a\x20repeated\x20field\x20is\x20specified\x20f\
+    or\x20an\x20update\x20operation,\x20new\x20values\x20will\n\x20be\x20app\
+    ended\x20to\x20the\x20existing\x20repeated\x20field\x20in\x20the\x20targ\
+    et\x20resource.\x20Note\x20that\n\x20a\x20repeated\x20field\x20is\x20onl\
+    y\x20allowed\x20in\x20the\x20last\x20position\x20of\x20a\x20`paths`\x20s\
+    tring.\n\n\x20If\x20a\x20sub-message\x20is\x20specified\x20in\x20the\x20\
+    last\x20position\x20of\x20the\x20field\x20mask\x20for\x20an\n\x20update\
+    \x20operation,\x20then\x20new\x20value\x20will\x20be\x20merged\x20into\
+    \x20the\x20existing\x20sub-message\n\x20in\x20the\x20target\x20resource.\
+    \n\n\x20For\x20example,\x20given\x20the\x20target\x20message:\n\n\x20\
+    \x20\x20\x20\x20f\x20{\n\x20\x20\x20\x20\x20\x20\x20b\x20{\n\x20\x20\x20\
+    \x20\x20\x20\x20\x20\x20d:\x201\n\x20\x20\x20\x20\x20\x20\x20\x20\x20x:\
+    \x202\n\x20\x20\x20\x20\x20\x20\x20}\n\x20\x20\x20\x20\x20\x20\x20c:\x20\
+    [1]\n\x20\x20\x20\x20\x20}\n\n\x20And\x20an\x20update\x20message:\n\n\
+    \x20\x20\x20\x20\x20f\x20{\n\x20\x20\x20\x20\x20\x20\x20b\x20{\n\x20\x20\
+    \x20\x20\x20\x20\x20\x20\x20d:\x2010\n\x20\x20\x20\x20\x20\x20\x20}\n\
+    \x20\x20\x20\x20\x20\x20\x20c:\x20[2]\n\x20\x20\x20\x20\x20}\n\n\x20then\
+    \x20if\x20the\x20field\x20mask\x20is:\n\n\x20\x20paths:\x20[\"f.b\",\x20\
+    \"f.c\"]\n\n\x20then\x20the\x20result\x20will\x20be:\n\n\x20\x20\x20\x20\
     \x20f\x20{\n\x20\x20\x20\x20\x20\x20\x20b\x20{\n\x20\x20\x20\x20\x20\x20\
-    \x20\x20\x20d\x20:\x2010\n\x20\x20\x20\x20\x20\x20\x20}\n\x20\x20\x20\
-    \x20\x20}\n\n\x20then\x20if\x20the\x20field\x20mask\x20is:\n\n\x20\x20pa\
-    ths:\x20\"f.b\"\n\n\x20then\x20the\x20result\x20will\x20be:\n\n\x20\x20\
-    \x20\x20\x20f\x20{\n\x20\x20\x20\x20\x20\x20\x20b\x20{\n\x20\x20\x20\x20\
-    \x20\x20\x20\x20\x20d\x20:\x2010\n\x20\x20\x20\x20\x20\x20\x20}\n\x20\
-    \x20\x20\x20\x20\x20\x20c\x20:\x201\n\x20\x20\x20\x20\x20}\n\n\x20Howeve\
-    r,\x20if\x20the\x20update\x20mask\x20was:\n\n\x20\x20paths:\x20\"f.b.d\"\
-    \n\n\x20then\x20the\x20result\x20would\x20be:\n\n\x20\x20\x20\x20\x20f\
-    \x20{\n\x20\x20\x20\x20\x20\x20\x20b\x20{\n\x20\x20\x20\x20\x20\x20\x20\
-    \x20\x20d\x20:\x2010\n\x20\x20\x20\x20\x20\x20\x20\x20\x20x\x20:\x202\n\
-    \x20\x20\x20\x20\x20\x20\x20}\n\x20\x20\x20\x20\x20\x20\x20c\x20:\x201\n\
-    \x20\x20\x20\x20\x20}\n\n\x20In\x20order\x20to\x20reset\x20a\x20field's\
-    \x20value\x20to\x20the\x20default,\x20the\x20field\x20must\n\x20be\x20in\
-    \x20the\x20mask\x20and\x20set\x20to\x20the\x20default\x20value\x20in\x20\
-    the\x20provided\x20resource.\n\x20Hence,\x20in\x20order\x20to\x20reset\
-    \x20all\x20fields\x20of\x20a\x20resource,\x20provide\x20a\x20default\n\
-    \x20instance\x20of\x20the\x20resource\x20and\x20set\x20all\x20fields\x20\
-    in\x20the\x20mask,\x20or\x20do\n\x20not\x20provide\x20a\x20mask\x20as\
-    \x20described\x20below.\n\n\x20If\x20a\x20field\x20mask\x20is\x20not\x20\
-    present\x20on\x20update,\x20the\x20operation\x20applies\x20to\n\x20all\
-    \x20fields\x20(as\x20if\x20a\x20field\x20mask\x20of\x20all\x20fields\x20\
-    has\x20been\x20specified).\n\x20Note\x20that\x20in\x20the\x20presence\
-    \x20of\x20schema\x20evolution,\x20this\x20may\x20mean\x20that\n\x20field\
-    s\x20the\x20client\x20does\x20not\x20know\x20and\x20has\x20therefore\x20\
-    not\x20filled\x20into\n\x20the\x20request\x20will\x20be\x20reset\x20to\
-    \x20their\x20default.\x20If\x20this\x20is\x20unwanted\n\x20behavior,\x20\
-    a\x20specific\x20service\x20may\x20require\x20a\x20client\x20to\x20alway\
-    s\x20specify\n\x20a\x20field\x20mask,\x20producing\x20an\x20error\x20if\
-    \x20not.\n\n\x20As\x20with\x20get\x20operations,\x20the\x20location\x20o\
-    f\x20the\x20resource\x20which\n\x20describes\x20the\x20updated\x20values\
-    \x20in\x20the\x20request\x20message\x20depends\x20on\x20the\n\x20operati\
-    on\x20kind.\x20In\x20any\x20case,\x20the\x20effect\x20of\x20the\x20field\
-    \x20mask\x20is\n\x20required\x20to\x20be\x20honored\x20by\x20the\x20API.\
-    \n\n\x20##\x20Considerations\x20for\x20HTTP\x20REST\n\n\x20The\x20HTTP\
-    \x20kind\x20of\x20an\x20update\x20operation\x20which\x20uses\x20a\x20fie\
-    ld\x20mask\x20must\n\x20be\x20set\x20to\x20PATCH\x20instead\x20of\x20PUT\
-    \x20in\x20order\x20to\x20satisfy\x20HTTP\x20semantics\n\x20(PUT\x20must\
-    \x20only\x20be\x20used\x20for\x20full\x20updates).\n\n\x20#\x20JSON\x20E\
-    ncoding\x20of\x20Field\x20Masks\n\n\x20In\x20JSON,\x20a\x20field\x20mask\
-    \x20is\x20encoded\x20as\x20a\x20single\x20string\x20where\x20paths\x20ar\
-    e\n\x20separated\x20by\x20a\x20comma.\x20Fields\x20name\x20in\x20each\
-    \x20path\x20are\x20converted\n\x20to/from\x20lower-camel\x20naming\x20co\
-    nventions.\n\n\x20As\x20an\x20example,\x20consider\x20the\x20following\
-    \x20message\x20declarations:\n\n\x20\x20\x20\x20\x20message\x20Profile\
-    \x20{\n\x20\x20\x20\x20\x20\x20\x20User\x20user\x20=\x201;\n\x20\x20\x20\
-    \x20\x20\x20\x20Photo\x20photo\x20=\x202;\n\x20\x20\x20\x20\x20}\n\x20\
-    \x20\x20\x20\x20message\x20User\x20{\n\x20\x20\x20\x20\x20\x20\x20string\
-    \x20display_name\x20=\x201;\n\x20\x20\x20\x20\x20\x20\x20string\x20addre\
-    ss\x20=\x202;\n\x20\x20\x20\x20\x20}\n\n\x20In\x20proto\x20a\x20field\
-    \x20mask\x20for\x20`Profile`\x20may\x20look\x20as\x20such:\n\n\x20\x20\
+    \x20\x20\x20d:\x2010\n\x20\x20\x20\x20\x20\x20\x20\x20\x20x:\x202\n\x20\
+    \x20\x20\x20\x20\x20\x20}\n\x20\x20\x20\x20\x20\x20\x20c:\x20[1,\x202]\n\
+    \x20\x20\x20\x20\x20}\n\n\x20An\x20implementation\x20may\x20provide\x20o\
+    ptions\x20to\x20override\x20this\x20default\x20behavior\x20for\n\x20repe\
+    ated\x20and\x20message\x20fields.\n\n\x20In\x20order\x20to\x20reset\x20a\
+    \x20field's\x20value\x20to\x20the\x20default,\x20the\x20field\x20must\n\
+    \x20be\x20in\x20the\x20mask\x20and\x20set\x20to\x20the\x20default\x20val\
+    ue\x20in\x20the\x20provided\x20resource.\n\x20Hence,\x20in\x20order\x20t\
+    o\x20reset\x20all\x20fields\x20of\x20a\x20resource,\x20provide\x20a\x20d\
+    efault\n\x20instance\x20of\x20the\x20resource\x20and\x20set\x20all\x20fi\
+    elds\x20in\x20the\x20mask,\x20or\x20do\n\x20not\x20provide\x20a\x20mask\
+    \x20as\x20described\x20below.\n\n\x20If\x20a\x20field\x20mask\x20is\x20n\
+    ot\x20present\x20on\x20update,\x20the\x20operation\x20applies\x20to\n\
+    \x20all\x20fields\x20(as\x20if\x20a\x20field\x20mask\x20of\x20all\x20fie\
+    lds\x20has\x20been\x20specified).\n\x20Note\x20that\x20in\x20the\x20pres\
+    ence\x20of\x20schema\x20evolution,\x20this\x20may\x20mean\x20that\n\x20f\
+    ields\x20the\x20client\x20does\x20not\x20know\x20and\x20has\x20therefore\
+    \x20not\x20filled\x20into\n\x20the\x20request\x20will\x20be\x20reset\x20\
+    to\x20their\x20default.\x20If\x20this\x20is\x20unwanted\n\x20behavior,\
+    \x20a\x20specific\x20service\x20may\x20require\x20a\x20client\x20to\x20a\
+    lways\x20specify\n\x20a\x20field\x20mask,\x20producing\x20an\x20error\
+    \x20if\x20not.\n\n\x20As\x20with\x20get\x20operations,\x20the\x20locatio\
+    n\x20of\x20the\x20resource\x20which\n\x20describes\x20the\x20updated\x20\
+    values\x20in\x20the\x20request\x20message\x20depends\x20on\x20the\n\x20o\
+    peration\x20kind.\x20In\x20any\x20case,\x20the\x20effect\x20of\x20the\
+    \x20field\x20mask\x20is\n\x20required\x20to\x20be\x20honored\x20by\x20th\
+    e\x20API.\n\n\x20##\x20Considerations\x20for\x20HTTP\x20REST\n\n\x20The\
+    \x20HTTP\x20kind\x20of\x20an\x20update\x20operation\x20which\x20uses\x20\
+    a\x20field\x20mask\x20must\n\x20be\x20set\x20to\x20PATCH\x20instead\x20o\
+    f\x20PUT\x20in\x20order\x20to\x20satisfy\x20HTTP\x20semantics\n\x20(PUT\
+    \x20must\x20only\x20be\x20used\x20for\x20full\x20updates).\n\n\x20#\x20J\
+    SON\x20Encoding\x20of\x20Field\x20Masks\n\n\x20In\x20JSON,\x20a\x20field\
+    \x20mask\x20is\x20encoded\x20as\x20a\x20single\x20string\x20where\x20pat\
+    hs\x20are\n\x20separated\x20by\x20a\x20comma.\x20Fields\x20name\x20in\
+    \x20each\x20path\x20are\x20converted\n\x20to/from\x20lower-camel\x20nami\
+    ng\x20conventions.\n\n\x20As\x20an\x20example,\x20consider\x20the\x20fol\
+    lowing\x20message\x20declarations:\n\n\x20\x20\x20\x20\x20message\x20Pro\
+    file\x20{\n\x20\x20\x20\x20\x20\x20\x20User\x20user\x20=\x201;\n\x20\x20\
+    \x20\x20\x20\x20\x20Photo\x20photo\x20=\x202;\n\x20\x20\x20\x20\x20}\n\
+    \x20\x20\x20\x20\x20message\x20User\x20{\n\x20\x20\x20\x20\x20\x20\x20st\
+    ring\x20display_name\x20=\x201;\n\x20\x20\x20\x20\x20\x20\x20string\x20a\
+    ddress\x20=\x202;\n\x20\x20\x20\x20\x20}\n\n\x20In\x20proto\x20a\x20fiel\
+    d\x20mask\x20for\x20`Profile`\x20may\x20look\x20as\x20such:\n\n\x20\x20\
     \x20\x20\x20mask\x20{\n\x20\x20\x20\x20\x20\x20\x20paths:\x20\"user.disp\
     lay_name\"\n\x20\x20\x20\x20\x20\x20\x20paths:\x20\"photo\"\n\x20\x20\
     \x20\x20\x20}\n\n\x20In\x20JSON,\x20the\x20same\x20mask\x20is\x20represe\
@@ -358,12 +359,17 @@ static file_descriptor_proto_data: &'static [u8] = b"\
     \x20\x20\x20\x20\x20mask\x20{\n\x20\x20\x20\x20\x20\x20\x20paths:\x20\"s\
     ub_message\"\n\x20\x20\x20\x20\x20}\n\n\x20Note\x20that\x20oneof\x20type\
     \x20names\x20(\"test_oneof\"\x20in\x20this\x20case)\x20cannot\x20be\x20u\
-    sed\x20in\n\x20paths.\n\n\x0b\n\x03\x04\0\x01\x12\x04\xf1\x01\x08\x11\n,\
-    \n\x04\x04\0\x02\0\x12\x04\xf3\x01\x02\x1c\x1a\x1e\x20The\x20set\x20of\
-    \x20field\x20mask\x20paths.\n\n\r\n\x05\x04\0\x02\0\x04\x12\x04\xf3\x01\
-    \x02\n\n\r\n\x05\x04\0\x02\0\x05\x12\x04\xf3\x01\x0b\x11\n\r\n\x05\x04\0\
-    \x02\0\x01\x12\x04\xf3\x01\x12\x17\n\r\n\x05\x04\0\x02\0\x03\x12\x04\xf3\
-    \x01\x1a\x1bb\x06proto3\
+    sed\x20in\n\x20paths.\n\n\x20##\x20Field\x20Mask\x20Verification\n\n\x20\
+    The\x20implementation\x20of\x20any\x20API\x20method\x20which\x20has\x20a\
+    \x20FieldMask\x20type\x20field\x20in\x20the\n\x20request\x20should\x20ve\
+    rify\x20the\x20included\x20field\x20paths,\x20and\x20return\x20an\n\x20`\
+    INVALID_ARGUMENT`\x20error\x20if\x20any\x20path\x20is\x20unmappable.\n\n\
+    \x0b\n\x03\x04\0\x01\x12\x04\xf1\x01\x08\x11\n,\n\x04\x04\0\x02\0\x12\
+    \x04\xf3\x01\x02\x1c\x1a\x1e\x20The\x20set\x20of\x20field\x20mask\x20pat\
+    hs.\n\n\r\n\x05\x04\0\x02\0\x04\x12\x04\xf3\x01\x02\n\n\r\n\x05\x04\0\
+    \x02\0\x05\x12\x04\xf3\x01\x0b\x11\n\r\n\x05\x04\0\x02\0\x01\x12\x04\xf3\
+    \x01\x12\x17\n\r\n\x05\x04\0\x02\0\x03\x12\x04\xf3\x01\x1a\x1bb\x06proto\
+    3\
 ";
 
 static file_descriptor_proto_lazy: crate::rt::LazyV2<crate::descriptor::FileDescriptorProto> = crate::rt::LazyV2::INIT;