RubyGems - google-api-client - Versions diffs - 0.51.0 → 0.52.0 - Mend

google-api-client 0.51.0 → 0.52.0

Files changed (218) hide show

checksums.yaml CHANGED

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 35b36db88b63fe789942310e6cb8a676c2b39ab78bdc4aeb0d96d1a0f08ed411
-  data.tar.gz: 9f19ddb45f11c8cd524e5144181d11da350598ee6fb8d39e20f7deb3d907c450
+  metadata.gz: 4cf9aed2e7ad1e0d517672ac8c80aef43afca0178bdb548f01f4ccf6dc438700
+  data.tar.gz: c884e7459a1fe60d844ce835c5996c0f630eb72bee4eb7090202535d255d16cf
 SHA512:
-  metadata.gz: 1211de15bca252d3dd6208f3346b41f32c570e74dcf647c751c0a30019596f543a300c4ff7a18afabfa2b5da577a53068055e10024cc6ebef54c8315e87dd8b2
-  data.tar.gz: 6be133c67114ce71f6db8a084888acc14687309412e90f29b64271e9e31118f0a9e0991e31475d28a9702c2f1a49abe384cfff0948f636e38090934723ca7a6b
+  metadata.gz: 689d97934acb44994f2ec76b69e6b5d8ac139fbeba821a62ad3c13474686f08799bdf4d86872efbf989e054ad997f34d512716c3de2e54351f8fb145035eb884
+  data.tar.gz: ade510d661a01da090c2e0c8a703bbbcbb3caaf0af94642199c95c1b79443566eba40e7ce6d0146c19d5766471b42c1a1221217ddca076b5b8f297a865e0f528

data/.github/workflows/release-please.yml CHANGED

@@ -12,8 +12,9 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: ReleasePlease
+        id: release-please
         if: ${{ env.ENABLE_RELEASE_PLEASE }}
-        uses: GoogleCloudPlatform/release-please-action@v2.5.7
+        uses: GoogleCloudPlatform/release-please-action@v2
         with:
           command: release-pr
           token: ${{ secrets.YOSHI_CODE_BOT_TOKEN }}
@@ -24,56 +25,33 @@ jobs:
           monorepo-tags: true
           bump-minor-pre-major: true
       - name: AutoApprove
-        if: ${{ always() && env.ENABLE_RELEASE_PLEASE }}
+        id: auto-approve
+        if: ${{ steps.release-please.outputs.pr }}
         uses: actions/github-script@v2
         with:
           github-token: ${{secrets.YOSHI_APPROVER_TOKEN}}
           script: |
-            let found = false;
-            for (let tries = 3; tries > 0; tries--) {
-              await new Promise(r => setTimeout(r, 2000));
-              const prs = await github.pulls.list({
+            if (process.env.ENABLE_AUTO_APPROVE) {
+              core.info("ENABLE_AUTO_APPROVE is set; labeling and approving");
+              github.pulls.createReview({
                 owner: 'googleapis',
                 repo: 'google-api-ruby-client',
-                state: 'open',
-                sort: 'created',
-                direction: 'desc',
-                per_page: 10
+                body: "AutoApprove: Rubber stamped release!",
+                pull_number: ${{ steps.release-please.outputs.pr }},
+                event: "APPROVE"
               });
-              prs.data.forEach(function(pr) {
-                if (found || pr.user.login != "yoshi-code-bot" || !pr.title.startsWith("Release ")) {
-                  return;
-                }
-                core.info("AutoApprove: Found release PR " + pr.number);
-                if (process.env.ENABLE_AUTO_APPROVE) {
-                  core.info("ENABLE_AUTO_APPROVE is set; labeling and approving");
-                  github.pulls.createReview({
-                    owner: 'googleapis',
-                    repo: 'google-api-ruby-client',
-                    body: "AutoApprove: Rubber stamped release!",
-                    pull_number: pr.number,
-                    event: "APPROVE"
-                  });
-                  github.issues.addLabels({
-                    owner: 'googleapis',
-                    repo: 'google-api-ruby-client',
-                    issue_number: pr.number,
-                    labels: ["autorelease: pending", "automerge", "kokoro:force-run"]
-                  });
-                } else {
-                  core.info("ENABLE_AUTO_APPROVE is not set; labeling release only");
-                  github.issues.addLabels({
-                    owner: 'googleapis',
-                    repo: 'google-api-ruby-client',
-                    issue_number: pr.number,
-                    labels: ["autorelease: pending", "kokoro:force-run"]
-                  });
-                }
-                core.info("AutoApprove: complete!");
-                found = true;
-                tries = 0;
+              github.issues.addLabels({
+                owner: 'googleapis',
+                repo: 'google-api-ruby-client',
+                issue_number: ${{ steps.release-please.outputs.pr }},
+                labels: ["autorelease: pending", "automerge", "kokoro:force-run"]
+              });
+            } else {
+              core.info("ENABLE_AUTO_APPROVE is not set; labeling release only");
+              github.issues.addLabels({
+                owner: 'googleapis',
+                repo: 'google-api-ruby-client',
+                issue_number: ${{ steps.release-please.outputs.pr }},
+                labels: ["autorelease: pending", "kokoro:force-run"]
               });
-            }
-            if (!found) {
-              core.setFailed("Unable to find release PR after 3 tries.");
             }

data/CHANGELOG.md CHANGED

@@ -1,5 +1,105 @@
 # Release History
+## [0.52.0](https://www.github.com/googleapis/google-api-ruby-client/compare/v0.51.0...v0.52.0) (2020-12-14)
+### Features
+* Automated regeneration of adexchangebuyer.v1 2 client ([#1671](https://www.github.com/googleapis/google-api-ruby-client/issues/1671)) ([c57be32](https://www.github.com/googleapis/google-api-ruby-client/commit/c57be3229857ea830df5257be204f9522d55454a))
+* Automated regeneration of adexchangebuyer.v1 3 client ([#1672](https://www.github.com/googleapis/google-api-ruby-client/issues/1672)) ([bb75762](https://www.github.com/googleapis/google-api-ruby-client/commit/bb7576259a9b745738ae001b95a8cfd4b227d66b))
+* Automated regeneration of adexchangebuyer.v1 4 client ([#1673](https://www.github.com/googleapis/google-api-ruby-client/issues/1673)) ([85b8de4](https://www.github.com/googleapis/google-api-ruby-client/commit/85b8de4633912ce1429172d3cc8fe49dbfdd6a81))
+* Automated regeneration of admin datatransfer_v1 client ([#1674](https://www.github.com/googleapis/google-api-ruby-client/issues/1674)) ([e71e318](https://www.github.com/googleapis/google-api-ruby-client/commit/e71e31837511399fc759cf58a607ce9dd81fea9e))
+* Automated regeneration of admin directory_v1 client ([#1675](https://www.github.com/googleapis/google-api-ruby-client/issues/1675)) ([cb6ed54](https://www.github.com/googleapis/google-api-ruby-client/commit/cb6ed54c12478472e3802552e13e0441ae32a18a))
+* Automated regeneration of admin reports_v1 client ([#1676](https://www.github.com/googleapis/google-api-ruby-client/issues/1676)) ([99bb4ca](https://www.github.com/googleapis/google-api-ruby-client/commit/99bb4ca87b6415d5e85657c30f7023d16269a279))
+* Automated regeneration of adsense.v1 4 client ([#1677](https://www.github.com/googleapis/google-api-ruby-client/issues/1677)) ([7f49fd0](https://www.github.com/googleapis/google-api-ruby-client/commit/7f49fd0426264bfe328d8829d8001267f0a3e407))
+* Automated regeneration of adsensehost.v4 1 client ([#1678](https://www.github.com/googleapis/google-api-ruby-client/issues/1678)) ([a651859](https://www.github.com/googleapis/google-api-ruby-client/commit/a65185994d7c2844c1065a554fa141ed551454ff))
+* Automated regeneration of alertcenter v1beta1 client ([#1652](https://www.github.com/googleapis/google-api-ruby-client/issues/1652)) ([e9e5d06](https://www.github.com/googleapis/google-api-ruby-client/commit/e9e5d06389b01d6e371284045081e4ca88260953))
+* Automated regeneration of analytics v3 client ([#1653](https://www.github.com/googleapis/google-api-ruby-client/issues/1653)) ([cfda61d](https://www.github.com/googleapis/google-api-ruby-client/commit/cfda61df35e9f8dca199c1540290cfb75d75aad1))
+* Automated regeneration of analyticsadmin v1alpha client ([#1707](https://www.github.com/googleapis/google-api-ruby-client/issues/1707)) ([1bb8091](https://www.github.com/googleapis/google-api-ruby-client/commit/1bb8091fcf4270989ed1528741f8e96740431e03))
+* Automated regeneration of analyticsadmin v1alpha client ([#1725](https://www.github.com/googleapis/google-api-ruby-client/issues/1725)) ([0a5267f](https://www.github.com/googleapis/google-api-ruby-client/commit/0a5267f699e78644157c9d042821d8414f4bf12e))
+* Automated regeneration of analyticsdata v1alpha client ([#1726](https://www.github.com/googleapis/google-api-ruby-client/issues/1726)) ([800e822](https://www.github.com/googleapis/google-api-ruby-client/commit/800e822b5eb5ee610179aa0f8646db4870e635f8))
+* Automated regeneration of androidmanagement v1 client ([#1679](https://www.github.com/googleapis/google-api-ruby-client/issues/1679)) ([b0453ca](https://www.github.com/googleapis/google-api-ruby-client/commit/b0453cae5f8903fbfe903aef8c6626e9d0521b7a))
+* Automated regeneration of androidmanagement v1 client ([#1708](https://www.github.com/googleapis/google-api-ruby-client/issues/1708)) ([0c94fa2](https://www.github.com/googleapis/google-api-ruby-client/commit/0c94fa208b86b355952ab0dfa76798f0e6796ee3))
+* Automated regeneration of apigateway v1beta client ([#1654](https://www.github.com/googleapis/google-api-ruby-client/issues/1654)) ([185553d](https://www.github.com/googleapis/google-api-ruby-client/commit/185553d169f733bb6c7f034565bc227d70022c50))
+* Automated regeneration of apigee v1 client ([#1655](https://www.github.com/googleapis/google-api-ruby-client/issues/1655)) ([166467b](https://www.github.com/googleapis/google-api-ruby-client/commit/166467b922ac16a75800b2b10fe9605dab3026c2))
+* Automated regeneration of appengine v1 client ([#1727](https://www.github.com/googleapis/google-api-ruby-client/issues/1727)) ([2675818](https://www.github.com/googleapis/google-api-ruby-client/commit/2675818ee1fca0c336f1606476e9697c05cade6e))
+* Automated regeneration of artifactregistry v1beta1 client ([#1743](https://www.github.com/googleapis/google-api-ruby-client/issues/1743)) ([df4ea5f](https://www.github.com/googleapis/google-api-ruby-client/commit/df4ea5fffe157dde9e6604bd6fea6a2b195c13d1))
+* Automated regeneration of artifactregistry v1beta2 client ([#1744](https://www.github.com/googleapis/google-api-ruby-client/issues/1744)) ([7696bc0](https://www.github.com/googleapis/google-api-ruby-client/commit/7696bc052d3c3e1bac258001d71250726f376478))
+* Automated regeneration of bigqueryreservation v1alpha2 client ([#1745](https://www.github.com/googleapis/google-api-ruby-client/issues/1745)) ([133a625](https://www.github.com/googleapis/google-api-ruby-client/commit/133a625de03d18523e3b01d1e81d2fabc605374a))
+* Automated regeneration of cloudasset v1 client ([#1680](https://www.github.com/googleapis/google-api-ruby-client/issues/1680)) ([0492acc](https://www.github.com/googleapis/google-api-ruby-client/commit/0492accc8a44d0f28a484a67f7940d74246ab88d))
+* Automated regeneration of cloudbuild v1 client ([#1656](https://www.github.com/googleapis/google-api-ruby-client/issues/1656)) ([65f13de](https://www.github.com/googleapis/google-api-ruby-client/commit/65f13de330bfd65e702c30c685f2f1feed819874))
+* Automated regeneration of cloudbuild v1alpha1 client ([#1657](https://www.github.com/googleapis/google-api-ruby-client/issues/1657)) ([8629207](https://www.github.com/googleapis/google-api-ruby-client/commit/8629207422003a3377099b7f10716c4cdb61c5d4))
+* Automated regeneration of cloudbuild v1alpha2 client ([#1658](https://www.github.com/googleapis/google-api-ruby-client/issues/1658)) ([aafbe0b](https://www.github.com/googleapis/google-api-ruby-client/commit/aafbe0b5ffba2155ea2fe25fbdd25f74e513d9eb))
+* Automated regeneration of cloudfunctions v1 client ([#1659](https://www.github.com/googleapis/google-api-ruby-client/issues/1659)) ([2a7f9b9](https://www.github.com/googleapis/google-api-ruby-client/commit/2a7f9b91d4d9a6d9ffaa2baa7d1a4a6bbd1b311f))
+* Automated regeneration of cloudidentity v1 client ([#1728](https://www.github.com/googleapis/google-api-ruby-client/issues/1728)) ([5b7f7e0](https://www.github.com/googleapis/google-api-ruby-client/commit/5b7f7e0f53d27d334fb9ec4f327242463ebe1e55))
+* Automated regeneration of cloudidentity v1beta1 client ([#1729](https://www.github.com/googleapis/google-api-ruby-client/issues/1729)) ([0d29fab](https://www.github.com/googleapis/google-api-ruby-client/commit/0d29fab44ae2652b3725c6c95c416da7566fab2c))
+* Automated regeneration of cloudkms v1 client ([#1709](https://www.github.com/googleapis/google-api-ruby-client/issues/1709)) ([beedc5d](https://www.github.com/googleapis/google-api-ruby-client/commit/beedc5d500908f37efdd0ab0a6f21874c6972db1))
+* Automated regeneration of cloudscheduler v1beta1 client ([#1681](https://www.github.com/googleapis/google-api-ruby-client/issues/1681)) ([6b1a631](https://www.github.com/googleapis/google-api-ruby-client/commit/6b1a631b0ad98b0bb325b15d78d138251b1030b0))
+* Automated regeneration of cloudtasks v2beta2 client ([#1682](https://www.github.com/googleapis/google-api-ruby-client/issues/1682)) ([2198064](https://www.github.com/googleapis/google-api-ruby-client/commit/21980640bdd9904152026b295e47ea23fe9d620e))
+* Automated regeneration of cloudtasks v2beta3 client ([#1683](https://www.github.com/googleapis/google-api-ruby-client/issues/1683)) ([271a032](https://www.github.com/googleapis/google-api-ruby-client/commit/271a0326b7075367b1fe1f24fc9a1c98254c957e))
+* Automated regeneration of composer v1beta1 client ([#1751](https://www.github.com/googleapis/google-api-ruby-client/issues/1751)) ([1bdf258](https://www.github.com/googleapis/google-api-ruby-client/commit/1bdf2584bdf3a7133e5eec01b67382bb5e9ea02d))
+* Automated regeneration of compute alpha client ([#1684](https://www.github.com/googleapis/google-api-ruby-client/issues/1684)) ([fc2160a](https://www.github.com/googleapis/google-api-ruby-client/commit/fc2160a30e40b2374c6b1ed97416ed77bf9e63ee))
+* Automated regeneration of compute alpha client ([#1710](https://www.github.com/googleapis/google-api-ruby-client/issues/1710)) ([c174098](https://www.github.com/googleapis/google-api-ruby-client/commit/c174098b27cad2aa250256f102dbbd754361deeb))
+* Automated regeneration of compute beta client ([#1685](https://www.github.com/googleapis/google-api-ruby-client/issues/1685)) ([9e7a0a1](https://www.github.com/googleapis/google-api-ruby-client/commit/9e7a0a144fbc0bdef5ebd548056e511ebafbdee8))
+* Automated regeneration of compute beta client ([#1711](https://www.github.com/googleapis/google-api-ruby-client/issues/1711)) ([ba14d0e](https://www.github.com/googleapis/google-api-ruby-client/commit/ba14d0ec60e6d407a96d52bb29b6b93fb65bfbc6))
+* Automated regeneration of compute v1 client ([#1730](https://www.github.com/googleapis/google-api-ruby-client/issues/1730)) ([e4329ca](https://www.github.com/googleapis/google-api-ruby-client/commit/e4329caa13d9ff0f0d6eb7940417d65c7eda9508))
+* Automated regeneration of container v1 client ([#1731](https://www.github.com/googleapis/google-api-ruby-client/issues/1731)) ([f3e3fcd](https://www.github.com/googleapis/google-api-ruby-client/commit/f3e3fcd5a39913822c7cb22c5c9c28d3ee99c140))
+* Automated regeneration of container v1beta1 client ([#1732](https://www.github.com/googleapis/google-api-ruby-client/issues/1732)) ([aa13ecc](https://www.github.com/googleapis/google-api-ruby-client/commit/aa13eccd1a474070ff6dfba048a2dabbf1640a87))
+* Automated regeneration of content v2.1 client ([#1660](https://www.github.com/googleapis/google-api-ruby-client/issues/1660)) ([1c771b7](https://www.github.com/googleapis/google-api-ruby-client/commit/1c771b791b54c1513adf273a9f9625afeee70f36))
+* Automated regeneration of content.v2 1 client ([#1686](https://www.github.com/googleapis/google-api-ruby-client/issues/1686)) ([7ae5b92](https://www.github.com/googleapis/google-api-ruby-client/commit/7ae5b922647c1fb6221d2b6838b88ab5e55c06bc))
+* Automated regeneration of datamigration v1beta1 client ([#1687](https://www.github.com/googleapis/google-api-ruby-client/issues/1687)) ([7f1a20a](https://www.github.com/googleapis/google-api-ruby-client/commit/7f1a20a03e09838d4594aba82fe80bdb6aad1b59))
+* Automated regeneration of deploymentmanager alpha client ([#1688](https://www.github.com/googleapis/google-api-ruby-client/issues/1688)) ([5ab582b](https://www.github.com/googleapis/google-api-ruby-client/commit/5ab582b9fd0d10a9c077f19503e11742261f2755))
+* Automated regeneration of deploymentmanager alpha client ([#1733](https://www.github.com/googleapis/google-api-ruby-client/issues/1733)) ([21467a1](https://www.github.com/googleapis/google-api-ruby-client/commit/21467a1fddda22b996bdacfdcdef4122c2496fb8))
+* Automated regeneration of deploymentmanager v2 client ([#1734](https://www.github.com/googleapis/google-api-ruby-client/issues/1734)) ([20e570a](https://www.github.com/googleapis/google-api-ruby-client/commit/20e570a78b3bba7eb8ea0d52e9adb1a3f020611f))
+* Automated regeneration of deploymentmanager v2beta client ([#1735](https://www.github.com/googleapis/google-api-ruby-client/issues/1735)) ([bd2875d](https://www.github.com/googleapis/google-api-ruby-client/commit/bd2875d8c126ec19d1a37b9179f60def0bf24899))
+* Automated regeneration of dfareporting.v3 3 client ([#1689](https://www.github.com/googleapis/google-api-ruby-client/issues/1689)) ([ae792b3](https://www.github.com/googleapis/google-api-ruby-client/commit/ae792b300f67e5d1beae75faca38b931cd6b6a2b))
+* Automated regeneration of dfareporting.v3 4 client ([#1690](https://www.github.com/googleapis/google-api-ruby-client/issues/1690)) ([cdc0a61](https://www.github.com/googleapis/google-api-ruby-client/commit/cdc0a61325c5e65cbf13249b34618b66910344c5))
+* Automated regeneration of dialogflow v2 client ([#1691](https://www.github.com/googleapis/google-api-ruby-client/issues/1691)) ([41ee0d0](https://www.github.com/googleapis/google-api-ruby-client/commit/41ee0d042d53463839f75af5d89da88e06bd9c99))
+* Automated regeneration of dialogflow v2beta1 client ([#1692](https://www.github.com/googleapis/google-api-ruby-client/issues/1692)) ([26234dd](https://www.github.com/googleapis/google-api-ruby-client/commit/26234dd7f2a658f616fa1fa1a62e063afa225360))
+* Automated regeneration of dialogflow v3 client ([#1661](https://www.github.com/googleapis/google-api-ruby-client/issues/1661)) ([fb25e74](https://www.github.com/googleapis/google-api-ruby-client/commit/fb25e748bf8365153560c9a02f6fa1ac04e0eb38))
+* Automated regeneration of dialogflow v3 client ([#1693](https://www.github.com/googleapis/google-api-ruby-client/issues/1693)) ([f73a9ba](https://www.github.com/googleapis/google-api-ruby-client/commit/f73a9bab943dd194caf2ee20377cdc1123648c67))
+* Automated regeneration of dialogflow v3beta1 client ([#1694](https://www.github.com/googleapis/google-api-ruby-client/issues/1694)) ([ddfe0aa](https://www.github.com/googleapis/google-api-ruby-client/commit/ddfe0aa803f82a9809231546fac17d4ee8ee23cd))
+* Automated regeneration of dlp v2 client ([#1695](https://www.github.com/googleapis/google-api-ruby-client/issues/1695)) ([321e188](https://www.github.com/googleapis/google-api-ruby-client/commit/321e1881bb470c8c2c864e3bd4f6856ddb6fff37))
+* Automated regeneration of dns v1 client ([#1662](https://www.github.com/googleapis/google-api-ruby-client/issues/1662)) ([f38fcad](https://www.github.com/googleapis/google-api-ruby-client/commit/f38fcad7556907659405ce533a277bca03e40fb9))
+* Automated regeneration of documentai v1beta2 client ([#1696](https://www.github.com/googleapis/google-api-ruby-client/issues/1696)) ([889235f](https://www.github.com/googleapis/google-api-ruby-client/commit/889235f4f6788b81d9eb6b876303a2a0d1d4540e))
+* Automated regeneration of documentai v1beta3 client ([#1697](https://www.github.com/googleapis/google-api-ruby-client/issues/1697)) ([4d3ada8](https://www.github.com/googleapis/google-api-ruby-client/commit/4d3ada802df00b067c6593939b905b1204db72b5))
+* Automated regeneration of doubleclickbidmanager.v1 1 client ([#1698](https://www.github.com/googleapis/google-api-ruby-client/issues/1698)) ([630daeb](https://www.github.com/googleapis/google-api-ruby-client/commit/630daeb01cf2e001b4d87f4896680a249827ec19))
+* Automated regeneration of eventarc v1beta1 client ([#1712](https://www.github.com/googleapis/google-api-ruby-client/issues/1712)) ([ccadd11](https://www.github.com/googleapis/google-api-ruby-client/commit/ccadd11145806e3f697ab72f212a95e9240b13a1))
+* Automated regeneration of file v1 client ([#1699](https://www.github.com/googleapis/google-api-ruby-client/issues/1699)) ([5ba2653](https://www.github.com/googleapis/google-api-ruby-client/commit/5ba2653bc9279f065dcc1de2131b13614d56ab0b))
+* Automated regeneration of genomics v2alpha1 client ([#1700](https://www.github.com/googleapis/google-api-ruby-client/issues/1700)) ([6090200](https://www.github.com/googleapis/google-api-ruby-client/commit/6090200f4cdab3152a40bef1456aafefadb3b667))
+* Automated regeneration of healthcare v1 client ([#1713](https://www.github.com/googleapis/google-api-ruby-client/issues/1713)) ([0e74250](https://www.github.com/googleapis/google-api-ruby-client/commit/0e74250252d156673d9f45271f03a855e6e914e4))
+* Automated regeneration of healthcare v1beta1 client ([#1714](https://www.github.com/googleapis/google-api-ruby-client/issues/1714)) ([32bd0c8](https://www.github.com/googleapis/google-api-ruby-client/commit/32bd0c84d531d0ab4ab552da06ddff1adca73391))
+* Automated regeneration of iap v1 client ([#1664](https://www.github.com/googleapis/google-api-ruby-client/issues/1664)) ([a1e0c79](https://www.github.com/googleapis/google-api-ruby-client/commit/a1e0c790f9e84534551d31f839952ec43fa7ee16))
+* Automated regeneration of iap v1beta1 client ([#1665](https://www.github.com/googleapis/google-api-ruby-client/issues/1665)) ([bf525b6](https://www.github.com/googleapis/google-api-ruby-client/commit/bf525b6e5993865dfc2f529c50905f22c583c50c))
+* Automated regeneration of metastore v1beta client ([#1747](https://www.github.com/googleapis/google-api-ruby-client/issues/1747)) ([586bb49](https://www.github.com/googleapis/google-api-ruby-client/commit/586bb49880e16c81f893fe58c6c350adea83e9d0))
+* Automated regeneration of metastore v1beta client ([#1752](https://www.github.com/googleapis/google-api-ruby-client/issues/1752)) ([6cb986c](https://www.github.com/googleapis/google-api-ruby-client/commit/6cb986c2a99f7b366d26129c79ff616206ef3a7c))
+* Automated regeneration of ml v1 client ([#1715](https://www.github.com/googleapis/google-api-ruby-client/issues/1715)) ([7020259](https://www.github.com/googleapis/google-api-ruby-client/commit/702025939cdd6b087a4f9deb496f7619bd2201bb))
+* Automated regeneration of monitoring v3 client ([#1736](https://www.github.com/googleapis/google-api-ruby-client/issues/1736)) ([d1345cb](https://www.github.com/googleapis/google-api-ruby-client/commit/d1345cbde70298455366cc0e61b2f081e8f24ee2))
+* Automated regeneration of privateca v1beta1 client ([#1701](https://www.github.com/googleapis/google-api-ruby-client/issues/1701)) ([a57471d](https://www.github.com/googleapis/google-api-ruby-client/commit/a57471d9781cb640dfa4262a1f8fc34aac285cf7))
+* Automated regeneration of prod_tt_sasportal v1alpha1 client ([#1748](https://www.github.com/googleapis/google-api-ruby-client/issues/1748)) ([de77656](https://www.github.com/googleapis/google-api-ruby-client/commit/de7765607efbc8f939c040bed4a3164059f7d9f5))
+* Automated regeneration of recommender v1beta1 client ([#1702](https://www.github.com/googleapis/google-api-ruby-client/issues/1702)) ([45b7291](https://www.github.com/googleapis/google-api-ruby-client/commit/45b72912d96f684c2e983639707e59d5eb184128))
+* Automated regeneration of redis v1 client ([#1738](https://www.github.com/googleapis/google-api-ruby-client/issues/1738)) ([a3057ad](https://www.github.com/googleapis/google-api-ruby-client/commit/a3057ad58b4b21f11f560f11a7135e47925d5af7))
+* Automated regeneration of redis v1beta1 client ([#1739](https://www.github.com/googleapis/google-api-ruby-client/issues/1739)) ([dc3ee35](https://www.github.com/googleapis/google-api-ruby-client/commit/dc3ee35829f30dbd8e8e290eb48c26c4aa5c164d))
+* Automated regeneration of safebrowsing v4 client ([#1666](https://www.github.com/googleapis/google-api-ruby-client/issues/1666)) ([a88845d](https://www.github.com/googleapis/google-api-ruby-client/commit/a88845d0f9f0e11905e90f96033489caea58b1fa))
+* Automated regeneration of searchconsole v1 client ([#1717](https://www.github.com/googleapis/google-api-ruby-client/issues/1717)) ([ea6eac7](https://www.github.com/googleapis/google-api-ruby-client/commit/ea6eac7abeb8cf1d91f5cee8528fd78c955c515b))
+* Automated regeneration of serviceconsumermanagement v1beta1 client ([#1719](https://www.github.com/googleapis/google-api-ruby-client/issues/1719)) ([fb719dc](https://www.github.com/googleapis/google-api-ruby-client/commit/fb719dcf800f00079f1e4f6490f824b97f01f5a9))
+* Automated regeneration of servicecontrol v1 client ([#1749](https://www.github.com/googleapis/google-api-ruby-client/issues/1749)) ([fdf3593](https://www.github.com/googleapis/google-api-ruby-client/commit/fdf3593ffd1c993889f5205607f8606b5cc0c1c1))
+* Automated regeneration of servicecontrol v2 client ([#1740](https://www.github.com/googleapis/google-api-ruby-client/issues/1740)) ([ab59cac](https://www.github.com/googleapis/google-api-ruby-client/commit/ab59cac90424e8499cf546ce0d7dd8ca6a87db44))
+* Automated regeneration of servicedirectory v1 client ([#1703](https://www.github.com/googleapis/google-api-ruby-client/issues/1703)) ([85dfa62](https://www.github.com/googleapis/google-api-ruby-client/commit/85dfa62756069a6a6c040a4f611ec01ab4b2d7c5))
+* Automated regeneration of servicenetworking v1 client ([#1704](https://www.github.com/googleapis/google-api-ruby-client/issues/1704)) ([798d66b](https://www.github.com/googleapis/google-api-ruby-client/commit/798d66bd699490ca08495a844b62c763eb9a3ebd))
+* Automated regeneration of servicenetworking v1beta client ([#1705](https://www.github.com/googleapis/google-api-ruby-client/issues/1705)) ([4bab60e](https://www.github.com/googleapis/google-api-ruby-client/commit/4bab60e9f209db6854f5b0483ff77105e3e14b92))
+* Automated regeneration of serviceusage v1 client ([#1722](https://www.github.com/googleapis/google-api-ruby-client/issues/1722)) ([029cd5a](https://www.github.com/googleapis/google-api-ruby-client/commit/029cd5a1d0cb66fb0c77e40976129c2dbc684a6d))
+* Automated regeneration of serviceusage v1beta1 client ([#1723](https://www.github.com/googleapis/google-api-ruby-client/issues/1723)) ([d220baf](https://www.github.com/googleapis/google-api-ruby-client/commit/d220baf3e47c047f3da1438b8ec26623b14c070e))
+* Automated regeneration of slides v1 client ([#1667](https://www.github.com/googleapis/google-api-ruby-client/issues/1667)) ([eb0d9a3](https://www.github.com/googleapis/google-api-ruby-client/commit/eb0d9a338d46709f43bd97d402e7ecd5009747dd))
+* Automated regeneration of speech v1p1beta1 client ([#1750](https://www.github.com/googleapis/google-api-ruby-client/issues/1750)) ([1f8fbe1](https://www.github.com/googleapis/google-api-ruby-client/commit/1f8fbe17449db9c3ff998cd46f2466c99ad8ed1d))
+* Automated regeneration of testing v1 client ([#1706](https://www.github.com/googleapis/google-api-ruby-client/issues/1706)) ([918f23b](https://www.github.com/googleapis/google-api-ruby-client/commit/918f23b9d5bd95d60365b182787de6a8057548c1))
+* Automated regeneration of trafficdirector v2 client ([#1668](https://www.github.com/googleapis/google-api-ruby-client/issues/1668)) ([f0ca06d](https://www.github.com/googleapis/google-api-ruby-client/commit/f0ca06d15ad3bc9de6f438e59d6ac50b07d95685))
+* Automated regeneration of transcoder v1beta1 client ([#1741](https://www.github.com/googleapis/google-api-ruby-client/issues/1741)) ([4f12b75](https://www.github.com/googleapis/google-api-ruby-client/commit/4f12b755fbd0ab520bc2a846fbaf5b0593c06ce1))
+* Automated regeneration of translate v3 client ([#1669](https://www.github.com/googleapis/google-api-ruby-client/issues/1669)) ([1906318](https://www.github.com/googleapis/google-api-ruby-client/commit/19063186f21342dcaed0e3d662df2363f013bc20))
+* Automated regeneration of translate v3beta1 client ([#1670](https://www.github.com/googleapis/google-api-ruby-client/issues/1670)) ([4a08e0b](https://www.github.com/googleapis/google-api-ruby-client/commit/4a08e0b2fde874551723ca843986ed92d354daf1))
+* Automated regeneration of workflows v1beta client ([#1724](https://www.github.com/googleapis/google-api-ruby-client/issues/1724)) ([4c3b503](https://www.github.com/googleapis/google-api-ruby-client/commit/4c3b5036c3f285694392acbf3ad0311a73c9800c))
+* Automated removal of obsolete clients ([#1742](https://www.github.com/googleapis/google-api-ruby-client/issues/1742)) ([14926bc](https://www.github.com/googleapis/google-api-ruby-client/commit/14926bc6021243bb9b419ee77034b7a2fa849937))
 ## [0.51.0](https://www.github.com/googleapis/google-api-ruby-client/compare/google-api-ruby-client-v0.50.0...v0.51.0) (2020-12-07)

data/README.md CHANGED

@@ -356,7 +356,7 @@ document = docs_service.get_document("my-document-id")
 See the [samples](https://github.com/google/google-api-ruby-client/tree/master/samples) for examples on how to use the client library for various
 services.
-Contributions for additional samples are welcome. See [CONTRIBUTING](CONTRIBUTING.md).
+Contributions for additional samples are welcome. See [CONTRIBUTING](.github/CONTRIBUTING.md).
 ## Generating APIs
@@ -378,7 +378,7 @@ A URL can also be specified:
 *  Model validations
 ## Supported Ruby Versions
-This library is currently supported on Ruby 1.9+.
+This library is currently supported on Ruby 1.9+.
 However, Ruby 2.4 or later is strongly recommended, as earlier releases have
 reached or are nearing end-of-life. After March 31, 2019, Google will provide
 official support only for Ruby versions that are considered current and

data/generated/google/apis/admin_datatransfer_v1.rb CHANGED

@@ -18,7 +18,7 @@ require 'google/apis/admin_datatransfer_v1/representations.rb'
 module Google
   module Apis
-    # Admin SDK
+    # Admin SDK API
     #
     # Admin SDK lets administrators of enterprise domains to view and manage
     # resources like user, groups etc. It also provides audit and usage reports of
@@ -27,7 +27,7 @@ module Google
     # @see http://developers.google.com/admin-sdk/
     module AdminDatatransferV1
       VERSION = 'DatatransferV1'
-      REVISION = '20200810'
+      REVISION = '20201124'
       # View and manage data transfers between users in your organization
       AUTH_ADMIN_DATATRANSFER = 'https://www.googleapis.com/auth/admin.datatransfer'

data/generated/google/apis/admin_datatransfer_v1/classes.rb CHANGED

@@ -22,10 +22,8 @@ module Google
   module Apis
     module AdminDatatransferV1
-      # The JSON template for an Application resource. STEPLADDER: Generated unstable
-      # field number for field 'kind'. (See http://go/stepladder-help#fieldNumber)
-      # STEPLADDER: Generated unstable field number for field 'etag'. (See http://go/
-      # stepladder-help#fieldNumber)
+      # Applications resources represent applications installed on the domain that
+      # support transferring ownership of user data.
       class Application
         include Google::Apis::Core::Hashable
@@ -127,10 +125,7 @@ module Google
         end
       end
-      # Template for a collection of Applications. STEPLADDER: Generated unstable
-      # field number for field 'kind'. (See http://go/stepladder-help#fieldNumber)
-      # STEPLADDER: Generated unstable field number for field 'etag'. (See http://go/
-      # stepladder-help#fieldNumber)
+      # Template for a collection of Applications.
       class ApplicationsListResponse
         include Google::Apis::Core::Hashable
@@ -168,10 +163,8 @@ module Google
         end
       end
-      # The JSON template for a DataTransfer resource. STEPLADDER: Generated unstable
-      # field number for field 'kind'. (See http://go/stepladder-help#fieldNumber)
-      # STEPLADDER: Generated unstable field number for field 'etag'. (See http://go/
-      # stepladder-help#fieldNumber)
+      # A Transfer resource represents the transfer of the ownership of user data
+      # between users.
       class DataTransfer
         include Google::Apis::Core::Hashable
@@ -235,10 +228,7 @@ module Google
         end
       end
-      # Template for a collection of DataTransfer resources. STEPLADDER: Generated
-      # unstable field number for field 'kind'. (See http://go/stepladder-help#
-      # fieldNumber) STEPLADDER: Generated unstable field number for field 'etag'. (
-      # See http://go/stepladder-help#fieldNumber)
+      # Template for a collection of DataTransfer resources.
       class DataTransfersListResponse
         include Google::Apis::Core::Hashable

data/generated/google/apis/admin_datatransfer_v1/service.rb CHANGED

@@ -20,7 +20,7 @@ require 'google/apis/errors'
 module Google
   module Apis
     module AdminDatatransferV1
-      # Admin SDK
+      # Admin SDK API
       #
       # Admin SDK lets administrators of enterprise domains to view and manage
       #  resources like user, groups etc. It also provides audit and usage reports of
@@ -45,8 +45,8 @@ module Google
         attr_accessor :quota_user
         def initialize
-          super('https://www.googleapis.com/', '')
-          @batch_path = 'batch/admin/datatransfer_v1'
+          super('https://admin.googleapis.com/', '')
+          @batch_path = 'batch'
         end
         # Retrieves information about an application for the given application ID.

data/generated/google/apis/admin_directory_v1.rb CHANGED

@@ -18,7 +18,7 @@ require 'google/apis/admin_directory_v1/representations.rb'
 module Google
   module Apis
-    # Admin SDK
+    # Admin SDK API
     #
     # Admin SDK lets administrators of enterprise domains to view and manage
     # resources like user, groups etc. It also provides audit and usage reports of
@@ -27,7 +27,7 @@ module Google
     # @see http://developers.google.com/admin-sdk/
     module AdminDirectoryV1
       VERSION = 'DirectoryV1'
-      REVISION = '20201013'
+      REVISION = '20201124'
       # View and manage customer related information
       AUTH_ADMIN_DIRECTORY_CUSTOMER = 'https://www.googleapis.com/auth/admin.directory.customer'

data/generated/google/apis/admin_directory_v1/classes.rb CHANGED

@@ -96,10 +96,12 @@ module Google
         end
       end
-      # The template that returns individual ASP (Access Code) data. STEPLADDER:
-      # Generated unstable field number for field 'kind'. (See http://go/stepladder-
-      # help#fieldNumber) STEPLADDER: Generated unstable field number for field 'etag'.
-      # (See http://go/stepladder-help#fieldNumber)
+      # An application-specific password (ASP) is used with applications that do not
+      # accept a verification code when logging into the application on certain
+      # devices. The ASP access code is used instead of the login and password you
+      # commonly use when accessing an application through a browser. For more
+      # information about ASPs and how to create one, see the [help center](//http://
+      # support.google.com/a/bin/answer.py?amp;answer=1032419).
       class Asp
         include Google::Apis::Core::Hashable
@@ -108,7 +110,8 @@ module Google
         # @return [Fixnum]
         attr_accessor :code_id
-        # The time when the ASP was created. Expressed in Unix time format.
+        # The time when the ASP was created. Expressed in [Unix time](http://en.
+        # wikipedia.org/wiki/Epoch_time) format.
         # Corresponds to the JSON property `creationTime`
         # @return [Fixnum]
         attr_accessor :creation_time
@@ -118,17 +121,18 @@ module Google
         # @return [String]
         attr_accessor :etag
-        # The type of the API resource. This is always admin#directory#asp.
+        # The type of the API resource. This is always `admin#directory#asp`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
-        # The time when the ASP was last used. Expressed in Unix time format.
+        # The time when the ASP was last used. Expressed in [Unix time](http://en.
+        # wikipedia.org/wiki/Epoch_time) format.
         # Corresponds to the JSON property `lastTimeUsed`
         # @return [Fixnum]
         attr_accessor :last_time_used
-        # The name of the application that the user, represented by their userId,
+        # The name of the application that the user, represented by their `userId`,
         # entered when the ASP was created.
         # Corresponds to the JSON property `name`
         # @return [String]
@@ -155,9 +159,7 @@ module Google
         end
       end
-      # STEPLADDER: Generated unstable field number for field 'kind'. (See http://go/
-      # stepladder-help#fieldNumber) STEPLADDER: Generated unstable field number for
-      # field 'etag'. (See http://go/stepladder-help#fieldNumber)
+      #
       class Asps
         include Google::Apis::Core::Hashable
@@ -171,7 +173,7 @@ module Google
         # @return [Array<Google::Apis::AdminDirectoryV1::Asp>]
         attr_accessor :items
-        # The type of the API resource. This is always admin#directory#aspList.
+        # The type of the API resource. This is always `admin#directory#aspList`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -415,8 +417,8 @@ module Google
         # @return [String]
         attr_accessor :generated_resource_name
-        # The type of the resource. For calendar resources, the value is admin#directory#
-        # resources#calendars#CalendarResource.
+        # The type of the resource. For calendar resources, the value is `admin#
+        # directory#resources#calendars#CalendarResource`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -496,8 +498,8 @@ module Google
         # @return [Array<Google::Apis::AdminDirectoryV1::CalendarResource>]
         attr_accessor :items
-        # Identifies this as a collection of CalendarResources. This is always admin#
-        # directory#resources#calendars#calendarResourcesList.
+        # Identifies this as a collection of CalendarResources. This is always `admin#
+        # directory#resources#calendars#calendarResourcesList`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -542,7 +544,7 @@ module Google
         attr_accessor :id
         # Identifies this as a notification channel used to watch for changes to a
-        # resource, which is "api#channel".
+        # resource, which is `api#channel`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -599,28 +601,31 @@ module Google
         end
       end
-      # STEPLADDER: Generated unstable field number for field 'kind'. (See http://go/
-      # stepladder-help#fieldNumber) STEPLADDER: Generated unstable field number for
-      # field 'etag'. (See http://go/stepladder-help#fieldNumber)
+      # Google Chrome devices run on the [Chrome OS](http://support.google.com/
+      # chromeos). For more information about common API tasks, see the [Developer's
+      # Guide](/admin-sdk/directory/v1/guides/manage-chrome-devices).
       class ChromeOsDevice
         include Google::Apis::Core::Hashable
-        # List of active time ranges (Read-only)
+        # List of active time ranges (Read-only).
         # Corresponds to the JSON property `activeTimeRanges`
         # @return [Array<Google::Apis::AdminDirectoryV1::ChromeOsDevice::ActiveTimeRange>]
         attr_accessor :active_time_ranges
-        # AssetId specified during enrollment or through later annotation
+        # The asset identifier as noted by an administrator or specified during
+        # enrollment.
         # Corresponds to the JSON property `annotatedAssetId`
         # @return [String]
         attr_accessor :annotated_asset_id
-        # Address or location of the device as noted by the administrator
+        # The address or location of the device as noted by the administrator. Maximum
+        # length is `200` characters. Empty values are allowed.
         # Corresponds to the JSON property `annotatedLocation`
         # @return [String]
         attr_accessor :annotated_location
-        # User of the device
+        # The user of the device as noted by the administrator. Maximum length is 100
+        # characters. Empty values are allowed.
         # Corresponds to the JSON property `annotatedUser`
         # @return [String]
         attr_accessor :annotated_user
@@ -631,7 +636,13 @@ module Google
         # @return [Fixnum]
         attr_accessor :auto_update_expiration
-        # Chromebook boot mode (Read-only)
+        # The boot mode for the device. The possible values are: * `Verified`: The
+        # device is running a valid version of the Chrome OS. * `Dev`: The devices's
+        # developer hardware switch is enabled. When booted, the device has a command
+        # line shell. For an example of a developer switch, see the [Chromebook
+        # developer information](http://www.chromium.org/chromium-os/developer-
+        # information-for-chrome-os-devices/samsung-series-5-chromebook#TOC-Developer-
+        # switch).
         # Corresponds to the JSON property `bootMode`
         # @return [String]
         attr_accessor :boot_mode
@@ -646,7 +657,7 @@ module Google
         # @return [Array<Google::Apis::AdminDirectoryV1::ChromeOsDevice::DeviceFile>]
         attr_accessor :device_files
-        # Unique identifier of Chrome OS Device (Read-only)
+        # The unique ID of the Chrome device.
         # Corresponds to the JSON property `deviceId`
         # @return [String]
         attr_accessor :device_id
@@ -670,7 +681,7 @@ module Google
         # @return [String]
         attr_accessor :etag
-        # Chromebook Mac Address on ethernet network interface (Read-only)
+        # The device's MAC address on the ethernet network interface.
         # Corresponds to the JSON property `ethernetMacAddress`
         # @return [String]
         attr_accessor :ethernet_mac_address
@@ -683,12 +694,13 @@ module Google
         # @return [String]
         attr_accessor :ethernet_mac_address0
-        # Chromebook firmware version (Read-only)
+        # The Chrome device's firmware version.
         # Corresponds to the JSON property `firmwareVersion`
         # @return [String]
         attr_accessor :firmware_version
-        # Kind of resource this is.
+        # The type of resource. For the Chromeosdevices resource, the value is `admin#
+        # directory#chromeosdevice`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -709,7 +721,8 @@ module Google
         # @return [DateTime]
         attr_accessor :last_sync
-        # Chromebook Mac Address on wifi network interface (Read-only)
+        # The device's wireless MAC address. If the device does not have this
+        # information, it is not included in the response.
         # Corresponds to the JSON property `macAddress`
         # @return [String]
         attr_accessor :mac_address
@@ -719,54 +732,72 @@ module Google
         # @return [String]
         attr_accessor :manufacture_date
-        # Contains either the Mobile Equipment identifier (MEID) or the International
-        # Mobile Equipment Identity (IMEI) for the 3G mobile card in the Chromebook (
-        # Read-only)
+        # The Mobile Equipment Identifier (MEID) or the International Mobile Equipment
+        # Identity (IMEI) for the 3G mobile card in a mobile device. A MEID/IMEI is
+        # typically used when adding a device to a wireless carrier's post-pay service
+        # plan. If the device does not have this information, this property is not
+        # included in the response. For more information on how to export a MEID/IMEI
+        # list, see the [Developer's Guide](/admin-sdk/directory/v1/guides/manage-chrome-
+        # devices.html#export_meid).
         # Corresponds to the JSON property `meid`
         # @return [String]
         attr_accessor :meid
-        # Chromebook Model (Read-only)
+        # The device's model information. If the device does not have this information,
+        # this property is not included in the response.
         # Corresponds to the JSON property `model`
         # @return [String]
         attr_accessor :model
-        # Notes added by the administrator
+        # Notes about this device added by the administrator. This property can be [
+        # searched](http://support.google.com/chromeos/a/bin/answer.py?answer=1698333)
+        # with the [list](/admin-sdk/directory/v1/reference/chromeosdevices/list) method'
+        # s `query` parameter. Maximum length is 500 characters. Empty values are
+        # allowed.
         # Corresponds to the JSON property `notes`
         # @return [String]
         attr_accessor :notes
-        # Chromebook order number (Read-only)
+        # The device's order number. Only devices directly purchased from Google have an
+        # order number.
         # Corresponds to the JSON property `orderNumber`
         # @return [String]
         attr_accessor :order_number
-        # OrgUnit of the device
+        # The full parent path with the organizational unit's name associated with the
+        # device. Path names are case insensitive. If the parent organizational unit is
+        # the top-level organization, it is represented as a forward slash, `/`. This
+        # property can be [updated](/admin-sdk/directory/v1/guides/manage-chrome-devices#
+        # update_chrome_device) using the API. For more information about how to create
+        # an organizational structure for your device, see the [administration help
+        # center](http://support.google.com/a/bin/answer.py?answer=182433).
         # Corresponds to the JSON property `orgUnitPath`
         # @return [String]
         attr_accessor :org_unit_path
-        # Chromebook Os Version (Read-only)
+        # The Chrome device's operating system version.
         # Corresponds to the JSON property `osVersion`
         # @return [String]
         attr_accessor :os_version
-        # Chromebook platform version (Read-only)
+        # The Chrome device's platform version.
         # Corresponds to the JSON property `platformVersion`
         # @return [String]
         attr_accessor :platform_version
-        # List of recent device users, in descending order by last login time (Read-only)
+        # List of recent device users, in descending order, by last login time.
         # Corresponds to the JSON property `recentUsers`
-        # @return [Array<Google::Apis::AdminDirectoryV1::ChromeOsDevice::RecentUser>]
+        # @return [Array<Google::Apis::AdminDirectoryV1::RecentUsers>]
         attr_accessor :recent_users
-        # Chromebook serial number (Read-only)
+        # The Chrome device serial number entered when the device was enabled. This
+        # value is the same as the Admin console's *Serial Number* in the *Chrome OS
+        # Devices* tab.
         # Corresponds to the JSON property `serialNumber`
         # @return [String]
         attr_accessor :serial_number
-        # status of the device (Read-only)
+        # The status of the device.
         # Corresponds to the JSON property `status`
         # @return [String]
         attr_accessor :status
@@ -791,7 +822,8 @@ module Google
         # @return [Google::Apis::AdminDirectoryV1::ChromeOsDevice::TpmVersionInfo]
         attr_accessor :tpm_version_info
-        # Will Chromebook auto renew after support end date (Read-only)
+        # Determines if the device will auto renew its support after the support end
+        # date. This is a read-only property.
         # Corresponds to the JSON property `willAutoRenew`
         # @return [Boolean]
         attr_accessor :will_auto_renew
@@ -845,7 +877,7 @@ module Google
         class ActiveTimeRange
           include Google::Apis::Core::Hashable
-          # Duration in milliseconds
+          # Duration of usage in milliseconds.
           # Corresponds to the JSON property `activeTime`
           # @return [Fixnum]
           attr_accessor :active_time
@@ -1034,31 +1066,6 @@ module Google
           end
         end
-        #
-        class RecentUser
-          include Google::Apis::Core::Hashable
-          # Email address of the user. Present only if the user type is managed
-          # Corresponds to the JSON property `email`
-          # @return [String]
-          attr_accessor :email
-          # The type of the user
-          # Corresponds to the JSON property `type`
-          # @return [String]
-          attr_accessor :type
-          def initialize(**args)
-             update!(**args)
-          end
-          # Update properties of this object
-          def update!(**args)
-            @email = args[:email] if args.key?(:email)
-            @type = args[:type] if args.key?(:type)
-          end
-        end
         #
         class SystemRamFreeReport
           include Google::Apis::Core::Hashable
@@ -1088,7 +1095,8 @@ module Google
         class TpmVersionInfo
           include Google::Apis::Core::Hashable
-          # TPM family.
+          # TPM family. We use the TPM 2.0 style encoding, e.g.: TPM 1.2: "1.2" ->
+          # 312e3200 TPM 2.0: "2.0" -> 322e3000
           # Corresponds to the JSON property `family`
           # @return [String]
           attr_accessor :family
@@ -1103,7 +1111,8 @@ module Google
           # @return [String]
           attr_accessor :manufacturer
-          # TPM specification level.
+          # TPM specification level. See Library Specification for TPM 2.0 and Main
+          # Specification for TPM 1.2.
           # Corresponds to the JSON property `specLevel`
           # @return [String]
           attr_accessor :spec_level
@@ -1138,12 +1147,14 @@ module Google
       class ChromeOsDeviceAction
         include Google::Apis::Core::Hashable
-        # Action to be taken on the ChromeOs Device
+        # Action to be taken on the Chrome OS device.
         # Corresponds to the JSON property `action`
         # @return [String]
         attr_accessor :action
-        #
+        # Only used when the action is `deprovision`. With the `deprovision` action,
+        # this field is required. *Note*: The deprovision reason is audited because it
+        # might have implications on licenses for perpetual subscription customers.
         # Corresponds to the JSON property `deprovisionReason`
         # @return [String]
         attr_accessor :deprovision_reason
@@ -1159,9 +1170,7 @@ module Google
         end
       end
-      # STEPLADDER: Generated unstable field number for field 'kind'. (See http://go/
-      # stepladder-help#fieldNumber) STEPLADDER: Generated unstable field number for
-      # field 'etag'. (See http://go/stepladder-help#fieldNumber)
+      #
       class ChromeOsDevices
         include Google::Apis::Core::Hashable
@@ -1180,7 +1189,8 @@ module Google
         # @return [String]
         attr_accessor :kind
-        # Token used to access next page of this result.
+        # Token used to access the next page of this result. To access the next page,
+        # use this token's value in the `pageToken` query string of this request.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -1202,7 +1212,7 @@ module Google
       class ChromeOsMoveDevicesToOu
         include Google::Apis::Core::Hashable
-        # ChromeOs Devices to be moved to OU
+        # Chrome OS devices to be moved to OU
         # Corresponds to the JSON property `deviceIds`
         # @return [Array<String>]
         attr_accessor :device_ids
@@ -1217,14 +1227,12 @@ module Google
         end
       end
-      # STEPLADDER: Generated unstable field number for field 'kind'. (See http://go/
-      # stepladder-help#fieldNumber) STEPLADDER: Generated unstable field number for
-      # field 'etag'. (See http://go/stepladder-help#fieldNumber)
+      #
       class Customer
         include Google::Apis::Core::Hashable
         # The customer's secondary contact email address. This email address cannot be
-        # on the same domain as the customerDomain
+        # on the same domain as the `customerDomain`
         # Corresponds to the JSON property `alternateEmail`
         # @return [String]
         attr_accessor :alternate_email
@@ -1234,8 +1242,8 @@ module Google
         # @return [DateTime]
         attr_accessor :customer_creation_time
-        # The customer's primary domain name string. Do not include the www prefix when
-        # creating a new customer.
+        # The customer's primary domain name string. Do not include the `www` prefix
+        # when creating a new customer.
         # Corresponds to the JSON property `customerDomain`
         # @return [String]
         attr_accessor :customer_domain
@@ -1250,25 +1258,26 @@ module Google
         # @return [String]
         attr_accessor :id
-        # Identifies the resource as a customer. Value: admin#directory#customer
+        # Identifies the resource as a customer. Value: `admin#directory#customer`
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
-        # The customer's ISO 639-2 language code. The default value is en-US
+        # The customer's ISO 639-2 language code. See the [Language Codes](/admin-sdk/
+        # directory/v1/languages) page for the list of supported codes. Valid language
+        # codes outside the supported set will be accepted by the API but may lead to
+        # unexpected behavior. The default value is `en`.
         # Corresponds to the JSON property `language`
         # @return [String]
         attr_accessor :language
-        # The customer's contact phone number in E.164 format.
+        # The customer's contact phone number in [E.164](http://en.wikipedia.org/wiki/E.
+        # 164) format.
         # Corresponds to the JSON property `phoneNumber`
         # @return [String]
         attr_accessor :phone_number
-        # STEPLADDER: Generated unstable field number for field 'address_line2' to avoid
-        # collision. (See http://go/stepladder-help#fieldNumber) STEPLADDER: Generated
-        # unstable field number for field 'address_line3' to avoid collision. (See http:/
-        # /go/stepladder-help#fieldNumber)
+        # The customer's postal address information.
         # Corresponds to the JSON property `postalAddress`
         # @return [Google::Apis::AdminDirectoryV1::CustomerPostalAddress]
         attr_accessor :postal_address
@@ -1291,10 +1300,7 @@ module Google
         end
       end
-      # STEPLADDER: Generated unstable field number for field 'address_line2' to avoid
-      # collision. (See http://go/stepladder-help#fieldNumber) STEPLADDER: Generated
-      # unstable field number for field 'address_line3' to avoid collision. (See http:/
-      # /go/stepladder-help#fieldNumber)
+      #
       class CustomerPostalAddress
         include Google::Apis::Core::Hashable
@@ -1319,14 +1325,14 @@ module Google
         # @return [String]
         attr_accessor :contact_name
-        # This is a required property. For countryCode information see the ISO 3166
-        # country code elements.
+        # This is a required property. For `countryCode` information see the [ISO 3166
+        # country code elements](http://www.iso.org/iso/country_codes.htm).
         # Corresponds to the JSON property `countryCode`
         # @return [String]
         attr_accessor :country_code
-        # Name of the locality. An example of a locality value is the city of San
-        # Francisco.
+        # Name of the locality. An example of a locality value is the city of `San
+        # Francisco`.
         # Corresponds to the JSON property `locality`
         # @return [String]
         attr_accessor :locality
@@ -1336,14 +1342,14 @@ module Google
         # @return [String]
         attr_accessor :organization_name
-        # The postal code. A postalCode example is a postal zip code such as 10009. This
-        # is in accordance with - http: //portablecontacts.net/draft-spec.html#
+        # The postal code. A postalCode example is a postal zip code such as `10009`.
+        # This is in accordance with - http: //portablecontacts.net/draft-spec.html#
         # address_element.
         # Corresponds to the JSON property `postalCode`
         # @return [String]
         attr_accessor :postal_code
-        # Name of the region. An example of a region value is NY for the state of New
+        # Name of the region. An example of a region value is `NY` for the state of New
         # York.
         # Corresponds to the JSON property `region`
         # @return [String]
@@ -1465,9 +1471,9 @@ module Google
         attr_accessor :command_type
         # The payload for the command, provide it only if command supports it. The
-        # following commands support adding payload: - SET_VOLUME: Payload is a JSON
-        # object in the form: ` "volume": 50 `. The volume has to be an integer in the
-        # range [0,100].
+        # following commands support adding payload: - SET_VOLUME: Payload is a
+        # stringified JSON object in the form: ` "volume": 50 `. The volume has to be an
+        # integer in the range [0,100].
         # Corresponds to the JSON property `payload`
         # @return [String]
         attr_accessor :payload
@@ -1588,7 +1594,8 @@ module Google
       class Domains
         include Google::Apis::Core::Hashable
-        # Creation time of the domain. (Read-only).
+        # Creation time of the domain. Expressed in [Unix time](http://en.wikipedia.org/
+        # wiki/Epoch_time) format. (Read-only).
         # Corresponds to the JSON property `creationTime`
         # @return [Fixnum]
         attr_accessor :creation_time
@@ -1779,34 +1786,46 @@ module Google
         end
       end
-      # STEPLADDER: Generated unstable field number for field 'kind'. (See http://go/
-      # stepladder-help#fieldNumber) STEPLADDER: Generated unstable field number for
-      # field 'etag'. (See http://go/stepladder-help#fieldNumber)
+      # Google Groups provide your users the ability to send messages to groups of
+      # people using the group's email address. For more information about common
+      # tasks, see the [Developer's Guide](/admin-sdk/directory/v1/guides/manage-
+      # groups).
       class Group
         include Google::Apis::Core::Hashable
-        # Is the group created by admin (Read-only) *
+        # Value is `true` if this group was created by an administrator rather than a
+        # user.
         # Corresponds to the JSON property `adminCreated`
         # @return [Boolean]
         attr_accessor :admin_created
         alias_method :admin_created?, :admin_created
-        # List of aliases (Read-only)
+        # List of a group's alias email addresses.
         # Corresponds to the JSON property `aliases`
         # @return [Array<String>]
         attr_accessor :aliases
-        # Description of the group
+        # An extended description to help users determine the purpose of a group. For
+        # example, you can include information about who should join the group, the
+        # types of messages to send to the group, links to FAQs about the group, or
+        # related groups. Maximum length is `4,096` characters.
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
-        # Group direct members count
+        # The number of users that are direct members of the group. If a group is a
+        # member (child) of this group (the parent), members of the child group are not
+        # counted in the `directMembersCount` property of the parent group.
         # Corresponds to the JSON property `directMembersCount`
         # @return [Fixnum]
         attr_accessor :direct_members_count
-        # Email of Group
+        # The group's email address. If your account has multiple domains, select the
+        # appropriate domain for the email address. The `email` must be unique. This
+        # property is required when creating a group. Group email addresses are subject
+        # to the same character usage rules as usernames, see the [administration help
+        # center](http://support.google.com/a/bin/answer.py?answer=33386) for the
+        # details.
         # Corresponds to the JSON property `email`
         # @return [String]
         attr_accessor :email
@@ -1816,22 +1835,28 @@ module Google
         # @return [String]
         attr_accessor :etag
-        # Unique identifier of Group (Read-only)
+        # The unique ID of a group. A group `id` can be used as a group request URI's `
+        # groupKey`.
         # Corresponds to the JSON property `id`
         # @return [String]
         attr_accessor :id
-        # Kind of resource this is.
+        # The type of the API resource. For Groups resources, the value is `admin#
+        # directory#group`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
-        # Group name
+        # The group's display name.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
-        # List of non editable aliases (Read-only)
+        # List of the group's non-editable alias email addresses that are outside of the
+        # account's primary domain or subdomains. These are functioning email addresses
+        # used by the group. This is a read-only property returned in the API's response
+        # for a group. If edited in a group's POST or PUT request, the edit is ignored
+        # by the API service.
         # Corresponds to the JSON property `nonEditableAliases`
         # @return [Array<String>]
         attr_accessor :non_editable_aliases
@@ -1855,9 +1880,7 @@ module Google
         end
       end
-      # STEPLADDER: Generated unstable field number for field 'kind'. (See http://go/
-      # stepladder-help#fieldNumber) STEPLADDER: Generated unstable field number for
-      # field 'etag'. (See http://go/stepladder-help#fieldNumber)
+      #
       class Groups
         include Google::Apis::Core::Hashable
@@ -1894,16 +1917,23 @@ module Google
         end
       end
-      #
+      # A Google Groups member can be a user or another group. This member can be
+      # inside or outside of your account's domains. For more information about common
+      # group member tasks, see the [Developer's Guide](/admin-sdk/directory/v1/guides/
+      # manage-group-members).
       class Member
         include Google::Apis::Core::Hashable
-        # Delivery settings of member
+        # Defines mail delivery preferences of member. This is only supported by create/
+        # update/get.
         # Corresponds to the JSON property `delivery_settings`
         # @return [String]
         attr_accessor :delivery_settings
-        # Email of member (Read-only)
+        # The member's email address. A member can be a user or another group. This
+        # property is required when adding a member to a group. The `email` must be
+        # unique and cannot be an alias of another group. If the email address is
+        # changed, the API automatically reflects the email address changes.
         # Corresponds to the JSON property `email`
         # @return [String]
         attr_accessor :email
@@ -1913,19 +1943,23 @@ module Google
         # @return [String]
         attr_accessor :etag
-        # Unique identifier of group (Read-only) Unique identifier of member (Read-only)
-        # The unique ID of the group member. A member id can be used as a member request
-        # URI's memberKey.
+        # The unique ID of the group member. A member `id` can be used as a member
+        # request URI's `memberKey`.
         # Corresponds to the JSON property `id`
         # @return [String]
         attr_accessor :id
-        # Kind of resource this is.
+        # The type of the API resource. For Members resources, the value is `admin#
+        # directory#member`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
-        # Role of member
+        # The member's role in a group. The API returns an error for cycles in group
+        # memberships. For example, if `group1` is a member of `group2`, `group2` cannot
+        # be a member of `group1`. For more information about a member's role, see the [
+        # administration help center](http://support.google.com/a/bin/answer.py?answer=
+        # 167094).
         # Corresponds to the JSON property `role`
         # @return [String]
         attr_accessor :role
@@ -1935,7 +1969,7 @@ module Google
         # @return [String]
         attr_accessor :status
-        # Type of member (Immutable)
+        # The type of group member.
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -2015,7 +2049,10 @@ module Google
         end
       end
-      #
+      # G Suite Mobile Management includes Android, [Google Sync](http://support.
+      # google.com/a/bin/answer.py?answer=135937), and iOS devices. For more
+      # information about common group mobile device API tasks, see the [Developer's
+      # Guide](/admin-sdk/directory/v1/guides/manage-mobile-devices.html).
       class MobileDevice
         include Google::Apis::Core::Hashable
@@ -2025,12 +2062,17 @@ module Google
         attr_accessor :adb_status
         alias_method :adb_status?, :adb_status
-        # List of applications installed on Mobile Device
+        # The list of applications installed on an Android mobile device. It is not
+        # applicable to Google Sync and iOS devices. The list includes any Android
+        # applications that access G Suite data. When updating an applications list, it
+        # is important to note that updates replace the existing list. If the Android
+        # device has two existing applications and the API updates the list with five
+        # applications, the is now the updated list of five applications.
         # Corresponds to the JSON property `applications`
         # @return [Array<Google::Apis::AdminDirectoryV1::MobileDevice::Application>]
         attr_accessor :applications
-        # Mobile Device Baseband version (Read-only)
+        # The device's baseband version.
         # Corresponds to the JSON property `basebandVersion`
         # @return [String]
         attr_accessor :baseband_version
@@ -2045,12 +2087,12 @@ module Google
         # @return [String]
         attr_accessor :brand
-        # Mobile Device Build number (Read-only)
+        # The device's operating system build number.
         # Corresponds to the JSON property `buildNumber`
         # @return [String]
         attr_accessor :build_number
-        # The default locale used on the Mobile Device (Read-only)
+        # The default locale used on the device.
         # Corresponds to the JSON property `defaultLanguage`
         # @return [String]
         attr_accessor :default_language
@@ -2061,12 +2103,13 @@ module Google
         attr_accessor :developer_options_status
         alias_method :developer_options_status?, :developer_options_status
-        # Mobile Device compromised status (Read-only)
+        # The compromised device status.
         # Corresponds to the JSON property `deviceCompromisedStatus`
         # @return [String]
         attr_accessor :device_compromised_status
-        # Mobile Device serial number (Read-only)
+        # The serial number for a Google Sync mobile device. For Android and iOS devices,
+        # this is a software generated unique identifier.
         # Corresponds to the JSON property `deviceId`
         # @return [String]
         attr_accessor :device_id
@@ -2076,7 +2119,10 @@ module Google
         # @return [String]
         attr_accessor :device_password_status
-        # List of owner user's email addresses (Read-only)
+        # List of owner's email addresses. If your application needs the current list of
+        # user emails, use the [get](/admin-sdk/directory/v1/reference/mobiledevices/get.
+        # html) method. For additional information, see the [retrieve a user](/admin-sdk/
+        # directory/v1/guides/manage-users#get_user) method.
         # Corresponds to the JSON property `email`
         # @return [Array<String>]
         attr_accessor :email
@@ -2102,22 +2148,25 @@ module Google
         # @return [String]
         attr_accessor :hardware
-        # Mobile Device Hardware Id (Read-only)
+        # The IMEI/MEID unique identifier for Android hardware. It is not applicable to
+        # Google Sync devices. When adding an Android mobile device, this is an optional
+        # property. When updating one of these devices, this is a read-only property.
         # Corresponds to the JSON property `hardwareId`
         # @return [String]
         attr_accessor :hardware_id
-        # Mobile Device IMEI number (Read-only)
+        # The device's IMEI number.
         # Corresponds to the JSON property `imei`
         # @return [String]
         attr_accessor :imei
-        # Mobile Device Kernel version (Read-only)
+        # The device's kernel version.
         # Corresponds to the JSON property `kernelVersion`
         # @return [String]
         attr_accessor :kernel_version
-        # Kind of resource this is.
+        # The type of the API resource. For Mobiledevices resources, the value is `admin#
+        # directory#mobiledevice`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -2128,8 +2177,7 @@ module Google
         # @return [DateTime]
         attr_accessor :last_sync
-        # Boolean indicating if this account is on owner/primary profile or not (Read-
-        # only)
+        # Boolean indicating if this account is on owner/primary profile or not.
         # Corresponds to the JSON property `managedAccountIsOnOwnerProfile`
         # @return [Boolean]
         attr_accessor :managed_account_is_on_owner_profile
@@ -2140,17 +2188,24 @@ module Google
         # @return [String]
         attr_accessor :manufacturer
-        # Mobile Device MEID number (Read-only)
+        # The device's MEID number.
         # Corresponds to the JSON property `meid`
         # @return [String]
         attr_accessor :meid
-        # Name of the model of the device
+        # The mobile device's model name, for example Nexus S. This property can be [
+        # updated](/admin-sdk/directory/v1/reference/mobiledevices/update.html). For
+        # more information, see the [Developer's Guide](/admin-sdk/directory/v1/guides/
+        # manage-mobile=devices#update_mobile_device).
         # Corresponds to the JSON property `model`
         # @return [String]
         attr_accessor :model
-        # List of owner user's names (Read-only)
+        # List of the owner's user names. If your application needs the current list of
+        # device owner names, use the [get](/admin-sdk/directory/v1/reference/
+        # mobiledevices/get.html) method. For more information about retrieving mobile
+        # device user information, see the [Developer's Guide](/admin-sdk/directory/v1/
+        # guides/manage-users#get_user).
         # Corresponds to the JSON property `name`
         # @return [Array<String>]
         attr_accessor :name
@@ -2160,7 +2215,10 @@ module Google
         # @return [String]
         attr_accessor :network_operator
-        # Name of the mobile operating system
+        # The mobile device's operating system, for example IOS 4.3 or Android 2.3.5.
+        # This property can be [updated](/admin-sdk/directory/v1/reference/mobiledevices/
+        # update.html). For more information, see the [Developer's Guide](/admin-sdk/
+        # directory/v1/guides/manage-mobile-devices#update_mobile_device).
         # Corresponds to the JSON property `os`
         # @return [String]
         attr_accessor :os
@@ -2180,7 +2238,7 @@ module Google
         # @return [String]
         attr_accessor :release_version
-        # Unique identifier of Mobile Device (Read-only)
+        # The unique ID the API service uses to identify the mobile device.
         # Corresponds to the JSON property `resourceId`
         # @return [String]
         attr_accessor :resource_id
@@ -2190,12 +2248,12 @@ module Google
         # @return [Fixnum]
         attr_accessor :security_patch_level
-        # Mobile Device SSN or Serial Number (Read-only)
+        # The device's serial number.
         # Corresponds to the JSON property `serialNumber`
         # @return [String]
         attr_accessor :serial_number
-        # Status of the device (Read-only)
+        # The device's status.
         # Corresponds to the JSON property `status`
         # @return [String]
         attr_accessor :status
@@ -2206,7 +2264,7 @@ module Google
         attr_accessor :supports_work_profile
         alias_method :supports_work_profile?, :supports_work_profile
-        # The type of device (Read-only)
+        # The type of mobile device.
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -2217,12 +2275,15 @@ module Google
         attr_accessor :unknown_sources_status
         alias_method :unknown_sources_status?, :unknown_sources_status
-        # Mobile Device user agent
+        # Gives information about the device such as `os` version. This property can be [
+        # updated](/admin-sdk/directory/v1/reference/mobiledevices/update.html). For
+        # more information, see the [Developer's Guide](/admin-sdk/directory/v1/guides/
+        # manage-mobile-devices#update_mobile_device).
         # Corresponds to the JSON property `userAgent`
         # @return [String]
         attr_accessor :user_agent
-        # Mobile Device WiFi MAC address (Read-only)
+        # The device's MAC address on Wi-Fi networks.
         # Corresponds to the JSON property `wifiMacAddress`
         # @return [String]
         attr_accessor :wifi_mac_address
@@ -2279,27 +2340,31 @@ module Google
         class Application
           include Google::Apis::Core::Hashable
-          # Display name of application
+          # The application's display name. An example is `Browser`.
           # Corresponds to the JSON property `displayName`
           # @return [String]
           attr_accessor :display_name
-          # Package name of application
+          # The application's package name. An example is `com.android.browser`.
           # Corresponds to the JSON property `packageName`
           # @return [String]
           attr_accessor :package_name
-          # List of Permissions for application
+          # The list of permissions of this application. These can be either a standard
+          # Android permission or one defined by the application, and are found in an
+          # application's [Android manifest](http://developer.android.com/guide/topics/
+          # manifest/uses-permission-element.html). Examples of a Calendar application's
+          # permissions are `READ_CALENDAR`, or `MANAGE_ACCOUNTS`.
           # Corresponds to the JSON property `permission`
           # @return [Array<String>]
           attr_accessor :permission
-          # Version code of application
+          # The application's version code. An example is `13`.
           # Corresponds to the JSON property `versionCode`
           # @return [Fixnum]
           attr_accessor :version_code
-          # Version name of application
+          # The application's version name. An example is `3.2-140714`.
           # Corresponds to the JSON property `versionName`
           # @return [String]
           attr_accessor :version_name
@@ -2323,7 +2388,7 @@ module Google
       class MobileDeviceAction
         include Google::Apis::Core::Hashable
-        # Action to be taken on the Mobile Device
+        # The action to be performed on the device.
         # Corresponds to the JSON property `action`
         # @return [String]
         attr_accessor :action
@@ -2375,20 +2440,25 @@ module Google
         end
       end
-      # JSON template for Org Unit resource in Directory API. STEPLADDER: Generated
-      # unstable field number for field 'kind'. (See http://go/stepladder-help#
-      # fieldNumber) STEPLADDER: Generated unstable field number for field 'etag'. (
-      # See http://go/stepladder-help#fieldNumber)
+      # Managing your account's organizational units allows you to configure your
+      # users' access to services and custom settings. For more information about
+      # common organizational unit tasks, see the [Developer's Guide](/admin-sdk/
+      # directory/v1/guides/manage-org-units.html).
       class OrgUnit
         include Google::Apis::Core::Hashable
-        # Should block inheritance
+        # Determines if a sub-organizational unit can inherit the settings of the parent
+        # organization. The default value is `false`, meaning a sub-organizational unit
+        # inherits the settings of the nearest parent organizational unit. For more
+        # information on inheritance and users in an organization structure, see the [
+        # administration help center](http://support.google.com/a/bin/answer.py?answer=
+        # 182442&topic=1227584&ctx=topic).
         # Corresponds to the JSON property `blockInheritance`
         # @return [Boolean]
         attr_accessor :block_inheritance
         alias_method :block_inheritance?, :block_inheritance
-        # Description of OrgUnit
+        # Description of the organizational unit.
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
@@ -2398,32 +2468,49 @@ module Google
         # @return [String]
         attr_accessor :etag
-        # Kind of resource this is.
+        # The type of the API resource. For Orgunits resources, the value is `admin#
+        # directory#orgUnit`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
-        # Name of OrgUnit
+        # The organizational unit's path name. For example, an organizational unit's
+        # name within the /corp/support/sales_support parent path is sales_support.
+        # Required.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
-        # Id of OrgUnit
+        # The unique ID of the organizational unit.
         # Corresponds to the JSON property `orgUnitId`
         # @return [String]
         attr_accessor :org_unit_id
-        # Path of OrgUnit
+        # The full path to the organizational unit. The `orgUnitPath` is a derived
+        # property. When listed, it is derived from `parentOrgunitPath` and
+        # organizational unit's `name`. For example, for an organizational unit named '
+        # apps' under parent organization '/engineering', the orgUnitPath is '/
+        # engineering/apps'. In order to edit an `orgUnitPath`, either update the name
+        # of the organization or the `parentOrgunitPath`. A user's organizational unit
+        # determines which G Suite services the user has access to. If the user is moved
+        # to a new organization, the user's access changes. For more information about
+        # organization structures, see the [administration help center](http://support.
+        # google.com/a/bin/answer.py?answer=182433&topic=1227584&ctx=topic). For more
+        # information about moving a user to a different organization, see [Update a
+        # user](/admin-sdk/directory/v1/guides/manage-users.html#update_user).
         # Corresponds to the JSON property `orgUnitPath`
         # @return [String]
         attr_accessor :org_unit_path
-        # Id of parent OrgUnit
+        # The unique ID of the parent organizational unit. Required, unless `
+        # parentOrgUnitPath` is set.
         # Corresponds to the JSON property `parentOrgUnitId`
         # @return [String]
         attr_accessor :parent_org_unit_id
-        # Path of parent OrgUnit
+        # The organizational unit's parent path. For example, /corp/sales is the parent
+        # path for /corp/sales/sales_support organizational unit. Required, unless `
+        # parentOrgUnitId` is set.
         # Corresponds to the JSON property `parentOrgUnitPath`
         # @return [String]
         attr_accessor :parent_org_unit_path
@@ -2446,10 +2533,7 @@ module Google
         end
       end
-      # JSON response template for List Organization Units operation in Directory API.
-      # STEPLADDER: Generated unstable field number for field 'kind'. (See http://go/
-      # stepladder-help#fieldNumber) STEPLADDER: Generated unstable field number for
-      # field 'etag'. (See http://go/stepladder-help#fieldNumber)
+      #
       class OrgUnits
         include Google::Apis::Core::Hashable
@@ -2458,12 +2542,13 @@ module Google
         # @return [String]
         attr_accessor :etag
-        # Kind of resource this is.
+        # The type of the API resource. For Org Unit resources, the type is `admin#
+        # directory#orgUnits`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
-        # List of user objects.
+        # List of organizational unit objects.
         # Corresponds to the JSON property `organizationUnits`
         # @return [Array<Google::Apis::AdminDirectoryV1::OrgUnit>]
         attr_accessor :organization_units
@@ -2502,7 +2587,7 @@ module Google
         attr_accessor :is_ou_scopable
         alias_method :is_ou_scopable?, :is_ou_scopable
-        # The type of the API resource. This is always admin#directory#privilege.
+        # The type of the API resource. This is always `admin#directory#privilege`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -2513,7 +2598,7 @@ module Google
         attr_accessor :privilege_name
         # The obfuscated ID of the service this privilege is for. This value is returned
-        # with Privileges.list().
+        # with [`Privileges.list()`](/admin-sdk/directory/v1/reference/privileges/list).
         # Corresponds to the JSON property `serviceId`
         # @return [String]
         attr_accessor :service_id
@@ -2553,7 +2638,7 @@ module Google
         # @return [Array<Google::Apis::AdminDirectoryV1::Privilege>]
         attr_accessor :items
-        # The type of the API resource. This is always admin#directory#privileges.
+        # The type of the API resource. This is always `admin#directory#privileges`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -2570,6 +2655,32 @@ module Google
         end
       end
+      # List of recent device users, in descending order, by last login time.
+      class RecentUsers
+        include Google::Apis::Core::Hashable
+        # The user's email address. This is only present if the user type is `
+        # USER_TYPE_MANAGED`.
+        # Corresponds to the JSON property `email`
+        # @return [String]
+        attr_accessor :email
+        # The type of the user.
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
+        def initialize(**args)
+           update!(**args)
+        end
+        # Update properties of this object
+        def update!(**args)
+          @email = args[:email] if args.key?(:email)
+          @type = args[:type] if args.key?(:type)
+        end
+      end
       #
       class Role
         include Google::Apis::Core::Hashable
@@ -2579,19 +2690,19 @@ module Google
         # @return [String]
         attr_accessor :etag
-        # Returns true if the role is a super admin role.
+        # Returns `true` if the role is a super admin role.
         # Corresponds to the JSON property `isSuperAdminRole`
         # @return [Boolean]
         attr_accessor :is_super_admin_role
         alias_method :is_super_admin_role?, :is_super_admin_role
-        # Returns true if this is a pre-defined system role.
+        # Returns `true` if this is a pre-defined system role.
         # Corresponds to the JSON property `isSystemRole`
         # @return [Boolean]
         attr_accessor :is_system_role
         alias_method :is_system_role?, :is_system_role
-        # The type of the API resource. This is always admin#directory#role.
+        # The type of the API resource. This is always `admin#directory#role`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -2642,7 +2753,7 @@ module Google
           attr_accessor :privilege_name
           # The obfuscated ID of the service this privilege is for. This value is returned
-          # with Privileges.list().
+          # with [`Privileges.list()`](/admin-sdk/directory/v1/reference/privileges/list).
           # Corresponds to the JSON property `serviceId`
           # @return [String]
           attr_accessor :service_id
@@ -2673,7 +2784,7 @@ module Google
         # @return [String]
         attr_accessor :etag
-        # The type of the API resource. This is always admin#directory#roleAssignment.
+        # The type of the API resource. This is always `admin#directory#roleAssignment`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -2694,8 +2805,7 @@ module Google
         # @return [Fixnum]
         attr_accessor :role_id
-        # The scope in which this role is assigned. Possible values are: - CUSTOMER -
-        # ORG_UNIT
+        # The scope in which this role is assigned.
         # Corresponds to the JSON property `scopeType`
         # @return [String]
         attr_accessor :scope_type
@@ -2730,7 +2840,7 @@ module Google
         # @return [Array<Google::Apis::AdminDirectoryV1::RoleAssignment>]
         attr_accessor :items
-        # The type of the API resource. This is always admin#directory#roleAssignments .
+        # The type of the API resource. This is always `admin#directory#roleAssignments`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -2767,7 +2877,7 @@ module Google
         # @return [Array<Google::Apis::AdminDirectoryV1::Role>]
         attr_accessor :items
-        # The type of the API resource. This is always admin#directory#roles.
+        # The type of the API resource. This is always `admin#directory#roles`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -2790,10 +2900,8 @@ module Google
         end
       end
-      # JSON template for Schema resource in Directory API. STEPLADDER: Generated
-      # unstable field number for field 'kind'. (See http://go/stepladder-help#
-      # fieldNumber) STEPLADDER: Generated unstable field number for field 'etag'. (
-      # See http://go/stepladder-help#fieldNumber)
+      # The type of API resource. For Schema resources, this is always `admin#
+      # directory#schema`.
       class Schema
         include Google::Apis::Core::Hashable
@@ -2802,12 +2910,12 @@ module Google
         # @return [String]
         attr_accessor :display_name
-        # ETag of the resource.
+        # The ETag of the resource.
         # Corresponds to the JSON property `etag`
         # @return [String]
         attr_accessor :etag
-        # Fields of Schema
+        # A list of fields in the schema.
         # Corresponds to the JSON property `fields`
         # @return [Array<Google::Apis::AdminDirectoryV1::SchemaFieldSpec>]
         attr_accessor :fields
@@ -2817,12 +2925,12 @@ module Google
         # @return [String]
         attr_accessor :kind
-        # Unique identifier of Schema (Read-only)
+        # The unique identifier of the schema (Read-only)
         # Corresponds to the JSON property `schemaId`
         # @return [String]
         attr_accessor :schema_id
-        # Schema name
+        # The schema's name.
         # Corresponds to the JSON property `schemaName`
         # @return [String]
         attr_accessor :schema_name
@@ -2842,10 +2950,11 @@ module Google
         end
       end
-      # JSON template for FieldSpec resource for Schemas in Directory API. STEPLADDER:
-      # Generated unstable field number for field 'kind'. (See http://go/stepladder-
-      # help#fieldNumber) STEPLADDER: Generated unstable field number for field 'etag'.
-      # (See http://go/stepladder-help#fieldNumber)
+      # You can use schemas to add custom fields to user profiles. You can use these
+      # fields to store information such as the projects your users work on, their
+      # physical locations, their hire dates, or whatever else fits your business
+      # needs. For more information, see [Custom User Fields](/admin-sdk/directory/v1/
+      # guides/manage-schemas).
       class SchemaFieldSpec
         include Google::Apis::Core::Hashable
@@ -2854,52 +2963,56 @@ module Google
         # @return [String]
         attr_accessor :display_name
-        # ETag of the resource.
+        # The ETag of the field.
         # Corresponds to the JSON property `etag`
         # @return [String]
         attr_accessor :etag
-        # Unique identifier of Field (Read-only)
+        # The unique identifier of the field (Read-only)
         # Corresponds to the JSON property `fieldId`
         # @return [String]
         attr_accessor :field_id
-        # Name of the field.
+        # The name of the field.
         # Corresponds to the JSON property `fieldName`
         # @return [String]
         attr_accessor :field_name
-        # Type of the field.
+        # The type of the field.
         # Corresponds to the JSON property `fieldType`
         # @return [String]
         attr_accessor :field_type
-        # Boolean specifying whether the field is indexed or not.
+        # Boolean specifying whether the field is indexed or not. Default: `true`.
         # Corresponds to the JSON property `indexed`
         # @return [Boolean]
         attr_accessor :indexed
         alias_method :indexed?, :indexed
-        # Kind of resource this is.
+        # The kind of resource this is. For schema fields this is always `admin#
+        # directory#schema#fieldspec`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
-        # Boolean specifying whether this is a multi-valued field or not.
+        # A boolean specifying whether this is a multi-valued field or not. Default: `
+        # false`.
         # Corresponds to the JSON property `multiValued`
         # @return [Boolean]
         attr_accessor :multi_valued
         alias_method :multi_valued?, :multi_valued
         # Indexing spec for a numeric field. By default, only exact match queries will
-        # be supported for numeric fields. Setting the numericIndexingSpec allows range
-        # queries to be supported.
+        # be supported for numeric fields. Setting the `numericIndexingSpec` allows
+        # range queries to be supported.
         # Corresponds to the JSON property `numericIndexingSpec`
         # @return [Google::Apis::AdminDirectoryV1::SchemaFieldSpec::NumericIndexingSpec]
         attr_accessor :numeric_indexing_spec
-        # Read ACLs on the field specifying who can view values of this field. Valid
-        # values are "ALL_DOMAIN_USERS" and "ADMINS_AND_SELF".
+        # Specifies who can view values of this field. See [Retrieve users as a non-
+        # administrator](/admin-sdk/directory/v1/guides/manage-users#
+        # retrieve_users_non_admin) for more information. Note: It may take up to 24
+        # hours for changes to this field to be reflected.
         # Corresponds to the JSON property `readAccessType`
         # @return [String]
         attr_accessor :read_access_type
@@ -2923,8 +3036,8 @@ module Google
         end
         # Indexing spec for a numeric field. By default, only exact match queries will
-        # be supported for numeric fields. Setting the numericIndexingSpec allows range
-        # queries to be supported.
+        # be supported for numeric fields. Setting the `numericIndexingSpec` allows
+        # range queries to be supported.
         class NumericIndexingSpec
           include Google::Apis::Core::Hashable
@@ -2954,10 +3067,7 @@ module Google
         end
       end
-      # JSON response template for List Schema operation in Directory API. STEPLADDER:
-      # Generated unstable field number for field 'kind'. (See http://go/stepladder-
-      # help#fieldNumber) STEPLADDER: Generated unstable field number for field 'etag'.
-      # (See http://go/stepladder-help#fieldNumber)
+      # JSON response template for List Schema operation in Directory API.
       class Schemas
         include Google::Apis::Core::Hashable
@@ -2988,14 +3098,11 @@ module Google
         end
       end
-      # JSON template for token resource in Directory API. STEPLADDER: Generated
-      # unstable field number for field 'kind'. (See http://go/stepladder-help#
-      # fieldNumber) STEPLADDER: Generated unstable field number for field 'etag'. (
-      # See http://go/stepladder-help#fieldNumber)
+      # JSON template for token resource in Directory API.
       class Token
         include Google::Apis::Core::Hashable
-        # Whether the application is registered with Google. The value is true if the
+        # Whether the application is registered with Google. The value is `true` if the
         # application has an anonymous Client ID.
         # Corresponds to the JSON property `anonymous`
         # @return [Boolean]
@@ -3017,13 +3124,13 @@ module Google
         # @return [String]
         attr_accessor :etag
-        # The type of the API resource. This is always admin#directory#token.
+        # The type of the API resource. This is always `admin#directory#token`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
-        # Whether the token is issued to an installed application. The value is true if
-        # the application is installed to a desktop or mobile device.
+        # Whether the token is issued to an installed application. The value is `true`
+        # if the application is installed to a desktop or mobile device.
         # Corresponds to the JSON property `nativeApp`
         # @return [Boolean]
         attr_accessor :native_app
@@ -3056,10 +3163,7 @@ module Google
         end
       end
-      # JSON response template for List tokens operation in Directory API. STEPLADDER:
-      # Generated unstable field number for field 'kind'. (See http://go/stepladder-
-      # help#fieldNumber) STEPLADDER: Generated unstable field number for field 'etag'.
-      # (See http://go/stepladder-help#fieldNumber)
+      # JSON response template for List tokens operation in Directory API.
       class Tokens
         include Google::Apis::Core::Hashable
@@ -3073,7 +3177,7 @@ module Google
         # @return [Array<Google::Apis::AdminDirectoryV1::Token>]
         attr_accessor :items
-        # The type of the API resource. This is always admin#directory#tokenList.
+        # The type of the API resource. This is always `admin#directory#tokenList`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -3090,49 +3194,28 @@ module Google
         end
       end
-      # STEPLADDER: Generated unstable field number for field 'kind'. (See http://go/
-      # stepladder-help#fieldNumber) STEPLADDER: Generated unstable field number for
-      # field 'etag'. (See http://go/stepladder-help#fieldNumber) STEPLADDER:
-      # Generated unstable field number for field 'external_ids' to avoid collision. (
-      # See http://go/stepladder-help#fieldNumber) STEPLADDER: Generated unstable
-      # field number for field 'relations' to avoid collision. (See http://go/
-      # stepladder-help#fieldNumber) STEPLADDER: Generated unstable field number for
-      # field 'addresses' to avoid collision. (See http://go/stepladder-help#
-      # fieldNumber) STEPLADDER: Generated unstable field number for field '
-      # organizations' to avoid collision. (See http://go/stepladder-help#fieldNumber)
-      # STEPLADDER: Generated unstable field number for field 'phones' to avoid
-      # collision. (See http://go/stepladder-help#fieldNumber) STEPLADDER: Generated
-      # unstable field number for field 'languages' to avoid collision. (See http://go/
-      # stepladder-help#fieldNumber) STEPLADDER: Generated unstable field number for
-      # field 'posix_accounts' to avoid collision. (See http://go/stepladder-help#
-      # fieldNumber) STEPLADDER: Generated unstable field number for field '
-      # ssh_public_keys' to avoid collision. (See http://go/stepladder-help#
-      # fieldNumber) STEPLADDER: Generated unstable field number for field 'notes' to
-      # avoid collision. (See http://go/stepladder-help#fieldNumber) STEPLADDER:
-      # Generated unstable field number for field 'websites' to avoid collision. (See
-      # http://go/stepladder-help#fieldNumber) STEPLADDER: Generated unstable field
-      # number for field 'locations' to avoid collision. (See http://go/stepladder-
-      # help#fieldNumber) STEPLADDER: Generated unstable field number for field '
-      # keywords' to avoid collision. (See http://go/stepladder-help#fieldNumber)
-      # STEPLADDER: Generated unstable field number for field 'gender' to avoid
-      # collision. (See http://go/stepladder-help#fieldNumber) STEPLADDER: Generated
-      # unstable field number for field 'thumbnail_photo_etag' to avoid collision. (
-      # See http://go/stepladder-help#fieldNumber)
+      # The Directory API allows you to create and manage your account's users, user
+      # aliases, and user Gmail chat profile photos. For more information about common
+      # tasks, see the [User Accounts Developer's Guide](/admin-sdk/directory/v1/
+      # guides/manage-users.html) and the [User Aliases Developer's Guide](/admin-sdk/
+      # directory/v1/guides/manage-user-aliases.html).
       class User
         include Google::Apis::Core::Hashable
-        # Addresses of User
+        # A list of the user's addresses. The maximum allowed data size for this field
+        # is 10Kb.
         # Corresponds to the JSON property `addresses`
         # @return [Object]
         attr_accessor :addresses
-        # Output only. Indicates if user has agreed to terms (Read-only)
+        # Output only. This property is `true` if the user has completed an initial
+        # login and accepted the Terms of Service agreement.
         # Corresponds to the JSON property `agreedToTerms`
         # @return [Boolean]
         attr_accessor :agreed_to_terms
         alias_method :agreed_to_terms?, :agreed_to_terms
-        # Output only. List of aliases (Read-only)
+        # Output only. List of the user's alias email addresses.
         # Corresponds to the JSON property `aliases`
         # @return [Array<String>]
         attr_accessor :aliases
@@ -3143,7 +3226,9 @@ module Google
         attr_accessor :archived
         alias_method :archived?, :archived
-        # Boolean indicating if the user should change password in next login
+        # Indicates if the user is forced to change their password at next login. This
+        # setting doesn't apply when [the user signs in via a third-party identity
+        # provider](https://support.google.com/a/answer/60224).
         # Corresponds to the JSON property `changePasswordAtNextLogin`
         # @return [Boolean]
         attr_accessor :change_password_at_next_login
@@ -3159,7 +3244,12 @@ module Google
         # @return [Hash<String,Hash<String,Object>>]
         attr_accessor :custom_schemas
-        # Output only. CustomerId of User (Read-only)
+        # Output only. The customer ID to [retrieve all account users](/admin-sdk/
+        # directory/v1/guides/manage-users.html#get_all_users). You can use the alias `
+        # my_customer` to represent your account's `customerId`. As a reseller
+        # administrator, you can use the resold customer account's `customerId`. To get
+        # a `customerId`, use the account's primary domain in the `domain` parameter of
+        # a [users.list](/admin-sdk/directory/v1/reference/users/list) request.
         # Corresponds to the JSON property `customerId`
         # @return [String]
         attr_accessor :customer_id
@@ -3169,7 +3259,8 @@ module Google
         # @return [DateTime]
         attr_accessor :deletion_time
-        # Emails of User
+        # A list of the user's email addresses. The maximum allowed data size for this
+        # field is 10Kb.
         # Corresponds to the JSON property `emails`
         # @return [Object]
         attr_accessor :emails
@@ -3179,50 +3270,72 @@ module Google
         # @return [String]
         attr_accessor :etag
-        # The external Ids of User *
+        # A list of external IDs for the user, such as an employee or network ID. The
+        # maximum allowed data size for this field is 2Kb.
         # Corresponds to the JSON property `externalIds`
         # @return [Object]
         attr_accessor :external_ids
-        # Gender of User
+        # The user's gender. The maximum allowed data size for this field is 1Kb.
         # Corresponds to the JSON property `gender`
         # @return [Object]
         attr_accessor :gender
-        # Hash function name for password. Supported are MD5, SHA-1 and crypt
+        # Stores the hash format of the password property. We recommend sending the `
+        # password` property value as a base 16 bit hexadecimal-encoded hash value. Set
+        # the `hashFunction` values as either the [SHA-1](http://wikipedia.org/wiki/SHA-
+        # 1), [MD5](http://wikipedia.org/wiki/MD5), or [crypt](https://en.wikipedia.org/
+        # wiki/Crypt_(C)) hash format.
         # Corresponds to the JSON property `hashFunction`
         # @return [String]
         attr_accessor :hash_function
-        # Unique identifier of User (Read-only)
+        # The unique ID for the user. A user `id` can be used as a user request URI's `
+        # userKey`.
         # Corresponds to the JSON property `id`
         # @return [String]
         attr_accessor :id
-        # User's Instant Messenger
+        # The user's Instant Messenger (IM) accounts. A user account can have multiple
+        # ims properties. But, only one of these ims properties can be the primary IM
+        # contact. The maximum allowed data size for this field is 2Kb.
         # Corresponds to the JSON property `ims`
         # @return [Object]
         attr_accessor :ims
-        # Boolean indicating if user is included in Global Address List
+        # Indicates if the user's profile is visible in the G Suite global address list
+        # when the contact sharing feature is enabled for the domain. For more
+        # information about excluding user profiles, see the [administration help center]
+        # (http://support.google.com/a/bin/answer.py?answer=1285988).
         # Corresponds to the JSON property `includeInGlobalAddressList`
         # @return [Boolean]
         attr_accessor :include_in_global_address_list
         alias_method :include_in_global_address_list?, :include_in_global_address_list
-        # Boolean indicating if ip is whitelisted
+        # If `true`, the user's IP address is [white listed](http://support.google.com/a/
+        # bin/answer.py?answer=60752).
         # Corresponds to the JSON property `ipWhitelisted`
         # @return [Boolean]
         attr_accessor :ip_whitelisted
         alias_method :ip_whitelisted?, :ip_whitelisted
-        # Output only. Boolean indicating if the user is admin (Read-only)
+        # Output only. Indicates a user with super admininistrator privileges. The `
+        # isAdmin` property can only be edited in the [Make a user an administrator](/
+        # admin-sdk/directory/v1/guides/manage-users.html#make_admin) operation ( [
+        # makeAdmin](/admin-sdk/directory/v1/reference/users/makeAdmin.html) method). If
+        # edited in the user [insert](/admin-sdk/directory/v1/reference/users/insert.
+        # html) or [update](/admin-sdk/directory/v1/reference/users/update.html) methods,
+        # the edit is ignored by the API service.
         # Corresponds to the JSON property `isAdmin`
         # @return [Boolean]
         attr_accessor :is_admin
         alias_method :is_admin?, :is_admin
-        # Output only. Boolean indicating if the user is delegated admin (Read-only)
+        # Output only. Indicates if the user is a delegated administrator. Delegated
+        # administrators are supported by the API but cannot create or undelete users,
+        # or make users administrators. These requests are ignored by the API service.
+        # Roles and privileges for administrators are assigned using the [Admin console](
+        # http://support.google.com/a/bin/answer.py?answer=33325).
         # Corresponds to the JSON property `isDelegatedAdmin`
         # @return [Boolean]
         attr_accessor :is_delegated_admin
@@ -3240,23 +3353,25 @@ module Google
         attr_accessor :is_enrolled_in2_sv
         alias_method :is_enrolled_in2_sv?, :is_enrolled_in2_sv
-        # Output only. Is mailbox setup (Read-only)
+        # Output only. Indicates if the user's Google mailbox is created. This property
+        # is only applicable if the user has been assigned a Gmail license.
         # Corresponds to the JSON property `isMailboxSetup`
         # @return [Boolean]
         attr_accessor :is_mailbox_setup
         alias_method :is_mailbox_setup?, :is_mailbox_setup
-        # Keywords of User
+        # The user's keywords. The maximum allowed data size for this field is 1Kb.
         # Corresponds to the JSON property `keywords`
         # @return [Object]
         attr_accessor :keywords
-        # Output only. Kind of resource this is.
+        # Output only. The type of the API resource. For Users resources, the value is `
+        # admin#directory#user`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
-        # Languages of User
+        # The user's languages. The maximum allowed data size for this field is 1Kb.
         # Corresponds to the JSON property `languages`
         # @return [Object]
         attr_accessor :languages
@@ -3266,32 +3381,42 @@ module Google
         # @return [DateTime]
         attr_accessor :last_login_time
-        # Locations of User
+        # The user's locations. The maximum allowed data size for this field is 10Kb.
         # Corresponds to the JSON property `locations`
         # @return [Object]
         attr_accessor :locations
-        # User's name
+        # Holds the given and family names of the user, and the read-only `fullName`
+        # value. The maximum number of characters in the `givenName` and in the `
+        # familyName` values is 60. In addition, name values support unicode/UTF-8
+        # characters, and can contain spaces, letters (a-z), numbers (0-9), dashes (-),
+        # forward slashes (/), and periods (.). For more information about character
+        # usage rules, see the [administration help center](http://support.google.com/a/
+        # bin/answer.py?answer=33386). Maximum allowed data size for this field is 1Kb.
         # Corresponds to the JSON property `name`
         # @return [Google::Apis::AdminDirectoryV1::UserName]
         attr_accessor :name
-        # Output only. List of non editable aliases (Read-only)
+        # Output only. List of the user's non-editable alias email addresses. These are
+        # typically outside the account's primary domain or sub-domain.
         # Corresponds to the JSON property `nonEditableAliases`
         # @return [Array<String>]
         attr_accessor :non_editable_aliases
-        # Notes of User
+        # Notes for the user.
         # Corresponds to the JSON property `notes`
         # @return [Object]
         attr_accessor :notes
-        # OrgUnit of User
+        # The full path of the parent organization associated with the user. If the
+        # parent organization is the top-level, it is represented as a forward slash (`/`
+        # ).
         # Corresponds to the JSON property `orgUnitPath`
         # @return [String]
         attr_accessor :org_unit_path
-        # Organizations of User
+        # A list of organizations the user belongs to. The maximum allowed data size for
+        # this field is 10Kb.
         # Corresponds to the JSON property `organizations`
         # @return [Object]
         attr_accessor :organizations
@@ -3301,17 +3426,21 @@ module Google
         # @return [String]
         attr_accessor :password
-        # Phone numbers of User
+        # A list of the user's phone numbers. The maximum allowed data size for this
+        # field is 1Kb.
         # Corresponds to the JSON property `phones`
         # @return [Object]
         attr_accessor :phones
-        # The POSIX accounts of User
+        # A list of [POSIX](http://www.opengroup.org/austin/papers/posix_faq.html)
+        # account information for the user.
         # Corresponds to the JSON property `posixAccounts`
         # @return [Object]
         attr_accessor :posix_accounts
-        # username of User
+        # The user's primary email address. This property is required in a request to
+        # create a user account. The `primaryEmail` must be unique and cannot be an
+        # alias of another user.
         # Corresponds to the JSON property `primaryEmail`
         # @return [String]
         attr_accessor :primary_email
@@ -3327,12 +3456,13 @@ module Google
         # @return [String]
         attr_accessor :recovery_phone
-        # The Relations of User *
+        # A list of the user's relationships to other users. The maximum allowed data
+        # size for this field is 2Kb.
         # Corresponds to the JSON property `relations`
         # @return [Object]
         attr_accessor :relations
-        # The SSH public keys of User
+        # A list of SSH public keys.
         # Corresponds to the JSON property `sshPublicKeys`
         # @return [Object]
         attr_accessor :ssh_public_keys
@@ -3343,7 +3473,9 @@ module Google
         attr_accessor :suspended
         alias_method :suspended?, :suspended
-        # Output only. Suspension reason if user is suspended (Read-only)
+        # Output only. Has the reason a user account is suspended either by the
+        # administrator or by Google at the time of suspension. The property is returned
+        # only if the `suspended` property is `true`.
         # Corresponds to the JSON property `suspensionReason`
         # @return [String]
         attr_accessor :suspension_reason
@@ -3358,7 +3490,7 @@ module Google
         # @return [String]
         attr_accessor :thumbnail_photo_url
-        # Websites of User
+        # The user's websites. The maximum allowed data size for this field is 2Kb.
         # Corresponds to the JSON property `websites`
         # @return [Object]
         attr_accessor :websites
@@ -3829,7 +3961,7 @@ module Google
       class UserMakeAdmin
         include Google::Apis::Core::Hashable
-        # Boolean indicating new admin status of the user
+        # Indicates the administrator status of the user.
         # Corresponds to the JSON property `status`
         # @return [Boolean]
         attr_accessor :status
@@ -3849,17 +3981,17 @@ module Google
       class UserName
         include Google::Apis::Core::Hashable
-        # Last Name
+        # The user's last name. Required when creating a user account.
         # Corresponds to the JSON property `familyName`
         # @return [String]
         attr_accessor :family_name
-        # Full Name
+        # The user's full name formed by concatenating the first and last name values.
         # Corresponds to the JSON property `fullName`
         # @return [String]
         attr_accessor :full_name
-        # First Name
+        # The user's first name. Required when creating a user account.
         # Corresponds to the JSON property `givenName`
         # @return [String]
         attr_accessor :given_name
@@ -4006,9 +4138,7 @@ module Google
         end
       end
-      # STEPLADDER: Generated unstable field number for field 'kind'. (See http://go/
-      # stepladder-help#fieldNumber) STEPLADDER: Generated unstable field number for
-      # field 'etag'. (See http://go/stepladder-help#fieldNumber)
+      #
       class UserPhoto
         include Google::Apis::Core::Hashable
@@ -4017,38 +4147,47 @@ module Google
         # @return [String]
         attr_accessor :etag
-        # Height in pixels of the photo
+        # Height of the photo in pixels.
         # Corresponds to the JSON property `height`
         # @return [Fixnum]
         attr_accessor :height
-        # Unique identifier of User (Read-only)
+        # The ID the API uses to uniquely identify the user.
         # Corresponds to the JSON property `id`
         # @return [String]
         attr_accessor :id
-        # Kind of resource this is.
+        # The type of the API resource. For Photo resources, this is `admin#directory#
+        # user#photo`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
-        # Mime Type of the photo
+        # The MIME type of the photo. Allowed values are `JPEG`, `PNG`, `GIF`, `BMP`, `
+        # TIFF`, and web-safe base64 encoding.
         # Corresponds to the JSON property `mimeType`
         # @return [String]
         attr_accessor :mime_type
-        # Base64 encoded photo data
+        # The user photo's upload data in [web-safe Base64](https://code.google.com/p/
+        # stringencoders/wiki/WebSafeBase64) format in bytes. This means: * The slash (/)
+        # character is replaced with the underscore (_) character. * The plus sign (+)
+        # character is replaced with the hyphen (-) character. * The equals sign (=)
+        # character is replaced with the asterisk (*). * For padding, the period (.)
+        # character is used instead of the RFC-4648 baseURL definition which uses the
+        # equals sign (=) for padding. This is done to simplify URL-parsing. * Whatever
+        # the size of the photo being uploaded, the API downsizes it to 96x96 pixels.
         # Corresponds to the JSON property `photoData`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
         attr_accessor :photo_data
-        # Primary email of User (Read-only)
+        # The user's primary email address.
         # Corresponds to the JSON property `primaryEmail`
         # @return [String]
         attr_accessor :primary_email
-        # Width in pixels of the photo
+        # Width of the photo in pixels.
         # Corresponds to the JSON property `width`
         # @return [Fixnum]
         attr_accessor :width
@@ -4070,8 +4209,7 @@ module Google
         end
       end
-      # JSON template for a POSIX account entry. Description of the field family: go/
-      # fbs-posix.
+      # JSON template for a POSIX account entry.
       class UserPosixAccount
         include Google::Apis::Core::Hashable
@@ -4268,9 +4406,7 @@ module Google
         end
       end
-      # STEPLADDER: Generated unstable field number for field 'kind'. (See http://go/
-      # stepladder-help#fieldNumber) STEPLADDER: Generated unstable field number for
-      # field 'etag'. (See http://go/stepladder-help#fieldNumber)
+      #
       class Users
         include Google::Apis::Core::Hashable
@@ -4313,10 +4449,8 @@ module Google
         end
       end
-      # JSON template for verification codes in Directory API. STEPLADDER: Generated
-      # unstable field number for field 'kind'. (See http://go/stepladder-help#
-      # fieldNumber) STEPLADDER: Generated unstable field number for field 'etag'. (
-      # See http://go/stepladder-help#fieldNumber)
+      # The Directory API allows you to view, generate, and invalidate backup
+      # verification codes for a user.
       class VerificationCode
         include Google::Apis::Core::Hashable
@@ -4325,7 +4459,7 @@ module Google
         # @return [String]
         attr_accessor :etag
-        # The type of the resource. This is always admin#directory#verificationCode.
+        # The type of the resource. This is always `admin#directory#verificationCode`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -4355,9 +4489,6 @@ module Google
       end
       # JSON response template for List verification codes operation in Directory API.
-      # STEPLADDER: Generated unstable field number for field 'kind'. (See http://go/
-      # stepladder-help#fieldNumber) STEPLADDER: Generated unstable field number for
-      # field 'etag'. (See http://go/stepladder-help#fieldNumber)
       class VerificationCodes
         include Google::Apis::Core::Hashable
@@ -4371,7 +4502,8 @@ module Google
         # @return [Array<Google::Apis::AdminDirectoryV1::VerificationCode>]
         attr_accessor :items
-        # The type of the resource. This is always admin#directory#verificationCodesList.
+        # The type of the resource. This is always `admin#directory#
+        # verificationCodesList`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind