From bcacb792b10bc311ea18469d2a0392b296ca1fab Mon Sep 17 00:00:00 2001 From: OMGeeky Date: Sat, 21 Oct 2023 02:11:31 +0200 Subject: [PATCH] make regen-apis --- gen/abusiveexperiencereport1/README.md | 34 +++++++------- gen/abusiveexperiencereport1/src/api.rs | 6 +-- gen/abusiveexperiencereport1/src/lib.rs | 32 ++++++------- gen/acceleratedmobilepageurl1/README.md | 34 +++++++------- gen/acceleratedmobilepageurl1/src/api.rs | 6 +-- gen/acceleratedmobilepageurl1/src/lib.rs | 32 ++++++------- gen/accessapproval1/README.md | 34 +++++++------- gen/accessapproval1/src/api.rs | 8 ++-- gen/accessapproval1/src/lib.rs | 32 ++++++------- gen/accessapproval1_beta1/README.md | 34 +++++++------- gen/accessapproval1_beta1/src/api.rs | 8 ++-- gen/accessapproval1_beta1/src/lib.rs | 32 ++++++------- gen/accesscontextmanager1/README.md | 34 +++++++------- gen/accesscontextmanager1/src/api.rs | 8 ++-- gen/accesscontextmanager1/src/lib.rs | 32 ++++++------- gen/accesscontextmanager1_beta/README.md | 34 +++++++------- gen/accesscontextmanager1_beta/src/api.rs | 8 ++-- gen/accesscontextmanager1_beta/src/lib.rs | 32 ++++++------- gen/adexchangebuyer1d3/README.md | 34 +++++++------- gen/adexchangebuyer1d3/src/api.rs | 8 ++-- gen/adexchangebuyer1d3/src/lib.rs | 32 ++++++------- gen/adexchangebuyer1d4/README.md | 34 +++++++------- gen/adexchangebuyer1d4/src/api.rs | 8 ++-- gen/adexchangebuyer1d4/src/lib.rs | 32 ++++++------- gen/adexchangebuyer2_v2_beta1/README.md | 34 +++++++------- gen/adexchangebuyer2_v2_beta1/src/api.rs | 8 ++-- gen/adexchangebuyer2_v2_beta1/src/lib.rs | 32 ++++++------- gen/adexchangeseller2/README.md | 34 +++++++------- gen/adexchangeseller2/src/api.rs | 8 ++-- gen/adexchangeseller2/src/lib.rs | 32 ++++++------- gen/adexperiencereport1/README.md | 34 +++++++------- gen/adexperiencereport1/src/api.rs | 6 +-- gen/adexperiencereport1/src/lib.rs | 32 ++++++------- gen/admob1/README.md | 34 +++++++------- gen/admob1/src/api.rs | 8 ++-- gen/admob1/src/lib.rs | 32 ++++++------- gen/adsense1d4/README.md | 34 +++++++------- gen/adsense1d4/src/api.rs | 8 ++-- gen/adsense1d4/src/lib.rs | 32 ++++++------- gen/adsense2/README.md | 34 +++++++------- gen/adsense2/src/api.rs | 8 ++-- gen/adsense2/src/lib.rs | 32 ++++++------- gen/adsensehost4d1/README.md | 34 +++++++------- gen/adsensehost4d1/src/api.rs | 8 ++-- gen/adsensehost4d1/src/lib.rs | 32 ++++++------- gen/alertcenter1_beta1/README.md | 34 +++++++------- gen/alertcenter1_beta1/src/api.rs | 8 ++-- gen/alertcenter1_beta1/src/lib.rs | 32 ++++++------- gen/analytics3/README.md | 34 +++++++------- gen/analytics3/src/api.rs | 8 ++-- gen/analytics3/src/lib.rs | 32 ++++++------- gen/analyticsadmin1_alpha/README.md | 34 +++++++------- gen/analyticsadmin1_alpha/src/api.rs | 8 ++-- gen/analyticsadmin1_alpha/src/lib.rs | 32 ++++++------- gen/analyticsdata1_beta/README.md | 34 +++++++------- gen/analyticsdata1_beta/src/api.rs | 8 ++-- gen/analyticsdata1_beta/src/lib.rs | 32 ++++++------- gen/analyticsreporting4/README.md | 34 +++++++------- gen/analyticsreporting4/src/api.rs | 8 ++-- gen/analyticsreporting4/src/lib.rs | 32 ++++++------- gen/androiddeviceprovisioning1/README.md | 34 +++++++------- gen/androiddeviceprovisioning1/src/api.rs | 6 +-- gen/androiddeviceprovisioning1/src/lib.rs | 32 ++++++------- gen/androidenterprise1/README.md | 34 +++++++------- gen/androidenterprise1/src/api.rs | 8 ++-- gen/androidenterprise1/src/lib.rs | 32 ++++++------- gen/androidmanagement1/README.md | 34 +++++++------- gen/androidmanagement1/src/api.rs | 8 ++-- gen/androidmanagement1/src/lib.rs | 32 ++++++------- gen/androidpublisher2/README.md | 34 +++++++------- gen/androidpublisher2/src/api.rs | 8 ++-- gen/androidpublisher2/src/lib.rs | 32 ++++++------- gen/androidpublisher3/README.md | 34 +++++++------- gen/androidpublisher3/src/api.rs | 8 ++-- gen/androidpublisher3/src/lib.rs | 32 ++++++------- gen/apigateway1/README.md | 34 +++++++------- gen/apigateway1/src/api.rs | 8 ++-- gen/apigateway1/src/lib.rs | 32 ++++++------- gen/apigee1/README.md | 34 +++++++------- gen/apigee1/src/api.rs | 8 ++-- gen/apigee1/src/lib.rs | 32 ++++++------- gen/apikeys2/README.md | 34 +++++++------- gen/apikeys2/src/api.rs | 8 ++-- gen/apikeys2/src/lib.rs | 32 ++++++------- gen/appengine1/README.md | 34 +++++++------- gen/appengine1/src/api.rs | 8 ++-- gen/appengine1/src/lib.rs | 32 ++++++------- gen/appengine1_beta4/README.md | 34 +++++++------- gen/appengine1_beta4/src/api.rs | 8 ++-- gen/appengine1_beta4/src/lib.rs | 32 ++++++------- gen/appengine1_beta5/README.md | 34 +++++++------- gen/appengine1_beta5/src/api.rs | 8 ++-- gen/appengine1_beta5/src/lib.rs | 32 ++++++------- gen/appsactivity1/README.md | 34 +++++++------- gen/appsactivity1/src/api.rs | 8 ++-- gen/appsactivity1/src/lib.rs | 32 ++++++------- gen/appstate1/README.md | 34 +++++++------- gen/appstate1/src/api.rs | 8 ++-- gen/appstate1/src/lib.rs | 32 ++++++------- gen/area120tables1_alpha1/README.md | 34 +++++++------- gen/area120tables1_alpha1/src/api.rs | 8 ++-- gen/area120tables1_alpha1/src/lib.rs | 32 ++++++------- gen/artifactregistry1/README.md | 34 +++++++------- gen/artifactregistry1/src/api.rs | 8 ++-- gen/artifactregistry1/src/lib.rs | 32 ++++++------- gen/artifactregistry1_beta1/README.md | 34 +++++++------- gen/artifactregistry1_beta1/src/api.rs | 8 ++-- gen/artifactregistry1_beta1/src/lib.rs | 32 ++++++------- gen/assuredworkloads1/README.md | 34 +++++++------- gen/assuredworkloads1/src/api.rs | 8 ++-- gen/assuredworkloads1/src/lib.rs | 32 ++++++------- gen/authorizedbuyersmarketplace1/README.md | 34 +++++++------- gen/authorizedbuyersmarketplace1/src/api.rs | 8 ++-- gen/authorizedbuyersmarketplace1/src/lib.rs | 32 ++++++------- gen/autoscaler1_beta2/README.md | 34 +++++++------- gen/autoscaler1_beta2/src/api.rs | 8 ++-- gen/autoscaler1_beta2/src/lib.rs | 32 ++++++------- gen/baremetalsolution2/README.md | 34 +++++++------- gen/baremetalsolution2/src/api.rs | 8 ++-- gen/baremetalsolution2/src/lib.rs | 32 ++++++------- gen/bigquery2/README.md | 34 +++++++------- gen/bigquery2/src/api.rs | 8 ++-- gen/bigquery2/src/lib.rs | 32 ++++++------- gen/bigqueryconnection1_beta1/README.md | 34 +++++++------- gen/bigqueryconnection1_beta1/src/api.rs | 8 ++-- gen/bigqueryconnection1_beta1/src/lib.rs | 32 ++++++------- gen/bigquerydatatransfer1/README.md | 34 +++++++------- gen/bigquerydatatransfer1/src/api.rs | 8 ++-- gen/bigquerydatatransfer1/src/lib.rs | 32 ++++++------- gen/bigqueryreservation1/README.md | 34 +++++++------- gen/bigqueryreservation1/src/api.rs | 8 ++-- gen/bigqueryreservation1/src/lib.rs | 32 ++++++------- gen/bigtableadmin2/README.md | 34 +++++++------- gen/bigtableadmin2/src/api.rs | 8 ++-- gen/bigtableadmin2/src/lib.rs | 32 ++++++------- gen/billingbudgets1/README.md | 34 +++++++------- gen/billingbudgets1/src/api.rs | 8 ++-- gen/billingbudgets1/src/lib.rs | 32 ++++++------- gen/billingbudgets1_beta1/README.md | 34 +++++++------- gen/billingbudgets1_beta1/src/api.rs | 8 ++-- gen/billingbudgets1_beta1/src/lib.rs | 32 ++++++------- gen/binaryauthorization1/README.md | 34 +++++++------- gen/binaryauthorization1/src/api.rs | 8 ++-- gen/binaryauthorization1/src/lib.rs | 32 ++++++------- gen/binaryauthorization1_beta1/README.md | 34 +++++++------- gen/binaryauthorization1_beta1/src/api.rs | 8 ++-- gen/binaryauthorization1_beta1/src/lib.rs | 32 ++++++------- gen/blogger3/README.md | 34 +++++++------- gen/blogger3/src/api.rs | 8 ++-- gen/blogger3/src/lib.rs | 32 ++++++------- gen/books1/README.md | 34 +++++++------- gen/books1/src/api.rs | 8 ++-- gen/books1/src/lib.rs | 32 ++++++------- gen/calendar3/README.md | 34 +++++++------- gen/calendar3/src/api.rs | 8 ++-- gen/calendar3/src/lib.rs | 32 ++++++------- gen/certificatemanager1/README.md | 34 +++++++------- gen/certificatemanager1/src/api.rs | 8 ++-- gen/certificatemanager1/src/lib.rs | 32 ++++++------- gen/chromemanagement1/README.md | 34 +++++++------- gen/chromemanagement1/src/api.rs | 8 ++-- gen/chromemanagement1/src/lib.rs | 32 ++++++------- gen/chromepolicy1/README.md | 34 +++++++------- gen/chromepolicy1/src/api.rs | 8 ++-- gen/chromepolicy1/src/lib.rs | 32 ++++++------- gen/chromeuxreport1/README.md | 34 +++++++------- gen/chromeuxreport1/src/api.rs | 6 +-- gen/chromeuxreport1/src/lib.rs | 32 ++++++------- gen/classroom1/README.md | 34 +++++++------- gen/classroom1/src/api.rs | 8 ++-- gen/classroom1/src/lib.rs | 32 ++++++------- gen/cloudasset1/README.md | 34 +++++++------- gen/cloudasset1/src/api.rs | 8 ++-- gen/cloudasset1/src/lib.rs | 32 ++++++------- gen/cloudasset1_beta1/README.md | 34 +++++++------- gen/cloudasset1_beta1/src/api.rs | 8 ++-- gen/cloudasset1_beta1/src/lib.rs | 32 ++++++------- gen/cloudbilling1/README.md | 34 +++++++------- gen/cloudbilling1/src/api.rs | 8 ++-- gen/cloudbilling1/src/lib.rs | 32 ++++++------- gen/cloudbuild1/README.md | 34 +++++++------- gen/cloudbuild1/src/api.rs | 8 ++-- gen/cloudbuild1/src/lib.rs | 32 ++++++------- gen/cloudchannel1/README.md | 34 +++++++------- gen/cloudchannel1/src/api.rs | 8 ++-- gen/cloudchannel1/src/lib.rs | 32 ++++++------- gen/clouddebugger2/README.md | 34 +++++++------- gen/clouddebugger2/src/api.rs | 8 ++-- gen/clouddebugger2/src/lib.rs | 32 ++++++------- gen/clouddeploy1/README.md | 34 +++++++------- gen/clouddeploy1/src/api.rs | 8 ++-- gen/clouddeploy1/src/lib.rs | 32 ++++++------- gen/clouderrorreporting1_beta1/README.md | 34 +++++++------- gen/clouderrorreporting1_beta1/src/api.rs | 8 ++-- gen/clouderrorreporting1_beta1/src/lib.rs | 32 ++++++------- gen/cloudfunctions1/README.md | 34 +++++++------- gen/cloudfunctions1/src/api.rs | 8 ++-- gen/cloudfunctions1/src/lib.rs | 32 ++++++------- gen/cloudidentity1/README.md | 34 +++++++------- gen/cloudidentity1/src/api.rs | 8 ++-- gen/cloudidentity1/src/lib.rs | 32 ++++++------- gen/cloudiot1/README.md | 34 +++++++------- gen/cloudiot1/src/api.rs | 8 ++-- gen/cloudiot1/src/lib.rs | 32 ++++++------- gen/cloudkms1/README.md | 34 +++++++------- gen/cloudkms1/src/api.rs | 8 ++-- gen/cloudkms1/src/lib.rs | 32 ++++++------- gen/cloudkms1_beta1/README.md | 34 +++++++------- gen/cloudkms1_beta1/src/api.rs | 8 ++-- gen/cloudkms1_beta1/src/lib.rs | 32 ++++++------- gen/cloudlatencytest2/README.md | 34 +++++++------- gen/cloudlatencytest2/src/api.rs | 8 ++-- gen/cloudlatencytest2/src/lib.rs | 32 ++++++------- gen/cloudmonitoring2_beta2/README.md | 34 +++++++------- gen/cloudmonitoring2_beta2/src/api.rs | 8 ++-- gen/cloudmonitoring2_beta2/src/lib.rs | 32 ++++++------- gen/cloudprivatecatalog1_beta1/README.md | 34 +++++++------- gen/cloudprivatecatalog1_beta1/src/api.rs | 8 ++-- gen/cloudprivatecatalog1_beta1/src/lib.rs | 32 ++++++------- .../README.md | 34 +++++++------- .../src/api.rs | 8 ++-- .../src/lib.rs | 32 ++++++------- gen/cloudprofiler2/README.md | 34 +++++++------- gen/cloudprofiler2/src/api.rs | 8 ++-- gen/cloudprofiler2/src/lib.rs | 32 ++++++------- gen/cloudresourcemanager1/README.md | 34 +++++++------- gen/cloudresourcemanager1/src/api.rs | 8 ++-- gen/cloudresourcemanager1/src/lib.rs | 32 ++++++------- gen/cloudresourcemanager1_beta1/README.md | 34 +++++++------- gen/cloudresourcemanager1_beta1/src/api.rs | 8 ++-- gen/cloudresourcemanager1_beta1/src/lib.rs | 32 ++++++------- gen/cloudresourcemanager2/README.md | 34 +++++++------- gen/cloudresourcemanager2/src/api.rs | 8 ++-- gen/cloudresourcemanager2/src/lib.rs | 32 ++++++------- gen/cloudresourcemanager3/README.md | 34 +++++++------- gen/cloudresourcemanager3/src/api.rs | 8 ++-- gen/cloudresourcemanager3/src/lib.rs | 32 ++++++------- gen/cloudscheduler1/README.md | 34 +++++++------- gen/cloudscheduler1/src/api.rs | 8 ++-- gen/cloudscheduler1/src/lib.rs | 32 ++++++------- gen/cloudscheduler1_beta1/README.md | 34 +++++++------- gen/cloudscheduler1_beta1/src/api.rs | 8 ++-- gen/cloudscheduler1_beta1/src/lib.rs | 32 ++++++------- gen/cloudshell1/README.md | 34 +++++++------- gen/cloudshell1/src/api.rs | 8 ++-- gen/cloudshell1/src/lib.rs | 32 ++++++------- gen/cloudsupport2_beta/README.md | 34 +++++++------- gen/cloudsupport2_beta/src/api.rs | 8 ++-- gen/cloudsupport2_beta/src/lib.rs | 32 ++++++------- gen/cloudtasks2/README.md | 34 +++++++------- gen/cloudtasks2/src/api.rs | 8 ++-- gen/cloudtasks2/src/lib.rs | 32 ++++++------- gen/cloudtasks2_beta2/README.md | 34 +++++++------- gen/cloudtasks2_beta2/src/api.rs | 8 ++-- gen/cloudtasks2_beta2/src/lib.rs | 32 ++++++------- gen/cloudtasks2_beta3/README.md | 34 +++++++------- gen/cloudtasks2_beta3/src/api.rs | 8 ++-- gen/cloudtasks2_beta3/src/lib.rs | 32 ++++++------- gen/cloudtrace1/README.md | 34 +++++++------- gen/cloudtrace1/src/api.rs | 8 ++-- gen/cloudtrace1/src/lib.rs | 32 ++++++------- gen/cloudtrace2/README.md | 34 +++++++------- gen/cloudtrace2/src/api.rs | 8 ++-- gen/cloudtrace2/src/lib.rs | 32 ++++++------- gen/clouduseraccountsvm_beta/README.md | 34 +++++++------- gen/clouduseraccountsvm_beta/src/api.rs | 8 ++-- gen/clouduseraccountsvm_beta/src/lib.rs | 32 ++++++------- gen/commentanalyzer1_alpha1/README.md | 34 +++++++------- gen/commentanalyzer1_alpha1/src/api.rs | 8 ++-- gen/commentanalyzer1_alpha1/src/lib.rs | 32 ++++++------- gen/composer1/README.md | 34 +++++++------- gen/composer1/src/api.rs | 8 ++-- gen/composer1/src/lib.rs | 32 ++++++------- gen/compute1/README.md | 34 +++++++------- gen/compute1/src/api.rs | 8 ++-- gen/compute1/src/lib.rs | 32 ++++++------- gen/connectors1/README.md | 34 +++++++------- gen/connectors1/src/api.rs | 8 ++-- gen/connectors1/src/lib.rs | 32 ++++++------- gen/consumersurveys2/README.md | 34 +++++++------- gen/consumersurveys2/src/api.rs | 8 ++-- gen/consumersurveys2/src/lib.rs | 32 ++++++------- gen/contactcenterinsights1/README.md | 34 +++++++------- gen/contactcenterinsights1/src/api.rs | 8 ++-- gen/contactcenterinsights1/src/lib.rs | 32 ++++++------- gen/container1/README.md | 34 +++++++------- gen/container1/src/api.rs | 8 ++-- gen/container1/src/lib.rs | 32 ++++++------- gen/containeranalysis1/README.md | 34 +++++++------- gen/containeranalysis1/src/api.rs | 8 ++-- gen/containeranalysis1/src/lib.rs | 32 ++++++------- gen/containeranalysis1_beta1/README.md | 34 +++++++------- gen/containeranalysis1_beta1/src/api.rs | 8 ++-- gen/containeranalysis1_beta1/src/lib.rs | 32 ++++++------- gen/content2/README.md | 34 +++++++------- gen/content2/src/api.rs | 8 ++-- gen/content2/src/lib.rs | 32 ++++++------- gen/content2_sandbox/README.md | 34 +++++++------- gen/content2_sandbox/src/api.rs | 8 ++-- gen/content2_sandbox/src/lib.rs | 32 ++++++------- gen/coordinate1/README.md | 34 +++++++------- gen/coordinate1/src/api.rs | 8 ++-- gen/coordinate1/src/lib.rs | 32 ++++++------- gen/customsearch1/README.md | 34 +++++++------- gen/customsearch1/src/api.rs | 6 +-- gen/customsearch1/src/lib.rs | 32 ++++++------- gen/datacatalog1/README.md | 34 +++++++------- gen/datacatalog1/src/api.rs | 8 ++-- gen/datacatalog1/src/lib.rs | 32 ++++++------- gen/datacatalog1_beta1/README.md | 34 +++++++------- gen/datacatalog1_beta1/src/api.rs | 8 ++-- gen/datacatalog1_beta1/src/lib.rs | 32 ++++++------- gen/datafusion1/README.md | 34 +++++++------- gen/datafusion1/src/api.rs | 8 ++-- gen/datafusion1/src/lib.rs | 32 ++++++------- gen/datafusion1_beta1/README.md | 34 +++++++------- gen/datafusion1_beta1/src/api.rs | 8 ++-- gen/datafusion1_beta1/src/lib.rs | 32 ++++++------- gen/datalabeling1_beta1/README.md | 34 +++++++------- gen/datalabeling1_beta1/src/api.rs | 8 ++-- gen/datalabeling1_beta1/src/lib.rs | 32 ++++++------- gen/datamigration1/README.md | 34 +++++++------- gen/datamigration1/src/api.rs | 8 ++-- gen/datamigration1/src/lib.rs | 32 ++++++------- gen/datapipelines1/README.md | 34 +++++++------- gen/datapipelines1/src/api.rs | 8 ++-- gen/datapipelines1/src/lib.rs | 32 ++++++------- gen/dataplex1/README.md | 34 +++++++------- gen/dataplex1/src/api.rs | 8 ++-- gen/dataplex1/src/lib.rs | 32 ++++++------- gen/dataproc1/README.md | 34 +++++++------- gen/dataproc1/src/api.rs | 8 ++-- gen/dataproc1/src/lib.rs | 32 ++++++------- gen/datastore1/README.md | 34 +++++++------- gen/datastore1/src/api.rs | 8 ++-- gen/datastore1/src/lib.rs | 32 ++++++------- gen/datastore1_beta3/README.md | 34 +++++++------- gen/datastore1_beta3/src/api.rs | 8 ++-- gen/datastore1_beta3/src/lib.rs | 32 ++++++------- gen/datastream1/README.md | 34 +++++++------- gen/datastream1/src/api.rs | 8 ++-- gen/datastream1/src/lib.rs | 32 ++++++------- gen/deploymentmanager2/README.md | 34 +++++++------- gen/deploymentmanager2/src/api.rs | 8 ++-- gen/deploymentmanager2/src/lib.rs | 32 ++++++------- gen/deploymentmanager2_beta2/README.md | 34 +++++++------- gen/deploymentmanager2_beta2/src/api.rs | 8 ++-- gen/deploymentmanager2_beta2/src/lib.rs | 32 ++++++------- gen/dfareporting2d8/README.md | 34 +++++++------- gen/dfareporting2d8/src/api.rs | 8 ++-- gen/dfareporting2d8/src/lib.rs | 32 ++++++------- gen/dfareporting3/README.md | 34 +++++++------- gen/dfareporting3/src/api.rs | 8 ++-- gen/dfareporting3/src/lib.rs | 32 ++++++------- gen/dfareporting3d2/README.md | 34 +++++++------- gen/dfareporting3d2/src/api.rs | 8 ++-- gen/dfareporting3d2/src/lib.rs | 32 ++++++------- gen/dfareporting3d3/README.md | 34 +++++++------- gen/dfareporting3d3/src/api.rs | 8 ++-- gen/dfareporting3d3/src/lib.rs | 32 ++++++------- gen/dfareporting3d4/README.md | 34 +++++++------- gen/dfareporting3d4/src/api.rs | 8 ++-- gen/dfareporting3d4/src/lib.rs | 32 ++++++------- gen/dfareporting3d5/README.md | 34 +++++++------- gen/dfareporting3d5/src/api.rs | 8 ++-- gen/dfareporting3d5/src/lib.rs | 32 ++++++------- gen/dialogflow2/README.md | 34 +++++++------- gen/dialogflow2/src/api.rs | 8 ++-- gen/dialogflow2/src/lib.rs | 32 ++++++------- gen/dialogflow2_beta1/README.md | 34 +++++++------- gen/dialogflow2_beta1/src/api.rs | 8 ++-- gen/dialogflow2_beta1/src/lib.rs | 32 ++++++------- gen/dialogflow3/README.md | 34 +++++++------- gen/dialogflow3/src/api.rs | 8 ++-- gen/dialogflow3/src/lib.rs | 32 ++++++------- gen/digitalassetlinks1/README.md | 34 +++++++------- gen/digitalassetlinks1/src/api.rs | 6 +-- gen/digitalassetlinks1/src/lib.rs | 32 ++++++------- gen/discovery1/README.md | 34 +++++++------- gen/discovery1/src/api.rs | 6 +-- gen/discovery1/src/lib.rs | 32 ++++++------- gen/displayvideo1/README.md | 34 +++++++------- gen/displayvideo1/src/api.rs | 8 ++-- gen/displayvideo1/src/lib.rs | 32 ++++++------- gen/dlp2/README.md | 34 +++++++------- gen/dlp2/src/api.rs | 8 ++-- gen/dlp2/src/lib.rs | 32 ++++++------- gen/dlp2_beta1/README.md | 34 +++++++------- gen/dlp2_beta1/src/api.rs | 8 ++-- gen/dlp2_beta1/src/lib.rs | 32 ++++++------- gen/dns1/README.md | 34 +++++++------- gen/dns1/src/api.rs | 8 ++-- gen/dns1/src/lib.rs | 32 ++++++------- gen/dns2/README.md | 34 +++++++------- gen/dns2/src/api.rs | 8 ++-- gen/dns2/src/lib.rs | 32 ++++++------- gen/docs1/README.md | 34 +++++++------- gen/docs1/src/api.rs | 8 ++-- gen/docs1/src/lib.rs | 32 ++++++------- gen/documentai1/README.md | 34 +++++++------- gen/documentai1/src/api.rs | 8 ++-- gen/documentai1/src/lib.rs | 32 ++++++------- gen/documentai1_beta2/README.md | 34 +++++++------- gen/documentai1_beta2/src/api.rs | 8 ++-- gen/documentai1_beta2/src/lib.rs | 32 ++++++------- gen/domains1/README.md | 34 +++++++------- gen/domains1/src/api.rs | 8 ++-- gen/domains1/src/lib.rs | 32 ++++++------- gen/domains1_beta1/README.md | 34 +++++++------- gen/domains1_beta1/src/api.rs | 8 ++-- gen/domains1_beta1/src/lib.rs | 32 ++++++------- gen/domainsrdap1/README.md | 34 +++++++------- gen/domainsrdap1/src/api.rs | 6 +-- gen/domainsrdap1/src/lib.rs | 32 ++++++------- gen/doubleclickbidmanager1/README.md | 34 +++++++------- gen/doubleclickbidmanager1/src/api.rs | 8 ++-- gen/doubleclickbidmanager1/src/lib.rs | 32 ++++++------- gen/doubleclickbidmanager1d1/README.md | 34 +++++++------- gen/doubleclickbidmanager1d1/src/api.rs | 8 ++-- gen/doubleclickbidmanager1d1/src/lib.rs | 32 ++++++------- gen/doubleclicksearch2/README.md | 34 +++++++------- gen/doubleclicksearch2/src/api.rs | 8 ++-- gen/doubleclicksearch2/src/lib.rs | 32 ++++++------- gen/drive2/README.md | 34 +++++++------- gen/drive2/src/api.rs | 8 ++-- gen/drive2/src/lib.rs | 32 ++++++------- gen/drive3/README.md | 34 +++++++------- gen/drive3/src/api.rs | 8 ++-- gen/drive3/src/lib.rs | 32 ++++++------- gen/driveactivity2/README.md | 34 +++++++------- gen/driveactivity2/src/api.rs | 8 ++-- gen/driveactivity2/src/lib.rs | 32 ++++++------- gen/essentialcontacts1/README.md | 34 +++++++------- gen/essentialcontacts1/src/api.rs | 8 ++-- gen/essentialcontacts1/src/lib.rs | 32 ++++++------- gen/eventarc1/README.md | 34 +++++++------- gen/eventarc1/src/api.rs | 8 ++-- gen/eventarc1/src/lib.rs | 32 ++++++------- gen/factchecktools1_alpha1/README.md | 34 +++++++------- gen/factchecktools1_alpha1/src/api.rs | 8 ++-- gen/factchecktools1_alpha1/src/lib.rs | 32 ++++++------- gen/fcm1/README.md | 34 +++++++------- gen/fcm1/src/api.rs | 8 ++-- gen/fcm1/src/lib.rs | 32 ++++++------- gen/fcmdata1_beta1/README.md | 34 +++++++------- gen/fcmdata1_beta1/src/api.rs | 8 ++-- gen/fcmdata1_beta1/src/lib.rs | 32 ++++++------- gen/file1/README.md | 34 +++++++------- gen/file1/src/api.rs | 8 ++-- gen/file1/src/lib.rs | 32 ++++++------- gen/file1_beta1/README.md | 34 +++++++------- gen/file1_beta1/src/api.rs | 8 ++-- gen/file1_beta1/src/lib.rs | 32 ++++++------- gen/firebase1_beta1/README.md | 34 +++++++------- gen/firebase1_beta1/src/api.rs | 8 ++-- gen/firebase1_beta1/src/lib.rs | 32 ++++++------- gen/firebaseappcheck1_beta/README.md | 34 +++++++------- gen/firebaseappcheck1_beta/src/api.rs | 8 ++-- gen/firebaseappcheck1_beta/src/lib.rs | 32 ++++++------- gen/firebasedatabase1_beta/README.md | 34 +++++++------- gen/firebasedatabase1_beta/src/api.rs | 8 ++-- gen/firebasedatabase1_beta/src/lib.rs | 32 ++++++------- gen/firebasedynamiclinks1/README.md | 34 +++++++------- gen/firebasedynamiclinks1/src/api.rs | 8 ++-- gen/firebasedynamiclinks1/src/lib.rs | 32 ++++++------- gen/firebasehosting1/README.md | 34 +++++++------- gen/firebasehosting1/src/api.rs | 6 +-- gen/firebasehosting1/src/lib.rs | 32 ++++++------- gen/firebasehosting1_beta1/README.md | 34 +++++++------- gen/firebasehosting1_beta1/src/api.rs | 8 ++-- gen/firebasehosting1_beta1/src/lib.rs | 32 ++++++------- gen/firebaseml1/README.md | 34 +++++++------- gen/firebaseml1/src/api.rs | 8 ++-- gen/firebaseml1/src/lib.rs | 32 ++++++------- gen/firebaseremoteconfig1/README.md | 34 +++++++------- gen/firebaseremoteconfig1/src/api.rs | 6 +-- gen/firebaseremoteconfig1/src/lib.rs | 32 ++++++------- gen/firebasestorage1_beta/README.md | 34 +++++++------- gen/firebasestorage1_beta/src/api.rs | 8 ++-- gen/firebasestorage1_beta/src/lib.rs | 32 ++++++------- gen/firestore1/README.md | 34 +++++++------- gen/firestore1/src/api.rs | 8 ++-- gen/firestore1/src/lib.rs | 32 ++++++------- gen/firestore1_beta1/README.md | 34 +++++++------- gen/firestore1_beta1/src/api.rs | 8 ++-- gen/firestore1_beta1/src/lib.rs | 32 ++++++------- gen/fitness1/README.md | 34 +++++++------- gen/fitness1/src/api.rs | 8 ++-- gen/fitness1/src/lib.rs | 32 ++++++------- gen/fusiontables2/README.md | 34 +++++++------- gen/fusiontables2/src/api.rs | 8 ++-- gen/fusiontables2/src/lib.rs | 32 ++++++------- gen/games1/README.md | 34 +++++++------- gen/games1/src/api.rs | 8 ++-- gen/games1/src/lib.rs | 32 ++++++------- .../README.md | 34 +++++++------- .../src/api.rs | 8 ++-- .../src/lib.rs | 32 ++++++------- gen/gameservices1/README.md | 34 +++++++------- gen/gameservices1/src/api.rs | 8 ++-- gen/gameservices1/src/lib.rs | 32 ++++++------- gen/gamesmanagement1_management/README.md | 34 +++++++------- gen/gamesmanagement1_management/src/api.rs | 8 ++-- gen/gamesmanagement1_management/src/lib.rs | 32 ++++++------- gen/gan1_beta1/README.md | 34 +++++++------- gen/gan1_beta1/src/api.rs | 6 +-- gen/gan1_beta1/src/lib.rs | 32 ++++++------- gen/genomics1/README.md | 34 +++++++------- gen/genomics1/src/api.rs | 8 ++-- gen/genomics1/src/lib.rs | 32 ++++++------- gen/gkehub1/README.md | 34 +++++++------- gen/gkehub1/src/api.rs | 8 ++-- gen/gkehub1/src/lib.rs | 32 ++++++------- gen/gmail1/README.md | 34 +++++++------- gen/gmail1/src/api.rs | 8 ++-- gen/gmail1/src/lib.rs | 32 ++++++------- gen/gmailpostmastertools1/README.md | 34 +++++++------- gen/gmailpostmastertools1/src/api.rs | 8 ++-- gen/gmailpostmastertools1/src/lib.rs | 32 ++++++------- gen/gmailpostmastertools1_beta1/README.md | 34 +++++++------- gen/gmailpostmastertools1_beta1/src/api.rs | 8 ++-- gen/gmailpostmastertools1_beta1/src/lib.rs | 32 ++++++------- gen/groupsmigration1/README.md | 34 +++++++------- gen/groupsmigration1/src/api.rs | 8 ++-- gen/groupsmigration1/src/lib.rs | 32 ++++++------- gen/groupssettings1/README.md | 34 +++++++------- gen/groupssettings1/src/api.rs | 8 ++-- gen/groupssettings1/src/lib.rs | 32 ++++++------- gen/healthcare1/README.md | 34 +++++++------- gen/healthcare1/src/api.rs | 8 ++-- gen/healthcare1/src/lib.rs | 32 ++++++------- gen/healthcare1_beta1/README.md | 34 +++++++------- gen/healthcare1_beta1/src/api.rs | 8 ++-- gen/healthcare1_beta1/src/lib.rs | 32 ++++++------- gen/iam1/README.md | 34 +++++++------- gen/iam1/src/api.rs | 8 ++-- gen/iam1/src/lib.rs | 32 ++++++------- gen/iamcredentials1/README.md | 34 +++++++------- gen/iamcredentials1/src/api.rs | 8 ++-- gen/iamcredentials1/src/lib.rs | 32 ++++++------- gen/iap1/README.md | 34 +++++++------- gen/iap1/src/api.rs | 8 ++-- gen/iap1/src/lib.rs | 32 ++++++------- gen/iap1_beta1/README.md | 34 +++++++------- gen/iap1_beta1/src/api.rs | 8 ++-- gen/iap1_beta1/src/lib.rs | 32 ++++++------- gen/ideahub1_beta/README.md | 34 +++++++------- gen/ideahub1_beta/src/api.rs | 6 +-- gen/ideahub1_beta/src/lib.rs | 32 ++++++------- gen/identitytoolkit3/README.md | 34 +++++++------- gen/identitytoolkit3/src/api.rs | 8 ++-- gen/identitytoolkit3/src/lib.rs | 32 ++++++------- gen/ids1/README.md | 34 +++++++------- gen/ids1/src/api.rs | 8 ++-- gen/ids1/src/lib.rs | 32 ++++++------- gen/indexing3/README.md | 34 +++++++------- gen/indexing3/src/api.rs | 8 ++-- gen/indexing3/src/lib.rs | 32 ++++++------- gen/jobs3/README.md | 34 +++++++------- gen/jobs3/src/api.rs | 8 ++-- gen/jobs3/src/lib.rs | 32 ++++++------- gen/jobs4/README.md | 34 +++++++------- gen/jobs4/src/api.rs | 8 ++-- gen/jobs4/src/lib.rs | 32 ++++++------- gen/keep1/README.md | 34 +++++++------- gen/keep1/src/api.rs | 8 ++-- gen/keep1/src/lib.rs | 32 ++++++------- gen/language1/README.md | 34 +++++++------- gen/language1/src/api.rs | 8 ++-- gen/language1/src/lib.rs | 32 ++++++------- gen/language1_beta1/README.md | 34 +++++++------- gen/language1_beta1/src/api.rs | 8 ++-- gen/language1_beta1/src/lib.rs | 32 ++++++------- gen/libraryagent1/README.md | 34 +++++++------- gen/libraryagent1/src/api.rs | 8 ++-- gen/libraryagent1/src/lib.rs | 32 ++++++------- gen/licensing1/README.md | 34 +++++++------- gen/licensing1/src/api.rs | 8 ++-- gen/licensing1/src/lib.rs | 32 ++++++------- gen/lifesciences2_beta/README.md | 34 +++++++------- gen/lifesciences2_beta/src/api.rs | 8 ++-- gen/lifesciences2_beta/src/lib.rs | 32 ++++++------- gen/localservices1/README.md | 34 +++++++------- gen/localservices1/src/api.rs | 8 ++-- gen/localservices1/src/lib.rs | 32 ++++++------- gen/logging2/README.md | 34 +++++++------- gen/logging2/src/api.rs | 8 ++-- gen/logging2/src/lib.rs | 32 ++++++------- gen/logging2_beta1/README.md | 34 +++++++------- gen/logging2_beta1/src/api.rs | 8 ++-- gen/logging2_beta1/src/lib.rs | 32 ++++++------- gen/managedidentities1/README.md | 34 +++++++------- gen/managedidentities1/src/api.rs | 8 ++-- gen/managedidentities1/src/lib.rs | 32 ++++++------- gen/manager1_beta2/README.md | 34 +++++++------- gen/manager1_beta2/src/api.rs | 8 ++-- gen/manager1_beta2/src/lib.rs | 32 ++++++------- gen/manufacturers1/README.md | 34 +++++++------- gen/manufacturers1/src/api.rs | 8 ++-- gen/manufacturers1/src/lib.rs | 32 ++++++------- gen/memcache1/README.md | 34 +++++++------- gen/memcache1/src/api.rs | 8 ++-- gen/memcache1/src/lib.rs | 32 ++++++------- gen/memcache1_beta2/README.md | 34 +++++++------- gen/memcache1_beta2/src/api.rs | 8 ++-- gen/memcache1_beta2/src/lib.rs | 32 ++++++------- gen/metastore1_beta/README.md | 34 +++++++------- gen/metastore1_beta/src/api.rs | 8 ++-- gen/metastore1_beta/src/lib.rs | 32 ++++++------- gen/mirror1/README.md | 34 +++++++------- gen/mirror1/src/api.rs | 8 ++-- gen/mirror1/src/lib.rs | 32 ++++++------- gen/ml1/README.md | 34 +++++++------- gen/ml1/src/api.rs | 8 ++-- gen/ml1/src/lib.rs | 32 ++++++------- gen/monitoring3/README.md | 34 +++++++------- gen/monitoring3/src/api.rs | 8 ++-- gen/monitoring3/src/lib.rs | 32 ++++++------- gen/mybusiness4/README.md | 34 +++++++------- gen/mybusiness4/src/api.rs | 6 +-- gen/mybusiness4/src/lib.rs | 32 ++++++------- gen/mybusinessaccountmanagement1/README.md | 34 +++++++------- gen/mybusinessaccountmanagement1/src/api.rs | 6 +-- gen/mybusinessaccountmanagement1/src/lib.rs | 32 ++++++------- gen/mybusinessbusinesscalls1/README.md | 34 +++++++------- gen/mybusinessbusinesscalls1/src/api.rs | 6 +-- gen/mybusinessbusinesscalls1/src/lib.rs | 32 ++++++------- gen/mybusinessbusinessinformation1/README.md | 34 +++++++------- gen/mybusinessbusinessinformation1/src/api.rs | 6 +-- gen/mybusinessbusinessinformation1/src/lib.rs | 32 ++++++------- gen/mybusinesslodging1/README.md | 34 +++++++------- gen/mybusinesslodging1/src/api.rs | 6 +-- gen/mybusinesslodging1/src/lib.rs | 32 ++++++------- gen/mybusinessnotifications1/README.md | 34 +++++++------- gen/mybusinessnotifications1/src/api.rs | 6 +-- gen/mybusinessnotifications1/src/lib.rs | 32 ++++++------- gen/mybusinessplaceactions1/README.md | 34 +++++++------- gen/mybusinessplaceactions1/src/api.rs | 6 +-- gen/mybusinessplaceactions1/src/lib.rs | 32 ++++++------- gen/mybusinessverifications1/README.md | 34 +++++++------- gen/mybusinessverifications1/src/api.rs | 6 +-- gen/mybusinessverifications1/src/lib.rs | 32 ++++++------- gen/networkconnectivity1/README.md | 34 +++++++------- gen/networkconnectivity1/src/api.rs | 8 ++-- gen/networkconnectivity1/src/lib.rs | 32 ++++++------- gen/networkconnectivity1_alpha1/README.md | 34 +++++++------- gen/networkconnectivity1_alpha1/src/api.rs | 8 ++-- gen/networkconnectivity1_alpha1/src/lib.rs | 32 ++++++------- gen/networkmanagement1/README.md | 34 +++++++------- gen/networkmanagement1/src/api.rs | 8 ++-- gen/networkmanagement1/src/lib.rs | 32 ++++++------- gen/networksecurity1/README.md | 34 +++++++------- gen/networksecurity1/src/api.rs | 8 ++-- gen/networksecurity1/src/lib.rs | 32 ++++++------- gen/networkservices1/README.md | 34 +++++++------- gen/networkservices1/src/api.rs | 8 ++-- gen/networkservices1/src/lib.rs | 32 ++++++------- gen/notebooks1/README.md | 34 +++++++------- gen/notebooks1/src/api.rs | 8 ++-- gen/notebooks1/src/lib.rs | 32 ++++++------- gen/ondemandscanning1/README.md | 34 +++++++------- gen/ondemandscanning1/src/api.rs | 8 ++-- gen/ondemandscanning1/src/lib.rs | 32 ++++++------- gen/orgpolicy2/README.md | 34 +++++++------- gen/orgpolicy2/src/api.rs | 8 ++-- gen/orgpolicy2/src/lib.rs | 32 ++++++------- gen/oslogin1/README.md | 34 +++++++------- gen/oslogin1/src/api.rs | 8 ++-- gen/oslogin1/src/lib.rs | 32 ++++++------- gen/oslogin1_beta/README.md | 34 +++++++------- gen/oslogin1_beta/src/api.rs | 8 ++-- gen/oslogin1_beta/src/lib.rs | 32 ++++++------- gen/pagespeedonline2/README.md | 34 +++++++------- gen/pagespeedonline2/src/api.rs | 6 +-- gen/pagespeedonline2/src/lib.rs | 32 ++++++------- gen/pagespeedonline4/README.md | 34 +++++++------- gen/pagespeedonline4/src/api.rs | 6 +-- gen/pagespeedonline4/src/lib.rs | 32 ++++++------- gen/pagespeedonline5/README.md | 34 +++++++------- gen/pagespeedonline5/src/api.rs | 8 ++-- gen/pagespeedonline5/src/lib.rs | 32 ++++++------- gen/partners2/README.md | 34 +++++++------- gen/partners2/src/api.rs | 6 +-- gen/partners2/src/lib.rs | 32 ++++++------- gen/paymentsresellersubscription1/README.md | 34 +++++++------- gen/paymentsresellersubscription1/src/api.rs | 6 +-- gen/paymentsresellersubscription1/src/lib.rs | 32 ++++++------- gen/people1/README.md | 34 +++++++------- gen/people1/src/api.rs | 8 ++-- gen/people1/src/lib.rs | 32 ++++++------- gen/photoslibrary1/README.md | 34 +++++++------- gen/photoslibrary1/src/api.rs | 8 ++-- gen/photoslibrary1/src/lib.rs | 32 ++++++------- gen/playablelocations3/README.md | 34 +++++++------- gen/playablelocations3/src/api.rs | 6 +-- gen/playablelocations3/src/lib.rs | 32 ++++++------- gen/playcustomapp1/README.md | 34 +++++++------- gen/playcustomapp1/src/api.rs | 8 ++-- gen/playcustomapp1/src/lib.rs | 32 ++++++------- gen/playintegrity1/README.md | 34 +++++++------- gen/playintegrity1/src/api.rs | 8 ++-- gen/playintegrity1/src/lib.rs | 32 ++++++------- gen/playmoviespartner1/README.md | 34 +++++++------- gen/playmoviespartner1/src/api.rs | 8 ++-- gen/playmoviespartner1/src/lib.rs | 32 ++++++------- gen/plus1/README.md | 34 +++++++------- gen/plus1/src/api.rs | 8 ++-- gen/plus1/src/lib.rs | 32 ++++++------- gen/plusdomains1/README.md | 34 +++++++------- gen/plusdomains1/src/api.rs | 8 ++-- gen/plusdomains1/src/lib.rs | 32 ++++++------- gen/policyanalyzer1/README.md | 34 +++++++------- gen/policyanalyzer1/src/api.rs | 8 ++-- gen/policyanalyzer1/src/lib.rs | 32 ++++++------- gen/policysimulator1/README.md | 34 +++++++------- gen/policysimulator1/src/api.rs | 8 ++-- gen/policysimulator1/src/lib.rs | 32 ++++++------- gen/policytroubleshooter1/README.md | 34 +++++++------- gen/policytroubleshooter1/src/api.rs | 8 ++-- gen/policytroubleshooter1/src/lib.rs | 32 ++++++------- gen/prediction1d6/README.md | 34 +++++++------- gen/prediction1d6/src/api.rs | 8 ++-- gen/prediction1d6/src/lib.rs | 32 ++++++------- gen/privateca1/README.md | 34 +++++++------- gen/privateca1/src/api.rs | 8 ++-- gen/privateca1/src/lib.rs | 32 ++++++------- gen/privateca1_beta1/README.md | 34 +++++++------- gen/privateca1_beta1/src/api.rs | 8 ++-- gen/privateca1_beta1/src/lib.rs | 32 ++++++------- gen/prod_tt_sasportal1_alpha1/README.md | 34 +++++++------- gen/prod_tt_sasportal1_alpha1/src/api.rs | 8 ++-- gen/prod_tt_sasportal1_alpha1/src/lib.rs | 32 ++++++------- gen/proximitybeacon1_beta1/README.md | 34 +++++++------- gen/proximitybeacon1_beta1/src/api.rs | 8 ++-- gen/proximitybeacon1_beta1/src/lib.rs | 32 ++++++------- gen/pubsub1/README.md | 34 +++++++------- gen/pubsub1/src/api.rs | 8 ++-- gen/pubsub1/src/lib.rs | 32 ++++++------- gen/pubsub1_beta2/README.md | 34 +++++++------- gen/pubsub1_beta2/src/api.rs | 8 ++-- gen/pubsub1_beta2/src/lib.rs | 32 ++++++------- gen/pubsublite1/README.md | 34 +++++++------- gen/pubsublite1/src/api.rs | 8 ++-- gen/pubsublite1/src/lib.rs | 32 ++++++------- gen/qpxexpress1/README.md | 34 +++++++------- gen/qpxexpress1/src/api.rs | 6 +-- gen/qpxexpress1/src/lib.rs | 32 ++++++------- gen/realtimebidding1/README.md | 34 +++++++------- gen/realtimebidding1/src/api.rs | 8 ++-- gen/realtimebidding1/src/lib.rs | 32 ++++++------- gen/recaptchaenterprise1/README.md | 34 +++++++------- gen/recaptchaenterprise1/src/api.rs | 8 ++-- gen/recaptchaenterprise1/src/lib.rs | 32 ++++++------- gen/recommendationengine1_beta1/README.md | 34 +++++++------- gen/recommendationengine1_beta1/src/api.rs | 8 ++-- gen/recommendationengine1_beta1/src/lib.rs | 32 ++++++------- gen/recommender1/README.md | 34 +++++++------- gen/recommender1/src/api.rs | 8 ++-- gen/recommender1/src/lib.rs | 32 ++++++------- gen/recommender1_beta1/README.md | 34 +++++++------- gen/recommender1_beta1/src/api.rs | 8 ++-- gen/recommender1_beta1/src/lib.rs | 32 ++++++------- gen/redis1/README.md | 34 +++++++------- gen/redis1/src/api.rs | 8 ++-- gen/redis1/src/lib.rs | 32 ++++++------- gen/remotebuildexecution2/README.md | 34 +++++++------- gen/remotebuildexecution2/src/api.rs | 8 ++-- gen/remotebuildexecution2/src/lib.rs | 32 ++++++------- gen/replicapool1_beta2/README.md | 34 +++++++------- gen/replicapool1_beta2/src/api.rs | 8 ++-- gen/replicapool1_beta2/src/lib.rs | 32 ++++++------- gen/replicapoolupdater1_beta1/README.md | 34 +++++++------- gen/replicapoolupdater1_beta1/src/api.rs | 8 ++-- gen/replicapoolupdater1_beta1/src/lib.rs | 32 ++++++------- gen/reseller1_sandbox/README.md | 34 +++++++------- gen/reseller1_sandbox/src/api.rs | 8 ++-- gen/reseller1_sandbox/src/lib.rs | 32 ++++++------- gen/resourcesettings1/README.md | 34 +++++++------- gen/resourcesettings1/src/api.rs | 8 ++-- gen/resourcesettings1/src/lib.rs | 32 ++++++------- gen/resourceviews1_beta2/README.md | 34 +++++++------- gen/resourceviews1_beta2/src/api.rs | 8 ++-- gen/resourceviews1_beta2/src/lib.rs | 32 ++++++------- gen/retail2/README.md | 34 +++++++------- gen/retail2/src/api.rs | 8 ++-- gen/retail2/src/lib.rs | 32 ++++++------- gen/run1/README.md | 34 +++++++------- gen/run1/src/api.rs | 8 ++-- gen/run1/src/lib.rs | 32 ++++++------- gen/run2/README.md | 34 +++++++------- gen/run2/src/api.rs | 8 ++-- gen/run2/src/lib.rs | 32 ++++++------- gen/runtimeconfig1/README.md | 34 +++++++------- gen/runtimeconfig1/src/api.rs | 8 ++-- gen/runtimeconfig1/src/lib.rs | 32 ++++++------- gen/runtimeconfig1_beta1/README.md | 34 +++++++------- gen/runtimeconfig1_beta1/src/api.rs | 8 ++-- gen/runtimeconfig1_beta1/src/lib.rs | 32 ++++++------- gen/safebrowsing4/README.md | 34 +++++++------- gen/safebrowsing4/src/api.rs | 6 +-- gen/safebrowsing4/src/lib.rs | 32 ++++++------- gen/sasportal1_alpha1/README.md | 34 +++++++------- gen/sasportal1_alpha1/src/api.rs | 8 ++-- gen/sasportal1_alpha1/src/lib.rs | 32 ++++++------- gen/searchconsole1/README.md | 34 +++++++------- gen/searchconsole1/src/api.rs | 8 ++-- gen/searchconsole1/src/lib.rs | 32 ++++++------- gen/secretmanager1/README.md | 34 +++++++------- gen/secretmanager1/src/api.rs | 8 ++-- gen/secretmanager1/src/lib.rs | 32 ++++++------- gen/secretmanager1_beta1/README.md | 34 +++++++------- gen/secretmanager1_beta1/src/api.rs | 8 ++-- gen/secretmanager1_beta1/src/lib.rs | 32 ++++++------- gen/securitycenter1/README.md | 34 +++++++------- gen/securitycenter1/src/api.rs | 8 ++-- gen/securitycenter1/src/lib.rs | 32 ++++++------- gen/servicebroker1/README.md | 34 +++++++------- gen/servicebroker1/src/api.rs | 8 ++-- gen/servicebroker1/src/lib.rs | 32 ++++++------- gen/servicecontrol1/README.md | 34 +++++++------- gen/servicecontrol1/src/api.rs | 8 ++-- gen/servicecontrol1/src/lib.rs | 32 ++++++------- gen/servicecontrol2/README.md | 34 +++++++------- gen/servicecontrol2/src/api.rs | 8 ++-- gen/servicecontrol2/src/lib.rs | 32 ++++++------- gen/servicedirectory1/README.md | 34 +++++++------- gen/servicedirectory1/src/api.rs | 8 ++-- gen/servicedirectory1/src/lib.rs | 32 ++++++------- gen/servicedirectory1_beta1/README.md | 34 +++++++------- gen/servicedirectory1_beta1/src/api.rs | 8 ++-- gen/servicedirectory1_beta1/src/lib.rs | 32 ++++++------- gen/serviceregistryalpha/README.md | 34 +++++++------- gen/serviceregistryalpha/src/api.rs | 8 ++-- gen/serviceregistryalpha/src/lib.rs | 32 ++++++------- gen/sheets4/README.md | 34 +++++++------- gen/sheets4/src/api.rs | 8 ++-- gen/sheets4/src/lib.rs | 32 ++++++------- gen/siteverification1/README.md | 34 +++++++------- gen/siteverification1/src/api.rs | 8 ++-- gen/siteverification1/src/lib.rs | 32 ++++++------- gen/smartdevicemanagement1/README.md | 34 +++++++------- gen/smartdevicemanagement1/src/api.rs | 8 ++-- gen/smartdevicemanagement1/src/lib.rs | 32 ++++++------- gen/sourcerepo1/README.md | 34 +++++++------- gen/sourcerepo1/src/api.rs | 8 ++-- gen/sourcerepo1/src/lib.rs | 32 ++++++------- gen/spectrum1_explorer/README.md | 34 +++++++------- gen/spectrum1_explorer/src/api.rs | 6 +-- gen/spectrum1_explorer/src/lib.rs | 32 ++++++------- gen/speech1/README.md | 34 +++++++------- gen/speech1/src/api.rs | 8 ++-- gen/speech1/src/lib.rs | 32 ++++++------- gen/speech1_beta1/README.md | 34 +++++++------- gen/speech1_beta1/src/api.rs | 8 ++-- gen/speech1_beta1/src/lib.rs | 32 ++++++------- gen/sql1_beta4/README.md | 34 +++++++------- gen/sql1_beta4/src/api.rs | 8 ++-- gen/sql1_beta4/src/lib.rs | 32 ++++++------- gen/sqladmin1/README.md | 34 +++++++------- gen/sqladmin1/src/api.rs | 8 ++-- gen/sqladmin1/src/lib.rs | 32 ++++++------- gen/sqladmin1_beta4/README.md | 34 +++++++------- gen/sqladmin1_beta4/src/api.rs | 8 ++-- gen/sqladmin1_beta4/src/lib.rs | 32 ++++++------- gen/storage1/README.md | 34 +++++++------- gen/storage1/src/api.rs | 8 ++-- gen/storage1/src/lib.rs | 32 ++++++------- gen/storagetransfer1/README.md | 34 +++++++------- gen/storagetransfer1/src/api.rs | 8 ++-- gen/storagetransfer1/src/lib.rs | 32 ++++++------- gen/sts1/README.md | 34 +++++++------- gen/sts1/src/api.rs | 6 +-- gen/sts1/src/lib.rs | 32 ++++++------- gen/surveys2/README.md | 34 +++++++------- gen/surveys2/src/api.rs | 8 ++-- gen/surveys2/src/lib.rs | 32 ++++++------- gen/tagmanager1/README.md | 34 +++++++------- gen/tagmanager1/src/api.rs | 8 ++-- gen/tagmanager1/src/lib.rs | 32 ++++++------- gen/tagmanager2/README.md | 34 +++++++------- gen/tagmanager2/src/api.rs | 8 ++-- gen/tagmanager2/src/lib.rs | 32 ++++++------- gen/taskqueue1_beta2/README.md | 34 +++++++------- gen/taskqueue1_beta2/src/api.rs | 8 ++-- gen/taskqueue1_beta2/src/lib.rs | 32 ++++++------- gen/tasks1/README.md | 34 +++++++------- gen/tasks1/src/api.rs | 8 ++-- gen/tasks1/src/lib.rs | 32 ++++++------- gen/testing1/README.md | 34 +++++++------- gen/testing1/src/api.rs | 8 ++-- gen/testing1/src/lib.rs | 32 ++++++------- gen/texttospeech1/README.md | 34 +++++++------- gen/texttospeech1/src/api.rs | 8 ++-- gen/texttospeech1/src/lib.rs | 32 ++++++------- gen/tpu1/README.md | 34 +++++++------- gen/tpu1/src/api.rs | 8 ++-- gen/tpu1/src/lib.rs | 32 ++++++------- gen/tpu1_alpha1/README.md | 34 +++++++------- gen/tpu1_alpha1/src/api.rs | 8 ++-- gen/tpu1_alpha1/src/lib.rs | 32 ++++++------- gen/transcoder1/README.md | 34 +++++++------- gen/transcoder1/src/api.rs | 8 ++-- gen/transcoder1/src/lib.rs | 32 ++++++------- gen/transcoder1_beta1/README.md | 34 +++++++------- gen/transcoder1_beta1/src/api.rs | 8 ++-- gen/transcoder1_beta1/src/lib.rs | 32 ++++++------- gen/translate2/README.md | 34 +++++++------- gen/translate2/src/api.rs | 8 ++-- gen/translate2/src/lib.rs | 32 ++++++------- gen/translate3/README.md | 34 +++++++------- gen/translate3/src/api.rs | 8 ++-- gen/translate3/src/lib.rs | 32 ++++++------- gen/urlshortener1/README.md | 34 +++++++------- gen/urlshortener1/src/api.rs | 8 ++-- gen/urlshortener1/src/lib.rs | 32 ++++++------- gen/vault1/README.md | 34 +++++++------- gen/vault1/src/api.rs | 8 ++-- gen/vault1/src/lib.rs | 32 ++++++------- gen/vectortile1/README.md | 34 +++++++------- gen/vectortile1/src/api.rs | 6 +-- gen/vectortile1/src/lib.rs | 32 ++++++------- gen/verifiedaccess1/README.md | 34 +++++++------- gen/verifiedaccess1/src/api.rs | 8 ++-- gen/verifiedaccess1/src/lib.rs | 32 ++++++------- gen/versionhistory1/README.md | 34 +++++++------- gen/versionhistory1/src/api.rs | 6 +-- gen/versionhistory1/src/lib.rs | 32 ++++++------- gen/videointelligence1/README.md | 34 +++++++------- gen/videointelligence1/src/api.rs | 8 ++-- gen/videointelligence1/src/lib.rs | 32 ++++++------- gen/videointelligence1_beta1/README.md | 34 +++++++------- gen/videointelligence1_beta1/src/api.rs | 8 ++-- gen/videointelligence1_beta1/src/lib.rs | 32 ++++++------- gen/vision1/README.md | 34 +++++++------- gen/vision1/src/api.rs | 8 ++-- gen/vision1/src/lib.rs | 32 ++++++------- gen/vmmigration1/README.md | 34 +++++++------- gen/vmmigration1/src/api.rs | 8 ++-- gen/vmmigration1/src/lib.rs | 32 ++++++------- gen/walletobjects1/README.md | 34 +++++++------- gen/walletobjects1/src/api.rs | 8 ++-- gen/walletobjects1/src/lib.rs | 32 ++++++------- gen/webfonts1/README.md | 34 +++++++------- gen/webfonts1/src/api.rs | 6 +-- gen/webfonts1/src/lib.rs | 32 ++++++------- gen/webmasters3/README.md | 34 +++++++------- gen/webmasters3/src/api.rs | 8 ++-- gen/webmasters3/src/lib.rs | 32 ++++++------- gen/webrisk1/README.md | 34 +++++++------- gen/webrisk1/src/api.rs | 8 ++-- gen/webrisk1/src/lib.rs | 32 ++++++------- gen/workflowexecutions1/README.md | 34 +++++++------- gen/workflowexecutions1/src/api.rs | 8 ++-- gen/workflowexecutions1/src/lib.rs | 32 ++++++------- gen/workflows1/README.md | 34 +++++++------- gen/workflows1/src/api.rs | 8 ++-- gen/workflows1/src/lib.rs | 32 ++++++------- gen/youtube3/README.md | 34 +++++++------- gen/youtube3/src/api.rs | 6 +-- gen/youtube3/src/lib.rs | 32 ++++++------- gen/youtubereporting1/README.md | 34 +++++++------- gen/youtubereporting1/src/api.rs | 8 ++-- gen/youtubereporting1/src/lib.rs | 32 ++++++------- src/generator/templates/api/lib/lib.mako | 46 +++++++++---------- 964 files changed, 11866 insertions(+), 11866 deletions(-) diff --git a/gen/abusiveexperiencereport1/README.md b/gen/abusiveexperiencereport1/README.md index 459deff869..c99d144946 100644 --- a/gen/abusiveexperiencereport1/README.md +++ b/gen/abusiveexperiencereport1/README.md @@ -11,7 +11,7 @@ Everything else about the *Abusive Experience Report* *v1* API can be found at t [official documentation site](https://developers.google.com/abusive-experience-report/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-abusiveexperiencereport1/5.0.3+20230114/google_abusiveexperiencereport1/AbusiveExperienceReport) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-abusiveexperiencereport1/5.0.3+20230114/google_abusiveexperiencereport1/AbusiveExperienceReport) ... * sites * [*get*](https://docs.rs/google-abusiveexperiencereport1/5.0.3+20230114/google_abusiveexperiencereport1/api::SiteGetCall) @@ -52,8 +52,8 @@ Or specifically ... let r = hub.sites().get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -80,12 +80,12 @@ use abusiveexperiencereport1::{Result, Error}; use std::default::Default; use abusiveexperiencereport1::{AbusiveExperienceReport, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -121,10 +121,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-abusiveexperiencereport1/5.0.3+20230114/google_abusiveexperiencereport1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-abusiveexperiencereport1/5.0.3+20230114/google_abusiveexperiencereport1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -134,25 +134,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-abusiv You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-abusiveexperiencereport1/5.0.3+20230114/google_abusiveexperiencereport1/client::Delegate) to the -[Method Builder](https://docs.rs/google-abusiveexperiencereport1/5.0.3+20230114/google_abusiveexperiencereport1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-abusiveexperiencereport1/5.0.3+20230114/google_abusiveexperiencereport1/client::Delegate) to the +[Method Builder](https://docs.rs/google-abusiveexperiencereport1/5.0.3+20230114/google_abusiveexperiencereport1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-abusiveexperiencereport1/5.0.3+20230114/google_abusiveexperiencereport1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-abusiveexperiencereport1/5.0.3+20230114/google_abusiveexperiencereport1/client::RequestValue) and -[decodable](https://docs.rs/google-abusiveexperiencereport1/5.0.3+20230114/google_abusiveexperiencereport1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-abusiveexperiencereport1/5.0.3+20230114/google_abusiveexperiencereport1/client::RequestValue) and +[decodable](https://docs.rs/google-abusiveexperiencereport1/5.0.3+20230114/google_abusiveexperiencereport1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-abusiveexperiencereport1/5.0.3+20230114/google_abusiveexperiencereport1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-abusiveexperiencereport1/5.0.3+20230114/google_abusiveexperiencereport1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -171,7 +171,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **abusiveexperiencereport1** library was generated by Sebastian Thiel, and is placed +The **abusiveexperiencereport1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/abusiveexperiencereport1/src/api.rs b/gen/abusiveexperiencereport1/src/api.rs index a86d83823b..466f7c3c76 100644 --- a/gen/abusiveexperiencereport1/src/api.rs +++ b/gen/abusiveexperiencereport1/src/api.rs @@ -42,12 +42,12 @@ use crate::{client, client::GetToken, client::serde_with}; /// use std::default::Default; /// use abusiveexperiencereport1::{AbusiveExperienceReport, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/abusiveexperiencereport1/src/lib.rs b/gen/abusiveexperiencereport1/src/lib.rs index 0feb394c9c..565d989e87 100644 --- a/gen/abusiveexperiencereport1/src/lib.rs +++ b/gen/abusiveexperiencereport1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/abusiveexperiencereport1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](AbusiveExperienceReport) ... +//! Handle the following *Resources* with ease from the central [hub](AbusiveExperienceReport) ... //! //! * sites //! * [*get*](api::SiteGetCall) @@ -52,8 +52,8 @@ //! let r = hub.sites().get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -81,12 +81,12 @@ //! use std::default::Default; //! use abusiveexperiencereport1::{AbusiveExperienceReport, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -122,10 +122,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -135,25 +135,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/acceleratedmobilepageurl1/README.md b/gen/acceleratedmobilepageurl1/README.md index 80394a29a8..b21b290234 100644 --- a/gen/acceleratedmobilepageurl1/README.md +++ b/gen/acceleratedmobilepageurl1/README.md @@ -11,7 +11,7 @@ Everything else about the *Acceleratedmobilepageurl* *v1* API can be found at th [official documentation site](https://developers.google.com/amp/cache/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-acceleratedmobilepageurl1/5.0.3+20230123/google_acceleratedmobilepageurl1/Acceleratedmobilepageurl) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-acceleratedmobilepageurl1/5.0.3+20230123/google_acceleratedmobilepageurl1/Acceleratedmobilepageurl) ... * [amp urls](https://docs.rs/google-acceleratedmobilepageurl1/5.0.3+20230123/google_acceleratedmobilepageurl1/api::AmpUrl) * [*batch get*](https://docs.rs/google-acceleratedmobilepageurl1/5.0.3+20230123/google_acceleratedmobilepageurl1/api::AmpUrlBatchGetCall) @@ -50,8 +50,8 @@ Or specifically ... let r = hub.amp_urls().batch_get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -79,12 +79,12 @@ use acceleratedmobilepageurl1::{Result, Error}; use std::default::Default; use acceleratedmobilepageurl1::{Acceleratedmobilepageurl, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -125,10 +125,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-acceleratedmobilepageurl1/5.0.3+20230123/google_acceleratedmobilepageurl1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-acceleratedmobilepageurl1/5.0.3+20230123/google_acceleratedmobilepageurl1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -138,25 +138,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-accele You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-acceleratedmobilepageurl1/5.0.3+20230123/google_acceleratedmobilepageurl1/client::Delegate) to the -[Method Builder](https://docs.rs/google-acceleratedmobilepageurl1/5.0.3+20230123/google_acceleratedmobilepageurl1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-acceleratedmobilepageurl1/5.0.3+20230123/google_acceleratedmobilepageurl1/client::Delegate) to the +[Method Builder](https://docs.rs/google-acceleratedmobilepageurl1/5.0.3+20230123/google_acceleratedmobilepageurl1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-acceleratedmobilepageurl1/5.0.3+20230123/google_acceleratedmobilepageurl1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-acceleratedmobilepageurl1/5.0.3+20230123/google_acceleratedmobilepageurl1/client::RequestValue) and -[decodable](https://docs.rs/google-acceleratedmobilepageurl1/5.0.3+20230123/google_acceleratedmobilepageurl1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-acceleratedmobilepageurl1/5.0.3+20230123/google_acceleratedmobilepageurl1/client::RequestValue) and +[decodable](https://docs.rs/google-acceleratedmobilepageurl1/5.0.3+20230123/google_acceleratedmobilepageurl1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-acceleratedmobilepageurl1/5.0.3+20230123/google_acceleratedmobilepageurl1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-acceleratedmobilepageurl1/5.0.3+20230123/google_acceleratedmobilepageurl1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -175,7 +175,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **acceleratedmobilepageurl1** library was generated by Sebastian Thiel, and is placed +The **acceleratedmobilepageurl1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/acceleratedmobilepageurl1/src/api.rs b/gen/acceleratedmobilepageurl1/src/api.rs index 4432464190..0246b907f0 100644 --- a/gen/acceleratedmobilepageurl1/src/api.rs +++ b/gen/acceleratedmobilepageurl1/src/api.rs @@ -43,12 +43,12 @@ use crate::{client, client::GetToken, client::serde_with}; /// use std::default::Default; /// use acceleratedmobilepageurl1::{Acceleratedmobilepageurl, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/acceleratedmobilepageurl1/src/lib.rs b/gen/acceleratedmobilepageurl1/src/lib.rs index 87ee0a0377..b6e9ea2949 100644 --- a/gen/acceleratedmobilepageurl1/src/lib.rs +++ b/gen/acceleratedmobilepageurl1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/acceleratedmobilepageurl1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Acceleratedmobilepageurl) ... +//! Handle the following *Resources* with ease from the central [hub](Acceleratedmobilepageurl) ... //! //! * [amp urls](api::AmpUrl) //! * [*batch get*](api::AmpUrlBatchGetCall) @@ -50,8 +50,8 @@ //! let r = hub.amp_urls().batch_get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -80,12 +80,12 @@ //! use std::default::Default; //! use acceleratedmobilepageurl1::{Acceleratedmobilepageurl, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -126,10 +126,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -139,25 +139,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/accessapproval1/README.md b/gen/accessapproval1/README.md index 53b747945a..189befbe2b 100644 --- a/gen/accessapproval1/README.md +++ b/gen/accessapproval1/README.md @@ -11,7 +11,7 @@ Everything else about the *Access Approval* *v1* API can be found at the [official documentation site](https://cloud.google.com/cloud-provider-access-management/access-approval/docs). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-accessapproval1/5.0.3+20230120/google_accessapproval1/AccessApproval) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-accessapproval1/5.0.3+20230120/google_accessapproval1/AccessApproval) ... * folders * [*approval requests approve*](https://docs.rs/google-accessapproval1/5.0.3+20230120/google_accessapproval1/api::FolderApprovalRequestApproveCall), [*approval requests dismiss*](https://docs.rs/google-accessapproval1/5.0.3+20230120/google_accessapproval1/api::FolderApprovalRequestDismisCall), [*approval requests get*](https://docs.rs/google-accessapproval1/5.0.3+20230120/google_accessapproval1/api::FolderApprovalRequestGetCall), [*approval requests invalidate*](https://docs.rs/google-accessapproval1/5.0.3+20230120/google_accessapproval1/api::FolderApprovalRequestInvalidateCall), [*approval requests list*](https://docs.rs/google-accessapproval1/5.0.3+20230120/google_accessapproval1/api::FolderApprovalRequestListCall), [*delete access approval settings*](https://docs.rs/google-accessapproval1/5.0.3+20230120/google_accessapproval1/api::FolderDeleteAccessApprovalSettingCall), [*get access approval settings*](https://docs.rs/google-accessapproval1/5.0.3+20230120/google_accessapproval1/api::FolderGetAccessApprovalSettingCall), [*get service account*](https://docs.rs/google-accessapproval1/5.0.3+20230120/google_accessapproval1/api::FolderGetServiceAccountCall) and [*update access approval settings*](https://docs.rs/google-accessapproval1/5.0.3+20230120/google_accessapproval1/api::FolderUpdateAccessApprovalSettingCall) @@ -65,8 +65,8 @@ let r = hub.projects().approval_requests_get(...).doit().await let r = hub.projects().approval_requests_invalidate(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -94,12 +94,12 @@ use accessapproval1::{Result, Error}; use std::default::Default; use accessapproval1::{AccessApproval, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -140,10 +140,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-accessapproval1/5.0.3+20230120/google_accessapproval1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-accessapproval1/5.0.3+20230120/google_accessapproval1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -153,25 +153,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-access You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-accessapproval1/5.0.3+20230120/google_accessapproval1/client::Delegate) to the -[Method Builder](https://docs.rs/google-accessapproval1/5.0.3+20230120/google_accessapproval1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-accessapproval1/5.0.3+20230120/google_accessapproval1/client::Delegate) to the +[Method Builder](https://docs.rs/google-accessapproval1/5.0.3+20230120/google_accessapproval1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-accessapproval1/5.0.3+20230120/google_accessapproval1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-accessapproval1/5.0.3+20230120/google_accessapproval1/client::RequestValue) and -[decodable](https://docs.rs/google-accessapproval1/5.0.3+20230120/google_accessapproval1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-accessapproval1/5.0.3+20230120/google_accessapproval1/client::RequestValue) and +[decodable](https://docs.rs/google-accessapproval1/5.0.3+20230120/google_accessapproval1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-accessapproval1/5.0.3+20230120/google_accessapproval1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-accessapproval1/5.0.3+20230120/google_accessapproval1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -190,7 +190,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **accessapproval1** library was generated by Sebastian Thiel, and is placed +The **accessapproval1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/accessapproval1/src/api.rs b/gen/accessapproval1/src/api.rs index db3cd9aed3..ea39220cb1 100644 --- a/gen/accessapproval1/src/api.rs +++ b/gen/accessapproval1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use accessapproval1::{AccessApproval, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/accessapproval1/src/lib.rs b/gen/accessapproval1/src/lib.rs index 5c21beb757..213b0319dd 100644 --- a/gen/accessapproval1/src/lib.rs +++ b/gen/accessapproval1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/accessapproval1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](AccessApproval) ... +//! Handle the following *Resources* with ease from the central [hub](AccessApproval) ... //! //! * folders //! * [*approval requests approve*](api::FolderApprovalRequestApproveCall), [*approval requests dismiss*](api::FolderApprovalRequestDismisCall), [*approval requests get*](api::FolderApprovalRequestGetCall), [*approval requests invalidate*](api::FolderApprovalRequestInvalidateCall), [*approval requests list*](api::FolderApprovalRequestListCall), [*delete access approval settings*](api::FolderDeleteAccessApprovalSettingCall), [*get access approval settings*](api::FolderGetAccessApprovalSettingCall), [*get service account*](api::FolderGetServiceAccountCall) and [*update access approval settings*](api::FolderUpdateAccessApprovalSettingCall) @@ -65,8 +65,8 @@ //! let r = hub.projects().approval_requests_invalidate(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -95,12 +95,12 @@ //! use std::default::Default; //! use accessapproval1::{AccessApproval, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -141,10 +141,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -154,25 +154,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/accessapproval1_beta1/README.md b/gen/accessapproval1_beta1/README.md index 5431c0a759..773003327b 100644 --- a/gen/accessapproval1_beta1/README.md +++ b/gen/accessapproval1_beta1/README.md @@ -11,7 +11,7 @@ Everything else about the *Access Approval* *v1_beta1* API can be found at the [official documentation site](https://cloud.google.com/access-approval/docs). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-accessapproval1_beta1/5.0.3+20200708/google_accessapproval1_beta1/AccessApproval) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-accessapproval1_beta1/5.0.3+20200708/google_accessapproval1_beta1/AccessApproval) ... * folders * [*approval requests approve*](https://docs.rs/google-accessapproval1_beta1/5.0.3+20200708/google_accessapproval1_beta1/api::FolderApprovalRequestApproveCall), [*approval requests dismiss*](https://docs.rs/google-accessapproval1_beta1/5.0.3+20200708/google_accessapproval1_beta1/api::FolderApprovalRequestDismisCall), [*approval requests get*](https://docs.rs/google-accessapproval1_beta1/5.0.3+20200708/google_accessapproval1_beta1/api::FolderApprovalRequestGetCall), [*approval requests list*](https://docs.rs/google-accessapproval1_beta1/5.0.3+20200708/google_accessapproval1_beta1/api::FolderApprovalRequestListCall), [*delete access approval settings*](https://docs.rs/google-accessapproval1_beta1/5.0.3+20200708/google_accessapproval1_beta1/api::FolderDeleteAccessApprovalSettingCall), [*get access approval settings*](https://docs.rs/google-accessapproval1_beta1/5.0.3+20200708/google_accessapproval1_beta1/api::FolderGetAccessApprovalSettingCall) and [*update access approval settings*](https://docs.rs/google-accessapproval1_beta1/5.0.3+20200708/google_accessapproval1_beta1/api::FolderUpdateAccessApprovalSettingCall) @@ -62,8 +62,8 @@ let r = hub.projects().approval_requests_dismiss(...).doit().await let r = hub.projects().approval_requests_get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -91,12 +91,12 @@ use accessapproval1_beta1::{Result, Error}; use std::default::Default; use accessapproval1_beta1::{AccessApproval, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -137,10 +137,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-accessapproval1_beta1/5.0.3+20200708/google_accessapproval1_beta1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-accessapproval1_beta1/5.0.3+20200708/google_accessapproval1_beta1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -150,25 +150,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-access You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-accessapproval1_beta1/5.0.3+20200708/google_accessapproval1_beta1/client::Delegate) to the -[Method Builder](https://docs.rs/google-accessapproval1_beta1/5.0.3+20200708/google_accessapproval1_beta1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-accessapproval1_beta1/5.0.3+20200708/google_accessapproval1_beta1/client::Delegate) to the +[Method Builder](https://docs.rs/google-accessapproval1_beta1/5.0.3+20200708/google_accessapproval1_beta1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-accessapproval1_beta1/5.0.3+20200708/google_accessapproval1_beta1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-accessapproval1_beta1/5.0.3+20200708/google_accessapproval1_beta1/client::RequestValue) and -[decodable](https://docs.rs/google-accessapproval1_beta1/5.0.3+20200708/google_accessapproval1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-accessapproval1_beta1/5.0.3+20200708/google_accessapproval1_beta1/client::RequestValue) and +[decodable](https://docs.rs/google-accessapproval1_beta1/5.0.3+20200708/google_accessapproval1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-accessapproval1_beta1/5.0.3+20200708/google_accessapproval1_beta1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-accessapproval1_beta1/5.0.3+20200708/google_accessapproval1_beta1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -187,7 +187,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **accessapproval1_beta1** library was generated by Sebastian Thiel, and is placed +The **accessapproval1_beta1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/accessapproval1_beta1/src/api.rs b/gen/accessapproval1_beta1/src/api.rs index cbf2db0004..3399e6d471 100644 --- a/gen/accessapproval1_beta1/src/api.rs +++ b/gen/accessapproval1_beta1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your data across Google Cloud Platform services CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use accessapproval1_beta1::{AccessApproval, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/accessapproval1_beta1/src/lib.rs b/gen/accessapproval1_beta1/src/lib.rs index 3d65140348..ae4aff7f45 100644 --- a/gen/accessapproval1_beta1/src/lib.rs +++ b/gen/accessapproval1_beta1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/accessapproval1_beta1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](AccessApproval) ... +//! Handle the following *Resources* with ease from the central [hub](AccessApproval) ... //! //! * folders //! * [*approval requests approve*](api::FolderApprovalRequestApproveCall), [*approval requests dismiss*](api::FolderApprovalRequestDismisCall), [*approval requests get*](api::FolderApprovalRequestGetCall), [*approval requests list*](api::FolderApprovalRequestListCall), [*delete access approval settings*](api::FolderDeleteAccessApprovalSettingCall), [*get access approval settings*](api::FolderGetAccessApprovalSettingCall) and [*update access approval settings*](api::FolderUpdateAccessApprovalSettingCall) @@ -62,8 +62,8 @@ //! let r = hub.projects().approval_requests_get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -92,12 +92,12 @@ //! use std::default::Default; //! use accessapproval1_beta1::{AccessApproval, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -138,10 +138,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -151,25 +151,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/accesscontextmanager1/README.md b/gen/accesscontextmanager1/README.md index ddf1ff3448..5afa5df699 100644 --- a/gen/accesscontextmanager1/README.md +++ b/gen/accesscontextmanager1/README.md @@ -11,7 +11,7 @@ Everything else about the *Access Context Manager* *v1* API can be found at the [official documentation site](https://cloud.google.com/access-context-manager/docs/reference/rest/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-accesscontextmanager1/5.0.3+20230123/google_accesscontextmanager1/AccessContextManager) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-accesscontextmanager1/5.0.3+20230123/google_accesscontextmanager1/AccessContextManager) ... * [access policies](https://docs.rs/google-accesscontextmanager1/5.0.3+20230123/google_accesscontextmanager1/api::AccessPolicy) * [*access levels create*](https://docs.rs/google-accesscontextmanager1/5.0.3+20230123/google_accesscontextmanager1/api::AccessPolicyAccessLevelCreateCall), [*access levels delete*](https://docs.rs/google-accesscontextmanager1/5.0.3+20230123/google_accesscontextmanager1/api::AccessPolicyAccessLevelDeleteCall), [*access levels get*](https://docs.rs/google-accesscontextmanager1/5.0.3+20230123/google_accesscontextmanager1/api::AccessPolicyAccessLevelGetCall), [*access levels list*](https://docs.rs/google-accesscontextmanager1/5.0.3+20230123/google_accesscontextmanager1/api::AccessPolicyAccessLevelListCall), [*access levels patch*](https://docs.rs/google-accesscontextmanager1/5.0.3+20230123/google_accesscontextmanager1/api::AccessPolicyAccessLevelPatchCall), [*access levels replace all*](https://docs.rs/google-accesscontextmanager1/5.0.3+20230123/google_accesscontextmanager1/api::AccessPolicyAccessLevelReplaceAllCall), [*access levels test iam permissions*](https://docs.rs/google-accesscontextmanager1/5.0.3+20230123/google_accesscontextmanager1/api::AccessPolicyAccessLevelTestIamPermissionCall), [*authorized orgs descs create*](https://docs.rs/google-accesscontextmanager1/5.0.3+20230123/google_accesscontextmanager1/api::AccessPolicyAuthorizedOrgsDescCreateCall), [*authorized orgs descs delete*](https://docs.rs/google-accesscontextmanager1/5.0.3+20230123/google_accesscontextmanager1/api::AccessPolicyAuthorizedOrgsDescDeleteCall), [*authorized orgs descs get*](https://docs.rs/google-accesscontextmanager1/5.0.3+20230123/google_accesscontextmanager1/api::AccessPolicyAuthorizedOrgsDescGetCall), [*authorized orgs descs list*](https://docs.rs/google-accesscontextmanager1/5.0.3+20230123/google_accesscontextmanager1/api::AccessPolicyAuthorizedOrgsDescListCall), [*authorized orgs descs patch*](https://docs.rs/google-accesscontextmanager1/5.0.3+20230123/google_accesscontextmanager1/api::AccessPolicyAuthorizedOrgsDescPatchCall), [*create*](https://docs.rs/google-accesscontextmanager1/5.0.3+20230123/google_accesscontextmanager1/api::AccessPolicyCreateCall), [*delete*](https://docs.rs/google-accesscontextmanager1/5.0.3+20230123/google_accesscontextmanager1/api::AccessPolicyDeleteCall), [*get*](https://docs.rs/google-accesscontextmanager1/5.0.3+20230123/google_accesscontextmanager1/api::AccessPolicyGetCall), [*get iam policy*](https://docs.rs/google-accesscontextmanager1/5.0.3+20230123/google_accesscontextmanager1/api::AccessPolicyGetIamPolicyCall), [*list*](https://docs.rs/google-accesscontextmanager1/5.0.3+20230123/google_accesscontextmanager1/api::AccessPolicyListCall), [*patch*](https://docs.rs/google-accesscontextmanager1/5.0.3+20230123/google_accesscontextmanager1/api::AccessPolicyPatchCall), [*service perimeters commit*](https://docs.rs/google-accesscontextmanager1/5.0.3+20230123/google_accesscontextmanager1/api::AccessPolicyServicePerimeterCommitCall), [*service perimeters create*](https://docs.rs/google-accesscontextmanager1/5.0.3+20230123/google_accesscontextmanager1/api::AccessPolicyServicePerimeterCreateCall), [*service perimeters delete*](https://docs.rs/google-accesscontextmanager1/5.0.3+20230123/google_accesscontextmanager1/api::AccessPolicyServicePerimeterDeleteCall), [*service perimeters get*](https://docs.rs/google-accesscontextmanager1/5.0.3+20230123/google_accesscontextmanager1/api::AccessPolicyServicePerimeterGetCall), [*service perimeters list*](https://docs.rs/google-accesscontextmanager1/5.0.3+20230123/google_accesscontextmanager1/api::AccessPolicyServicePerimeterListCall), [*service perimeters patch*](https://docs.rs/google-accesscontextmanager1/5.0.3+20230123/google_accesscontextmanager1/api::AccessPolicyServicePerimeterPatchCall), [*service perimeters replace all*](https://docs.rs/google-accesscontextmanager1/5.0.3+20230123/google_accesscontextmanager1/api::AccessPolicyServicePerimeterReplaceAllCall), [*service perimeters test iam permissions*](https://docs.rs/google-accesscontextmanager1/5.0.3+20230123/google_accesscontextmanager1/api::AccessPolicyServicePerimeterTestIamPermissionCall), [*set iam policy*](https://docs.rs/google-accesscontextmanager1/5.0.3+20230123/google_accesscontextmanager1/api::AccessPolicySetIamPolicyCall) and [*test iam permissions*](https://docs.rs/google-accesscontextmanager1/5.0.3+20230123/google_accesscontextmanager1/api::AccessPolicyTestIamPermissionCall) @@ -75,8 +75,8 @@ let r = hub.organizations().gcp_user_access_bindings_delete(...).doit().await let r = hub.organizations().gcp_user_access_bindings_patch(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -103,12 +103,12 @@ use accesscontextmanager1::{Result, Error}; use std::default::Default; use accesscontextmanager1::{AccessContextManager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -147,10 +147,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-accesscontextmanager1/5.0.3+20230123/google_accesscontextmanager1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-accesscontextmanager1/5.0.3+20230123/google_accesscontextmanager1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -160,25 +160,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-access You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-accesscontextmanager1/5.0.3+20230123/google_accesscontextmanager1/client::Delegate) to the -[Method Builder](https://docs.rs/google-accesscontextmanager1/5.0.3+20230123/google_accesscontextmanager1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-accesscontextmanager1/5.0.3+20230123/google_accesscontextmanager1/client::Delegate) to the +[Method Builder](https://docs.rs/google-accesscontextmanager1/5.0.3+20230123/google_accesscontextmanager1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-accesscontextmanager1/5.0.3+20230123/google_accesscontextmanager1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-accesscontextmanager1/5.0.3+20230123/google_accesscontextmanager1/client::RequestValue) and -[decodable](https://docs.rs/google-accesscontextmanager1/5.0.3+20230123/google_accesscontextmanager1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-accesscontextmanager1/5.0.3+20230123/google_accesscontextmanager1/client::RequestValue) and +[decodable](https://docs.rs/google-accesscontextmanager1/5.0.3+20230123/google_accesscontextmanager1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-accesscontextmanager1/5.0.3+20230123/google_accesscontextmanager1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-accesscontextmanager1/5.0.3+20230123/google_accesscontextmanager1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -197,7 +197,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **accesscontextmanager1** library was generated by Sebastian Thiel, and is placed +The **accesscontextmanager1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/accesscontextmanager1/src/api.rs b/gen/accesscontextmanager1/src/api.rs index 6769553c48..3fbb2e257e 100644 --- a/gen/accesscontextmanager1/src/api.rs +++ b/gen/accesscontextmanager1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use accesscontextmanager1::{AccessContextManager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/accesscontextmanager1/src/lib.rs b/gen/accesscontextmanager1/src/lib.rs index e9ddd48726..230869b72c 100644 --- a/gen/accesscontextmanager1/src/lib.rs +++ b/gen/accesscontextmanager1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/accesscontextmanager1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](AccessContextManager) ... +//! Handle the following *Resources* with ease from the central [hub](AccessContextManager) ... //! //! * [access policies](api::AccessPolicy) //! * [*access levels create*](api::AccessPolicyAccessLevelCreateCall), [*access levels delete*](api::AccessPolicyAccessLevelDeleteCall), [*access levels get*](api::AccessPolicyAccessLevelGetCall), [*access levels list*](api::AccessPolicyAccessLevelListCall), [*access levels patch*](api::AccessPolicyAccessLevelPatchCall), [*access levels replace all*](api::AccessPolicyAccessLevelReplaceAllCall), [*access levels test iam permissions*](api::AccessPolicyAccessLevelTestIamPermissionCall), [*authorized orgs descs create*](api::AccessPolicyAuthorizedOrgsDescCreateCall), [*authorized orgs descs delete*](api::AccessPolicyAuthorizedOrgsDescDeleteCall), [*authorized orgs descs get*](api::AccessPolicyAuthorizedOrgsDescGetCall), [*authorized orgs descs list*](api::AccessPolicyAuthorizedOrgsDescListCall), [*authorized orgs descs patch*](api::AccessPolicyAuthorizedOrgsDescPatchCall), [*create*](api::AccessPolicyCreateCall), [*delete*](api::AccessPolicyDeleteCall), [*get*](api::AccessPolicyGetCall), [*get iam policy*](api::AccessPolicyGetIamPolicyCall), [*list*](api::AccessPolicyListCall), [*patch*](api::AccessPolicyPatchCall), [*service perimeters commit*](api::AccessPolicyServicePerimeterCommitCall), [*service perimeters create*](api::AccessPolicyServicePerimeterCreateCall), [*service perimeters delete*](api::AccessPolicyServicePerimeterDeleteCall), [*service perimeters get*](api::AccessPolicyServicePerimeterGetCall), [*service perimeters list*](api::AccessPolicyServicePerimeterListCall), [*service perimeters patch*](api::AccessPolicyServicePerimeterPatchCall), [*service perimeters replace all*](api::AccessPolicyServicePerimeterReplaceAllCall), [*service perimeters test iam permissions*](api::AccessPolicyServicePerimeterTestIamPermissionCall), [*set iam policy*](api::AccessPolicySetIamPolicyCall) and [*test iam permissions*](api::AccessPolicyTestIamPermissionCall) @@ -75,8 +75,8 @@ //! let r = hub.organizations().gcp_user_access_bindings_patch(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -104,12 +104,12 @@ //! use std::default::Default; //! use accesscontextmanager1::{AccessContextManager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -148,10 +148,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -161,25 +161,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/accesscontextmanager1_beta/README.md b/gen/accesscontextmanager1_beta/README.md index d2f8312664..3a245e1f0d 100644 --- a/gen/accesscontextmanager1_beta/README.md +++ b/gen/accesscontextmanager1_beta/README.md @@ -11,7 +11,7 @@ Everything else about the *Access Context Manager* *v1_beta* API can be found at [official documentation site](https://cloud.google.com/access-context-manager/docs/reference/rest/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-accesscontextmanager1_beta/5.0.3+20230123/google_accesscontextmanager1_beta/AccessContextManager) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-accesscontextmanager1_beta/5.0.3+20230123/google_accesscontextmanager1_beta/AccessContextManager) ... * [access policies](https://docs.rs/google-accesscontextmanager1_beta/5.0.3+20230123/google_accesscontextmanager1_beta/api::AccessPolicy) * [*access levels create*](https://docs.rs/google-accesscontextmanager1_beta/5.0.3+20230123/google_accesscontextmanager1_beta/api::AccessPolicyAccessLevelCreateCall), [*access levels delete*](https://docs.rs/google-accesscontextmanager1_beta/5.0.3+20230123/google_accesscontextmanager1_beta/api::AccessPolicyAccessLevelDeleteCall), [*access levels get*](https://docs.rs/google-accesscontextmanager1_beta/5.0.3+20230123/google_accesscontextmanager1_beta/api::AccessPolicyAccessLevelGetCall), [*access levels list*](https://docs.rs/google-accesscontextmanager1_beta/5.0.3+20230123/google_accesscontextmanager1_beta/api::AccessPolicyAccessLevelListCall), [*access levels patch*](https://docs.rs/google-accesscontextmanager1_beta/5.0.3+20230123/google_accesscontextmanager1_beta/api::AccessPolicyAccessLevelPatchCall), [*create*](https://docs.rs/google-accesscontextmanager1_beta/5.0.3+20230123/google_accesscontextmanager1_beta/api::AccessPolicyCreateCall), [*delete*](https://docs.rs/google-accesscontextmanager1_beta/5.0.3+20230123/google_accesscontextmanager1_beta/api::AccessPolicyDeleteCall), [*get*](https://docs.rs/google-accesscontextmanager1_beta/5.0.3+20230123/google_accesscontextmanager1_beta/api::AccessPolicyGetCall), [*list*](https://docs.rs/google-accesscontextmanager1_beta/5.0.3+20230123/google_accesscontextmanager1_beta/api::AccessPolicyListCall), [*patch*](https://docs.rs/google-accesscontextmanager1_beta/5.0.3+20230123/google_accesscontextmanager1_beta/api::AccessPolicyPatchCall), [*service perimeters create*](https://docs.rs/google-accesscontextmanager1_beta/5.0.3+20230123/google_accesscontextmanager1_beta/api::AccessPolicyServicePerimeterCreateCall), [*service perimeters delete*](https://docs.rs/google-accesscontextmanager1_beta/5.0.3+20230123/google_accesscontextmanager1_beta/api::AccessPolicyServicePerimeterDeleteCall), [*service perimeters get*](https://docs.rs/google-accesscontextmanager1_beta/5.0.3+20230123/google_accesscontextmanager1_beta/api::AccessPolicyServicePerimeterGetCall), [*service perimeters list*](https://docs.rs/google-accesscontextmanager1_beta/5.0.3+20230123/google_accesscontextmanager1_beta/api::AccessPolicyServicePerimeterListCall) and [*service perimeters patch*](https://docs.rs/google-accesscontextmanager1_beta/5.0.3+20230123/google_accesscontextmanager1_beta/api::AccessPolicyServicePerimeterPatchCall) @@ -61,8 +61,8 @@ let r = hub.access_policies().patch(...).doit().await let r = hub.operations().get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -90,12 +90,12 @@ use accesscontextmanager1_beta::{Result, Error}; use std::default::Default; use accesscontextmanager1_beta::{AccessContextManager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -137,10 +137,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-accesscontextmanager1_beta/5.0.3+20230123/google_accesscontextmanager1_beta/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-accesscontextmanager1_beta/5.0.3+20230123/google_accesscontextmanager1_beta/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -150,25 +150,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-access You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-accesscontextmanager1_beta/5.0.3+20230123/google_accesscontextmanager1_beta/client::Delegate) to the -[Method Builder](https://docs.rs/google-accesscontextmanager1_beta/5.0.3+20230123/google_accesscontextmanager1_beta/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-accesscontextmanager1_beta/5.0.3+20230123/google_accesscontextmanager1_beta/client::Delegate) to the +[Method Builder](https://docs.rs/google-accesscontextmanager1_beta/5.0.3+20230123/google_accesscontextmanager1_beta/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-accesscontextmanager1_beta/5.0.3+20230123/google_accesscontextmanager1_beta/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-accesscontextmanager1_beta/5.0.3+20230123/google_accesscontextmanager1_beta/client::RequestValue) and -[decodable](https://docs.rs/google-accesscontextmanager1_beta/5.0.3+20230123/google_accesscontextmanager1_beta/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-accesscontextmanager1_beta/5.0.3+20230123/google_accesscontextmanager1_beta/client::RequestValue) and +[decodable](https://docs.rs/google-accesscontextmanager1_beta/5.0.3+20230123/google_accesscontextmanager1_beta/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-accesscontextmanager1_beta/5.0.3+20230123/google_accesscontextmanager1_beta/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-accesscontextmanager1_beta/5.0.3+20230123/google_accesscontextmanager1_beta/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -187,7 +187,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **accesscontextmanager1_beta** library was generated by Sebastian Thiel, and is placed +The **accesscontextmanager1_beta** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/accesscontextmanager1_beta/src/api.rs b/gen/accesscontextmanager1_beta/src/api.rs index d3b4ab6b0c..2e22c60e43 100644 --- a/gen/accesscontextmanager1_beta/src/api.rs +++ b/gen/accesscontextmanager1_beta/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use accesscontextmanager1_beta::{AccessContextManager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/accesscontextmanager1_beta/src/lib.rs b/gen/accesscontextmanager1_beta/src/lib.rs index 4b972d3290..3a624bb400 100644 --- a/gen/accesscontextmanager1_beta/src/lib.rs +++ b/gen/accesscontextmanager1_beta/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/accesscontextmanager1_beta). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](AccessContextManager) ... +//! Handle the following *Resources* with ease from the central [hub](AccessContextManager) ... //! //! * [access policies](api::AccessPolicy) //! * [*access levels create*](api::AccessPolicyAccessLevelCreateCall), [*access levels delete*](api::AccessPolicyAccessLevelDeleteCall), [*access levels get*](api::AccessPolicyAccessLevelGetCall), [*access levels list*](api::AccessPolicyAccessLevelListCall), [*access levels patch*](api::AccessPolicyAccessLevelPatchCall), [*create*](api::AccessPolicyCreateCall), [*delete*](api::AccessPolicyDeleteCall), [*get*](api::AccessPolicyGetCall), [*list*](api::AccessPolicyListCall), [*patch*](api::AccessPolicyPatchCall), [*service perimeters create*](api::AccessPolicyServicePerimeterCreateCall), [*service perimeters delete*](api::AccessPolicyServicePerimeterDeleteCall), [*service perimeters get*](api::AccessPolicyServicePerimeterGetCall), [*service perimeters list*](api::AccessPolicyServicePerimeterListCall) and [*service perimeters patch*](api::AccessPolicyServicePerimeterPatchCall) @@ -61,8 +61,8 @@ //! let r = hub.operations().get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -91,12 +91,12 @@ //! use std::default::Default; //! use accesscontextmanager1_beta::{AccessContextManager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -138,10 +138,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -151,25 +151,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/adexchangebuyer1d3/README.md b/gen/adexchangebuyer1d3/README.md index 64a4f0b981..9ad5c97f19 100644 --- a/gen/adexchangebuyer1d3/README.md +++ b/gen/adexchangebuyer1d3/README.md @@ -11,7 +11,7 @@ Everything else about the *Ad Exchange Buyer* *v1d3* API can be found at the [official documentation site](https://developers.google.com/ad-exchange/buyer-rest). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-adexchangebuyer1d3/5.0.3+20210330/google_adexchangebuyer1d3/AdExchangeBuyer) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-adexchangebuyer1d3/5.0.3+20210330/google_adexchangebuyer1d3/AdExchangeBuyer) ... * [accounts](https://docs.rs/google-adexchangebuyer1d3/5.0.3+20210330/google_adexchangebuyer1d3/api::Account) * [*get*](https://docs.rs/google-adexchangebuyer1d3/5.0.3+20210330/google_adexchangebuyer1d3/api::AccountGetCall), [*list*](https://docs.rs/google-adexchangebuyer1d3/5.0.3+20210330/google_adexchangebuyer1d3/api::AccountListCall), [*patch*](https://docs.rs/google-adexchangebuyer1d3/5.0.3+20210330/google_adexchangebuyer1d3/api::AccountPatchCall) and [*update*](https://docs.rs/google-adexchangebuyer1d3/5.0.3+20210330/google_adexchangebuyer1d3/api::AccountUpdateCall) @@ -65,8 +65,8 @@ let r = hub.pretargeting_config().patch(...).doit().await let r = hub.pretargeting_config().update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -94,12 +94,12 @@ use adexchangebuyer1d3::{Result, Error}; use std::default::Default; use adexchangebuyer1d3::{AdExchangeBuyer, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -140,10 +140,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-adexchangebuyer1d3/5.0.3+20210330/google_adexchangebuyer1d3/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-adexchangebuyer1d3/5.0.3+20210330/google_adexchangebuyer1d3/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -153,25 +153,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-adexch You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-adexchangebuyer1d3/5.0.3+20210330/google_adexchangebuyer1d3/client::Delegate) to the -[Method Builder](https://docs.rs/google-adexchangebuyer1d3/5.0.3+20210330/google_adexchangebuyer1d3/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-adexchangebuyer1d3/5.0.3+20210330/google_adexchangebuyer1d3/client::Delegate) to the +[Method Builder](https://docs.rs/google-adexchangebuyer1d3/5.0.3+20210330/google_adexchangebuyer1d3/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-adexchangebuyer1d3/5.0.3+20210330/google_adexchangebuyer1d3/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-adexchangebuyer1d3/5.0.3+20210330/google_adexchangebuyer1d3/client::RequestValue) and -[decodable](https://docs.rs/google-adexchangebuyer1d3/5.0.3+20210330/google_adexchangebuyer1d3/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-adexchangebuyer1d3/5.0.3+20210330/google_adexchangebuyer1d3/client::RequestValue) and +[decodable](https://docs.rs/google-adexchangebuyer1d3/5.0.3+20210330/google_adexchangebuyer1d3/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-adexchangebuyer1d3/5.0.3+20210330/google_adexchangebuyer1d3/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-adexchangebuyer1d3/5.0.3+20210330/google_adexchangebuyer1d3/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -190,7 +190,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **adexchangebuyer1d3** library was generated by Sebastian Thiel, and is placed +The **adexchangebuyer1d3** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/adexchangebuyer1d3/src/api.rs b/gen/adexchangebuyer1d3/src/api.rs index fe312a80a6..10f085d1c2 100644 --- a/gen/adexchangebuyer1d3/src/api.rs +++ b/gen/adexchangebuyer1d3/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// Manage your Ad Exchange buyer account configuration AdexchangeBuyer, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use adexchangebuyer1d3::{AdExchangeBuyer, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/adexchangebuyer1d3/src/lib.rs b/gen/adexchangebuyer1d3/src/lib.rs index 2fd97141f4..d3c72d5706 100644 --- a/gen/adexchangebuyer1d3/src/lib.rs +++ b/gen/adexchangebuyer1d3/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/adexchangebuyer1d3). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](AdExchangeBuyer) ... +//! Handle the following *Resources* with ease from the central [hub](AdExchangeBuyer) ... //! //! * [accounts](api::Account) //! * [*get*](api::AccountGetCall), [*list*](api::AccountListCall), [*patch*](api::AccountPatchCall) and [*update*](api::AccountUpdateCall) @@ -65,8 +65,8 @@ //! let r = hub.pretargeting_config().update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -95,12 +95,12 @@ //! use std::default::Default; //! use adexchangebuyer1d3::{AdExchangeBuyer, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -141,10 +141,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -154,25 +154,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/adexchangebuyer1d4/README.md b/gen/adexchangebuyer1d4/README.md index 01db69ab3d..a451b93b4c 100644 --- a/gen/adexchangebuyer1d4/README.md +++ b/gen/adexchangebuyer1d4/README.md @@ -11,7 +11,7 @@ Everything else about the *Ad Exchange Buyer* *v1d4* API can be found at the [official documentation site](https://developers.google.com/ad-exchange/buyer-rest). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-adexchangebuyer1d4/5.0.3+20210330/google_adexchangebuyer1d4/AdExchangeBuyer) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-adexchangebuyer1d4/5.0.3+20210330/google_adexchangebuyer1d4/AdExchangeBuyer) ... * [accounts](https://docs.rs/google-adexchangebuyer1d4/5.0.3+20210330/google_adexchangebuyer1d4/api::Account) * [*get*](https://docs.rs/google-adexchangebuyer1d4/5.0.3+20210330/google_adexchangebuyer1d4/api::AccountGetCall), [*list*](https://docs.rs/google-adexchangebuyer1d4/5.0.3+20210330/google_adexchangebuyer1d4/api::AccountListCall), [*patch*](https://docs.rs/google-adexchangebuyer1d4/5.0.3+20210330/google_adexchangebuyer1d4/api::AccountPatchCall) and [*update*](https://docs.rs/google-adexchangebuyer1d4/5.0.3+20210330/google_adexchangebuyer1d4/api::AccountUpdateCall) @@ -77,8 +77,8 @@ let r = hub.creatives().list_deals(...).doit().await let r = hub.creatives().remove_deal(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -105,12 +105,12 @@ use adexchangebuyer1d4::{Result, Error}; use std::default::Default; use adexchangebuyer1d4::{AdExchangeBuyer, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -152,10 +152,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-adexchangebuyer1d4/5.0.3+20210330/google_adexchangebuyer1d4/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-adexchangebuyer1d4/5.0.3+20210330/google_adexchangebuyer1d4/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -165,25 +165,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-adexch You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-adexchangebuyer1d4/5.0.3+20210330/google_adexchangebuyer1d4/client::Delegate) to the -[Method Builder](https://docs.rs/google-adexchangebuyer1d4/5.0.3+20210330/google_adexchangebuyer1d4/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-adexchangebuyer1d4/5.0.3+20210330/google_adexchangebuyer1d4/client::Delegate) to the +[Method Builder](https://docs.rs/google-adexchangebuyer1d4/5.0.3+20210330/google_adexchangebuyer1d4/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-adexchangebuyer1d4/5.0.3+20210330/google_adexchangebuyer1d4/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-adexchangebuyer1d4/5.0.3+20210330/google_adexchangebuyer1d4/client::RequestValue) and -[decodable](https://docs.rs/google-adexchangebuyer1d4/5.0.3+20210330/google_adexchangebuyer1d4/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-adexchangebuyer1d4/5.0.3+20210330/google_adexchangebuyer1d4/client::RequestValue) and +[decodable](https://docs.rs/google-adexchangebuyer1d4/5.0.3+20210330/google_adexchangebuyer1d4/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-adexchangebuyer1d4/5.0.3+20210330/google_adexchangebuyer1d4/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-adexchangebuyer1d4/5.0.3+20210330/google_adexchangebuyer1d4/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -202,7 +202,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **adexchangebuyer1d4** library was generated by Sebastian Thiel, and is placed +The **adexchangebuyer1d4** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/adexchangebuyer1d4/src/api.rs b/gen/adexchangebuyer1d4/src/api.rs index 7d660048fa..36bfd37399 100644 --- a/gen/adexchangebuyer1d4/src/api.rs +++ b/gen/adexchangebuyer1d4/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// Manage your Ad Exchange buyer account configuration AdexchangeBuyer, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use adexchangebuyer1d4::{AdExchangeBuyer, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/adexchangebuyer1d4/src/lib.rs b/gen/adexchangebuyer1d4/src/lib.rs index 48da4c6a6c..3fac6a9e13 100644 --- a/gen/adexchangebuyer1d4/src/lib.rs +++ b/gen/adexchangebuyer1d4/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/adexchangebuyer1d4). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](AdExchangeBuyer) ... +//! Handle the following *Resources* with ease from the central [hub](AdExchangeBuyer) ... //! //! * [accounts](api::Account) //! * [*get*](api::AccountGetCall), [*list*](api::AccountListCall), [*patch*](api::AccountPatchCall) and [*update*](api::AccountUpdateCall) @@ -77,8 +77,8 @@ //! let r = hub.creatives().remove_deal(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -106,12 +106,12 @@ //! use std::default::Default; //! use adexchangebuyer1d4::{AdExchangeBuyer, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -153,10 +153,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -166,25 +166,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/adexchangebuyer2_v2_beta1/README.md b/gen/adexchangebuyer2_v2_beta1/README.md index 56f4617dff..ab217c36ef 100644 --- a/gen/adexchangebuyer2_v2_beta1/README.md +++ b/gen/adexchangebuyer2_v2_beta1/README.md @@ -11,7 +11,7 @@ Everything else about the *AdExchangeBuyerII* *v2_beta1* API can be found at the [official documentation site](https://developers.google.com/authorized-buyers/apis/reference/rest/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/AdExchangeBuyerII) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/AdExchangeBuyerII) ... * accounts * [*clients create*](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/api::AccountClientCreateCall), [*clients get*](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/api::AccountClientGetCall), [*clients invitations create*](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/api::AccountClientInvitationCreateCall), [*clients invitations get*](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/api::AccountClientInvitationGetCall), [*clients invitations list*](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/api::AccountClientInvitationListCall), [*clients list*](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/api::AccountClientListCall), [*clients update*](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/api::AccountClientUpdateCall), [*clients users get*](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/api::AccountClientUserGetCall), [*clients users list*](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/api::AccountClientUserListCall), [*clients users update*](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/api::AccountClientUserUpdateCall), [*creatives create*](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/api::AccountCreativeCreateCall), [*creatives deal associations add*](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/api::AccountCreativeDealAssociationAddCall), [*creatives deal associations list*](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/api::AccountCreativeDealAssociationListCall), [*creatives deal associations remove*](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/api::AccountCreativeDealAssociationRemoveCall), [*creatives get*](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/api::AccountCreativeGetCall), [*creatives list*](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/api::AccountCreativeListCall), [*creatives stop watching*](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/api::AccountCreativeStopWatchingCall), [*creatives update*](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/api::AccountCreativeUpdateCall), [*creatives watch*](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/api::AccountCreativeWatchCall), [*finalized proposals list*](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/api::AccountFinalizedProposalListCall), [*finalized proposals pause*](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/api::AccountFinalizedProposalPauseCall), [*finalized proposals resume*](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/api::AccountFinalizedProposalResumeCall), [*products get*](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/api::AccountProductGetCall), [*products list*](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/api::AccountProductListCall), [*proposals accept*](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/api::AccountProposalAcceptCall), [*proposals add note*](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/api::AccountProposalAddNoteCall), [*proposals cancel negotiation*](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/api::AccountProposalCancelNegotiationCall), [*proposals complete setup*](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/api::AccountProposalCompleteSetupCall), [*proposals create*](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/api::AccountProposalCreateCall), [*proposals get*](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/api::AccountProposalGetCall), [*proposals list*](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/api::AccountProposalListCall), [*proposals pause*](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/api::AccountProposalPauseCall), [*proposals resume*](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/api::AccountProposalResumeCall), [*proposals update*](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/api::AccountProposalUpdateCall), [*publisher profiles get*](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/api::AccountPublisherProfileGetCall) and [*publisher profiles list*](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/api::AccountPublisherProfileListCall) @@ -61,8 +61,8 @@ let r = hub.accounts().proposals_resume(...).doit().await let r = hub.accounts().proposals_update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -90,12 +90,12 @@ use adexchangebuyer2_v2_beta1::{Result, Error}; use std::default::Default; use adexchangebuyer2_v2_beta1::{AdExchangeBuyerII, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -136,10 +136,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -149,25 +149,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-adexch You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/client::Delegate) to the -[Method Builder](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/client::Delegate) to the +[Method Builder](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/client::RequestValue) and -[decodable](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/client::RequestValue) and +[decodable](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-adexchangebuyer2_v2_beta1/5.0.3+20230124/google_adexchangebuyer2_v2_beta1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -186,7 +186,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **adexchangebuyer2_v2_beta1** library was generated by Sebastian Thiel, and is placed +The **adexchangebuyer2_v2_beta1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/adexchangebuyer2_v2_beta1/src/api.rs b/gen/adexchangebuyer2_v2_beta1/src/api.rs index 82e162de47..d431ab87de 100644 --- a/gen/adexchangebuyer2_v2_beta1/src/api.rs +++ b/gen/adexchangebuyer2_v2_beta1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// Manage your Ad Exchange buyer account configuration AdexchangeBuyer, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use adexchangebuyer2_v2_beta1::{AdExchangeBuyerII, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/adexchangebuyer2_v2_beta1/src/lib.rs b/gen/adexchangebuyer2_v2_beta1/src/lib.rs index 03fdf154f6..17b5c0d085 100644 --- a/gen/adexchangebuyer2_v2_beta1/src/lib.rs +++ b/gen/adexchangebuyer2_v2_beta1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/adexchangebuyer2_v2_beta1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](AdExchangeBuyerII) ... +//! Handle the following *Resources* with ease from the central [hub](AdExchangeBuyerII) ... //! //! * accounts //! * [*clients create*](api::AccountClientCreateCall), [*clients get*](api::AccountClientGetCall), [*clients invitations create*](api::AccountClientInvitationCreateCall), [*clients invitations get*](api::AccountClientInvitationGetCall), [*clients invitations list*](api::AccountClientInvitationListCall), [*clients list*](api::AccountClientListCall), [*clients update*](api::AccountClientUpdateCall), [*clients users get*](api::AccountClientUserGetCall), [*clients users list*](api::AccountClientUserListCall), [*clients users update*](api::AccountClientUserUpdateCall), [*creatives create*](api::AccountCreativeCreateCall), [*creatives deal associations add*](api::AccountCreativeDealAssociationAddCall), [*creatives deal associations list*](api::AccountCreativeDealAssociationListCall), [*creatives deal associations remove*](api::AccountCreativeDealAssociationRemoveCall), [*creatives get*](api::AccountCreativeGetCall), [*creatives list*](api::AccountCreativeListCall), [*creatives stop watching*](api::AccountCreativeStopWatchingCall), [*creatives update*](api::AccountCreativeUpdateCall), [*creatives watch*](api::AccountCreativeWatchCall), [*finalized proposals list*](api::AccountFinalizedProposalListCall), [*finalized proposals pause*](api::AccountFinalizedProposalPauseCall), [*finalized proposals resume*](api::AccountFinalizedProposalResumeCall), [*products get*](api::AccountProductGetCall), [*products list*](api::AccountProductListCall), [*proposals accept*](api::AccountProposalAcceptCall), [*proposals add note*](api::AccountProposalAddNoteCall), [*proposals cancel negotiation*](api::AccountProposalCancelNegotiationCall), [*proposals complete setup*](api::AccountProposalCompleteSetupCall), [*proposals create*](api::AccountProposalCreateCall), [*proposals get*](api::AccountProposalGetCall), [*proposals list*](api::AccountProposalListCall), [*proposals pause*](api::AccountProposalPauseCall), [*proposals resume*](api::AccountProposalResumeCall), [*proposals update*](api::AccountProposalUpdateCall), [*publisher profiles get*](api::AccountPublisherProfileGetCall) and [*publisher profiles list*](api::AccountPublisherProfileListCall) @@ -61,8 +61,8 @@ //! let r = hub.accounts().proposals_update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -91,12 +91,12 @@ //! use std::default::Default; //! use adexchangebuyer2_v2_beta1::{AdExchangeBuyerII, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -137,10 +137,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -150,25 +150,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/adexchangeseller2/README.md b/gen/adexchangeseller2/README.md index 987e043464..0cd0370fe7 100644 --- a/gen/adexchangeseller2/README.md +++ b/gen/adexchangeseller2/README.md @@ -11,7 +11,7 @@ Everything else about the *Ad Exchange Seller* *v2* API can be found at the [official documentation site](https://developers.google.com/ad-exchange/seller-rest/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-adexchangeseller2/5.0.3+20171101/google_adexchangeseller2/AdExchangeSeller) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-adexchangeseller2/5.0.3+20171101/google_adexchangeseller2/AdExchangeSeller) ... * [accounts](https://docs.rs/google-adexchangeseller2/5.0.3+20171101/google_adexchangeseller2/api::Account) * [*adclients list*](https://docs.rs/google-adexchangeseller2/5.0.3+20171101/google_adexchangeseller2/api::AccountAdclientListCall), [*alerts list*](https://docs.rs/google-adexchangeseller2/5.0.3+20171101/google_adexchangeseller2/api::AccountAlertListCall), [*customchannels get*](https://docs.rs/google-adexchangeseller2/5.0.3+20171101/google_adexchangeseller2/api::AccountCustomchannelGetCall), [*customchannels list*](https://docs.rs/google-adexchangeseller2/5.0.3+20171101/google_adexchangeseller2/api::AccountCustomchannelListCall), [*get*](https://docs.rs/google-adexchangeseller2/5.0.3+20171101/google_adexchangeseller2/api::AccountGetCall), [*list*](https://docs.rs/google-adexchangeseller2/5.0.3+20171101/google_adexchangeseller2/api::AccountListCall), [*metadata dimensions list*](https://docs.rs/google-adexchangeseller2/5.0.3+20171101/google_adexchangeseller2/api::AccountMetadataDimensionListCall), [*metadata metrics list*](https://docs.rs/google-adexchangeseller2/5.0.3+20171101/google_adexchangeseller2/api::AccountMetadataMetricListCall), [*preferreddeals get*](https://docs.rs/google-adexchangeseller2/5.0.3+20171101/google_adexchangeseller2/api::AccountPreferreddealGetCall), [*preferreddeals list*](https://docs.rs/google-adexchangeseller2/5.0.3+20171101/google_adexchangeseller2/api::AccountPreferreddealListCall), [*reports generate*](https://docs.rs/google-adexchangeseller2/5.0.3+20171101/google_adexchangeseller2/api::AccountReportGenerateCall), [*reports saved generate*](https://docs.rs/google-adexchangeseller2/5.0.3+20171101/google_adexchangeseller2/api::AccountReportSavedGenerateCall), [*reports saved list*](https://docs.rs/google-adexchangeseller2/5.0.3+20171101/google_adexchangeseller2/api::AccountReportSavedListCall) and [*urlchannels list*](https://docs.rs/google-adexchangeseller2/5.0.3+20171101/google_adexchangeseller2/api::AccountUrlchannelListCall) @@ -67,8 +67,8 @@ let r = hub.accounts().get(...).doit().await let r = hub.accounts().list(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -95,12 +95,12 @@ use adexchangeseller2::{Result, Error}; use std::default::Default; use adexchangeseller2::{AdExchangeSeller, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -143,10 +143,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-adexchangeseller2/5.0.3+20171101/google_adexchangeseller2/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-adexchangeseller2/5.0.3+20171101/google_adexchangeseller2/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -156,25 +156,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-adexch You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-adexchangeseller2/5.0.3+20171101/google_adexchangeseller2/client::Delegate) to the -[Method Builder](https://docs.rs/google-adexchangeseller2/5.0.3+20171101/google_adexchangeseller2/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-adexchangeseller2/5.0.3+20171101/google_adexchangeseller2/client::Delegate) to the +[Method Builder](https://docs.rs/google-adexchangeseller2/5.0.3+20171101/google_adexchangeseller2/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-adexchangeseller2/5.0.3+20171101/google_adexchangeseller2/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-adexchangeseller2/5.0.3+20171101/google_adexchangeseller2/client::RequestValue) and -[decodable](https://docs.rs/google-adexchangeseller2/5.0.3+20171101/google_adexchangeseller2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-adexchangeseller2/5.0.3+20171101/google_adexchangeseller2/client::RequestValue) and +[decodable](https://docs.rs/google-adexchangeseller2/5.0.3+20171101/google_adexchangeseller2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-adexchangeseller2/5.0.3+20171101/google_adexchangeseller2/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-adexchangeseller2/5.0.3+20171101/google_adexchangeseller2/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -193,7 +193,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **adexchangeseller2** library was generated by Sebastian Thiel, and is placed +The **adexchangeseller2** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/adexchangeseller2/src/api.rs b/gen/adexchangeseller2/src/api.rs index 40b022d383..e8fccd5918 100644 --- a/gen/adexchangeseller2/src/api.rs +++ b/gen/adexchangeseller2/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your Ad Exchange data AdexchangeSeller, @@ -68,12 +68,12 @@ impl Default for Scope { /// use std::default::Default; /// use adexchangeseller2::{AdExchangeSeller, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/adexchangeseller2/src/lib.rs b/gen/adexchangeseller2/src/lib.rs index a8eff815f2..e10bdd3665 100644 --- a/gen/adexchangeseller2/src/lib.rs +++ b/gen/adexchangeseller2/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/adexchangeseller2). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](AdExchangeSeller) ... +//! Handle the following *Resources* with ease from the central [hub](AdExchangeSeller) ... //! //! * [accounts](api::Account) //! * [*adclients list*](api::AccountAdclientListCall), [*alerts list*](api::AccountAlertListCall), [*customchannels get*](api::AccountCustomchannelGetCall), [*customchannels list*](api::AccountCustomchannelListCall), [*get*](api::AccountGetCall), [*list*](api::AccountListCall), [*metadata dimensions list*](api::AccountMetadataDimensionListCall), [*metadata metrics list*](api::AccountMetadataMetricListCall), [*preferreddeals get*](api::AccountPreferreddealGetCall), [*preferreddeals list*](api::AccountPreferreddealListCall), [*reports generate*](api::AccountReportGenerateCall), [*reports saved generate*](api::AccountReportSavedGenerateCall), [*reports saved list*](api::AccountReportSavedListCall) and [*urlchannels list*](api::AccountUrlchannelListCall) @@ -67,8 +67,8 @@ //! let r = hub.accounts().list(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -96,12 +96,12 @@ //! use std::default::Default; //! use adexchangeseller2::{AdExchangeSeller, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -144,10 +144,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -157,25 +157,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/adexperiencereport1/README.md b/gen/adexperiencereport1/README.md index 251a340a21..5534bf82d4 100644 --- a/gen/adexperiencereport1/README.md +++ b/gen/adexperiencereport1/README.md @@ -11,7 +11,7 @@ Everything else about the *Ad Experience Report* *v1* API can be found at the [official documentation site](https://developers.google.com/ad-experience-report/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-adexperiencereport1/5.0.3+20230114/google_adexperiencereport1/AdExperienceReport) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-adexperiencereport1/5.0.3+20230114/google_adexperiencereport1/AdExperienceReport) ... * sites * [*get*](https://docs.rs/google-adexperiencereport1/5.0.3+20230114/google_adexperiencereport1/api::SiteGetCall) @@ -52,8 +52,8 @@ Or specifically ... let r = hub.sites().get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -80,12 +80,12 @@ use adexperiencereport1::{Result, Error}; use std::default::Default; use adexperiencereport1::{AdExperienceReport, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -121,10 +121,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-adexperiencereport1/5.0.3+20230114/google_adexperiencereport1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-adexperiencereport1/5.0.3+20230114/google_adexperiencereport1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -134,25 +134,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-adexpe You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-adexperiencereport1/5.0.3+20230114/google_adexperiencereport1/client::Delegate) to the -[Method Builder](https://docs.rs/google-adexperiencereport1/5.0.3+20230114/google_adexperiencereport1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-adexperiencereport1/5.0.3+20230114/google_adexperiencereport1/client::Delegate) to the +[Method Builder](https://docs.rs/google-adexperiencereport1/5.0.3+20230114/google_adexperiencereport1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-adexperiencereport1/5.0.3+20230114/google_adexperiencereport1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-adexperiencereport1/5.0.3+20230114/google_adexperiencereport1/client::RequestValue) and -[decodable](https://docs.rs/google-adexperiencereport1/5.0.3+20230114/google_adexperiencereport1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-adexperiencereport1/5.0.3+20230114/google_adexperiencereport1/client::RequestValue) and +[decodable](https://docs.rs/google-adexperiencereport1/5.0.3+20230114/google_adexperiencereport1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-adexperiencereport1/5.0.3+20230114/google_adexperiencereport1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-adexperiencereport1/5.0.3+20230114/google_adexperiencereport1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -171,7 +171,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **adexperiencereport1** library was generated by Sebastian Thiel, and is placed +The **adexperiencereport1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/adexperiencereport1/src/api.rs b/gen/adexperiencereport1/src/api.rs index 4fcedfe29c..d573032163 100644 --- a/gen/adexperiencereport1/src/api.rs +++ b/gen/adexperiencereport1/src/api.rs @@ -42,12 +42,12 @@ use crate::{client, client::GetToken, client::serde_with}; /// use std::default::Default; /// use adexperiencereport1::{AdExperienceReport, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/adexperiencereport1/src/lib.rs b/gen/adexperiencereport1/src/lib.rs index ca60cf43a6..8898011c0a 100644 --- a/gen/adexperiencereport1/src/lib.rs +++ b/gen/adexperiencereport1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/adexperiencereport1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](AdExperienceReport) ... +//! Handle the following *Resources* with ease from the central [hub](AdExperienceReport) ... //! //! * sites //! * [*get*](api::SiteGetCall) @@ -52,8 +52,8 @@ //! let r = hub.sites().get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -81,12 +81,12 @@ //! use std::default::Default; //! use adexperiencereport1::{AdExperienceReport, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -122,10 +122,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -135,25 +135,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/admob1/README.md b/gen/admob1/README.md index d49b57a0c1..f4ab08d58d 100644 --- a/gen/admob1/README.md +++ b/gen/admob1/README.md @@ -11,7 +11,7 @@ Everything else about the *AdMob* *v1* API can be found at the [official documentation site](https://developers.google.com/admob/api/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-admob1/5.0.3+20230124/google_admob1/AdMob) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-admob1/5.0.3+20230124/google_admob1/AdMob) ... * accounts * [*ad units list*](https://docs.rs/google-admob1/5.0.3+20230124/google_admob1/api::AccountAdUnitListCall), [*apps list*](https://docs.rs/google-admob1/5.0.3+20230124/google_admob1/api::AccountAppListCall), [*get*](https://docs.rs/google-admob1/5.0.3+20230124/google_admob1/api::AccountGetCall), [*list*](https://docs.rs/google-admob1/5.0.3+20230124/google_admob1/api::AccountListCall), [*mediation report generate*](https://docs.rs/google-admob1/5.0.3+20230124/google_admob1/api::AccountMediationReportGenerateCall) and [*network report generate*](https://docs.rs/google-admob1/5.0.3+20230124/google_admob1/api::AccountNetworkReportGenerateCall) @@ -50,8 +50,8 @@ Or specifically ... let r = hub.accounts().get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -78,12 +78,12 @@ use admob1::{Result, Error}; use std::default::Default; use admob1::{AdMob, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -119,10 +119,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-admob1/5.0.3+20230124/google_admob1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-admob1/5.0.3+20230124/google_admob1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -132,25 +132,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-admob1 You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-admob1/5.0.3+20230124/google_admob1/client::Delegate) to the -[Method Builder](https://docs.rs/google-admob1/5.0.3+20230124/google_admob1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-admob1/5.0.3+20230124/google_admob1/client::Delegate) to the +[Method Builder](https://docs.rs/google-admob1/5.0.3+20230124/google_admob1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-admob1/5.0.3+20230124/google_admob1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-admob1/5.0.3+20230124/google_admob1/client::RequestValue) and -[decodable](https://docs.rs/google-admob1/5.0.3+20230124/google_admob1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-admob1/5.0.3+20230124/google_admob1/client::RequestValue) and +[decodable](https://docs.rs/google-admob1/5.0.3+20230124/google_admob1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-admob1/5.0.3+20230124/google_admob1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-admob1/5.0.3+20230124/google_admob1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -169,7 +169,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **admob1** library was generated by Sebastian Thiel, and is placed +The **admob1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/admob1/src/api.rs b/gen/admob1/src/api.rs index 9b27a19a92..ae92573310 100644 --- a/gen/admob1/src/api.rs +++ b/gen/admob1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See your AdMob data Readonly, @@ -68,12 +68,12 @@ impl Default for Scope { /// use std::default::Default; /// use admob1::{AdMob, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/admob1/src/lib.rs b/gen/admob1/src/lib.rs index 48029df3bc..11f521c5f4 100644 --- a/gen/admob1/src/lib.rs +++ b/gen/admob1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/admob1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](AdMob) ... +//! Handle the following *Resources* with ease from the central [hub](AdMob) ... //! //! * accounts //! * [*ad units list*](api::AccountAdUnitListCall), [*apps list*](api::AccountAppListCall), [*get*](api::AccountGetCall), [*list*](api::AccountListCall), [*mediation report generate*](api::AccountMediationReportGenerateCall) and [*network report generate*](api::AccountNetworkReportGenerateCall) @@ -50,8 +50,8 @@ //! let r = hub.accounts().get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -79,12 +79,12 @@ //! use std::default::Default; //! use admob1::{AdMob, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -120,10 +120,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -133,25 +133,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/adsense1d4/README.md b/gen/adsense1d4/README.md index f229871cf8..1ae2d6798b 100644 --- a/gen/adsense1d4/README.md +++ b/gen/adsense1d4/README.md @@ -11,7 +11,7 @@ Everything else about the *AdSense* *v1d4* API can be found at the [official documentation site](https://developers.google.com/adsense/management/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-adsense1d4/5.0.3+20201002/google_adsense1d4/AdSense) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-adsense1d4/5.0.3+20201002/google_adsense1d4/AdSense) ... * [accounts](https://docs.rs/google-adsense1d4/5.0.3+20201002/google_adsense1d4/api::Account) * [*adclients get ad code*](https://docs.rs/google-adsense1d4/5.0.3+20201002/google_adsense1d4/api::AccountAdclientGetAdCodeCall), [*adclients list*](https://docs.rs/google-adsense1d4/5.0.3+20201002/google_adsense1d4/api::AccountAdclientListCall), [*adunits customchannels list*](https://docs.rs/google-adsense1d4/5.0.3+20201002/google_adsense1d4/api::AccountAdunitCustomchannelListCall), [*adunits get*](https://docs.rs/google-adsense1d4/5.0.3+20201002/google_adsense1d4/api::AccountAdunitGetCall), [*adunits get ad code*](https://docs.rs/google-adsense1d4/5.0.3+20201002/google_adsense1d4/api::AccountAdunitGetAdCodeCall), [*adunits list*](https://docs.rs/google-adsense1d4/5.0.3+20201002/google_adsense1d4/api::AccountAdunitListCall), [*alerts delete*](https://docs.rs/google-adsense1d4/5.0.3+20201002/google_adsense1d4/api::AccountAlertDeleteCall), [*alerts list*](https://docs.rs/google-adsense1d4/5.0.3+20201002/google_adsense1d4/api::AccountAlertListCall), [*customchannels adunits list*](https://docs.rs/google-adsense1d4/5.0.3+20201002/google_adsense1d4/api::AccountCustomchannelAdunitListCall), [*customchannels get*](https://docs.rs/google-adsense1d4/5.0.3+20201002/google_adsense1d4/api::AccountCustomchannelGetCall), [*customchannels list*](https://docs.rs/google-adsense1d4/5.0.3+20201002/google_adsense1d4/api::AccountCustomchannelListCall), [*get*](https://docs.rs/google-adsense1d4/5.0.3+20201002/google_adsense1d4/api::AccountGetCall), [*list*](https://docs.rs/google-adsense1d4/5.0.3+20201002/google_adsense1d4/api::AccountListCall), [*payments list*](https://docs.rs/google-adsense1d4/5.0.3+20201002/google_adsense1d4/api::AccountPaymentListCall), [*reports generate*](https://docs.rs/google-adsense1d4/5.0.3+20201002/google_adsense1d4/api::AccountReportGenerateCall), [*reports saved generate*](https://docs.rs/google-adsense1d4/5.0.3+20201002/google_adsense1d4/api::AccountReportSavedGenerateCall), [*reports saved list*](https://docs.rs/google-adsense1d4/5.0.3+20201002/google_adsense1d4/api::AccountReportSavedListCall), [*savedadstyles get*](https://docs.rs/google-adsense1d4/5.0.3+20201002/google_adsense1d4/api::AccountSavedadstyleGetCall), [*savedadstyles list*](https://docs.rs/google-adsense1d4/5.0.3+20201002/google_adsense1d4/api::AccountSavedadstyleListCall) and [*urlchannels list*](https://docs.rs/google-adsense1d4/5.0.3+20201002/google_adsense1d4/api::AccountUrlchannelListCall) @@ -92,8 +92,8 @@ let r = hub.accounts().get(...).doit().await let r = hub.accounts().list(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -120,12 +120,12 @@ use adsense1d4::{Result, Error}; use std::default::Default; use adsense1d4::{AdSense, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -170,10 +170,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-adsense1d4/5.0.3+20201002/google_adsense1d4/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-adsense1d4/5.0.3+20201002/google_adsense1d4/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -183,25 +183,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-adsens You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-adsense1d4/5.0.3+20201002/google_adsense1d4/client::Delegate) to the -[Method Builder](https://docs.rs/google-adsense1d4/5.0.3+20201002/google_adsense1d4/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-adsense1d4/5.0.3+20201002/google_adsense1d4/client::Delegate) to the +[Method Builder](https://docs.rs/google-adsense1d4/5.0.3+20201002/google_adsense1d4/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-adsense1d4/5.0.3+20201002/google_adsense1d4/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-adsense1d4/5.0.3+20201002/google_adsense1d4/client::RequestValue) and -[decodable](https://docs.rs/google-adsense1d4/5.0.3+20201002/google_adsense1d4/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-adsense1d4/5.0.3+20201002/google_adsense1d4/client::RequestValue) and +[decodable](https://docs.rs/google-adsense1d4/5.0.3+20201002/google_adsense1d4/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-adsense1d4/5.0.3+20201002/google_adsense1d4/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-adsense1d4/5.0.3+20201002/google_adsense1d4/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -220,7 +220,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **adsense1d4** library was generated by Sebastian Thiel, and is placed +The **adsense1d4** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/adsense1d4/src/api.rs b/gen/adsense1d4/src/api.rs index 38c1941e1e..3b11708298 100644 --- a/gen/adsense1d4/src/api.rs +++ b/gen/adsense1d4/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your AdSense data Full, @@ -68,12 +68,12 @@ impl Default for Scope { /// use std::default::Default; /// use adsense1d4::{AdSense, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/adsense1d4/src/lib.rs b/gen/adsense1d4/src/lib.rs index f8ab1c09ac..1eb742faaf 100644 --- a/gen/adsense1d4/src/lib.rs +++ b/gen/adsense1d4/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/adsense1d4). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](AdSense) ... +//! Handle the following *Resources* with ease from the central [hub](AdSense) ... //! //! * [accounts](api::Account) //! * [*adclients get ad code*](api::AccountAdclientGetAdCodeCall), [*adclients list*](api::AccountAdclientListCall), [*adunits customchannels list*](api::AccountAdunitCustomchannelListCall), [*adunits get*](api::AccountAdunitGetCall), [*adunits get ad code*](api::AccountAdunitGetAdCodeCall), [*adunits list*](api::AccountAdunitListCall), [*alerts delete*](api::AccountAlertDeleteCall), [*alerts list*](api::AccountAlertListCall), [*customchannels adunits list*](api::AccountCustomchannelAdunitListCall), [*customchannels get*](api::AccountCustomchannelGetCall), [*customchannels list*](api::AccountCustomchannelListCall), [*get*](api::AccountGetCall), [*list*](api::AccountListCall), [*payments list*](api::AccountPaymentListCall), [*reports generate*](api::AccountReportGenerateCall), [*reports saved generate*](api::AccountReportSavedGenerateCall), [*reports saved list*](api::AccountReportSavedListCall), [*savedadstyles get*](api::AccountSavedadstyleGetCall), [*savedadstyles list*](api::AccountSavedadstyleListCall) and [*urlchannels list*](api::AccountUrlchannelListCall) @@ -92,8 +92,8 @@ //! let r = hub.accounts().list(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -121,12 +121,12 @@ //! use std::default::Default; //! use adsense1d4::{AdSense, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -171,10 +171,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -184,25 +184,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/adsense2/README.md b/gen/adsense2/README.md index bc0de3de31..fcb333b494 100644 --- a/gen/adsense2/README.md +++ b/gen/adsense2/README.md @@ -11,7 +11,7 @@ Everything else about the *adsense* *v2* API can be found at the [official documentation site](https://developers.google.com/adsense/management/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-adsense2/5.0.3+20230124/google_adsense2/Adsense) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-adsense2/5.0.3+20230124/google_adsense2/Adsense) ... * [accounts](https://docs.rs/google-adsense2/5.0.3+20230124/google_adsense2/api::Account) * [*adclients adunits create*](https://docs.rs/google-adsense2/5.0.3+20230124/google_adsense2/api::AccountAdclientAdunitCreateCall), [*adclients adunits get*](https://docs.rs/google-adsense2/5.0.3+20230124/google_adsense2/api::AccountAdclientAdunitGetCall), [*adclients adunits get adcode*](https://docs.rs/google-adsense2/5.0.3+20230124/google_adsense2/api::AccountAdclientAdunitGetAdcodeCall), [*adclients adunits list*](https://docs.rs/google-adsense2/5.0.3+20230124/google_adsense2/api::AccountAdclientAdunitListCall), [*adclients adunits list linked custom channels*](https://docs.rs/google-adsense2/5.0.3+20230124/google_adsense2/api::AccountAdclientAdunitListLinkedCustomChannelCall), [*adclients adunits patch*](https://docs.rs/google-adsense2/5.0.3+20230124/google_adsense2/api::AccountAdclientAdunitPatchCall), [*adclients customchannels create*](https://docs.rs/google-adsense2/5.0.3+20230124/google_adsense2/api::AccountAdclientCustomchannelCreateCall), [*adclients customchannels delete*](https://docs.rs/google-adsense2/5.0.3+20230124/google_adsense2/api::AccountAdclientCustomchannelDeleteCall), [*adclients customchannels get*](https://docs.rs/google-adsense2/5.0.3+20230124/google_adsense2/api::AccountAdclientCustomchannelGetCall), [*adclients customchannels list*](https://docs.rs/google-adsense2/5.0.3+20230124/google_adsense2/api::AccountAdclientCustomchannelListCall), [*adclients customchannels list linked ad units*](https://docs.rs/google-adsense2/5.0.3+20230124/google_adsense2/api::AccountAdclientCustomchannelListLinkedAdUnitCall), [*adclients customchannels patch*](https://docs.rs/google-adsense2/5.0.3+20230124/google_adsense2/api::AccountAdclientCustomchannelPatchCall), [*adclients get*](https://docs.rs/google-adsense2/5.0.3+20230124/google_adsense2/api::AccountAdclientGetCall), [*adclients get adcode*](https://docs.rs/google-adsense2/5.0.3+20230124/google_adsense2/api::AccountAdclientGetAdcodeCall), [*adclients list*](https://docs.rs/google-adsense2/5.0.3+20230124/google_adsense2/api::AccountAdclientListCall), [*adclients urlchannels get*](https://docs.rs/google-adsense2/5.0.3+20230124/google_adsense2/api::AccountAdclientUrlchannelGetCall), [*adclients urlchannels list*](https://docs.rs/google-adsense2/5.0.3+20230124/google_adsense2/api::AccountAdclientUrlchannelListCall), [*alerts list*](https://docs.rs/google-adsense2/5.0.3+20230124/google_adsense2/api::AccountAlertListCall), [*get*](https://docs.rs/google-adsense2/5.0.3+20230124/google_adsense2/api::AccountGetCall), [*get ad blocking recovery tag*](https://docs.rs/google-adsense2/5.0.3+20230124/google_adsense2/api::AccountGetAdBlockingRecoveryTagCall), [*list*](https://docs.rs/google-adsense2/5.0.3+20230124/google_adsense2/api::AccountListCall), [*list child accounts*](https://docs.rs/google-adsense2/5.0.3+20230124/google_adsense2/api::AccountListChildAccountCall), [*payments list*](https://docs.rs/google-adsense2/5.0.3+20230124/google_adsense2/api::AccountPaymentListCall), [*reports generate*](https://docs.rs/google-adsense2/5.0.3+20230124/google_adsense2/api::AccountReportGenerateCall), [*reports generate csv*](https://docs.rs/google-adsense2/5.0.3+20230124/google_adsense2/api::AccountReportGenerateCsvCall), [*reports get saved*](https://docs.rs/google-adsense2/5.0.3+20230124/google_adsense2/api::AccountReportGetSavedCall), [*reports saved generate*](https://docs.rs/google-adsense2/5.0.3+20230124/google_adsense2/api::AccountReportSavedGenerateCall), [*reports saved generate csv*](https://docs.rs/google-adsense2/5.0.3+20230124/google_adsense2/api::AccountReportSavedGenerateCsvCall), [*reports saved list*](https://docs.rs/google-adsense2/5.0.3+20230124/google_adsense2/api::AccountReportSavedListCall), [*sites get*](https://docs.rs/google-adsense2/5.0.3+20230124/google_adsense2/api::AccountSiteGetCall) and [*sites list*](https://docs.rs/google-adsense2/5.0.3+20230124/google_adsense2/api::AccountSiteListCall) @@ -80,8 +80,8 @@ let r = hub.accounts().list(...).doit().await let r = hub.accounts().list_child_accounts(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -108,12 +108,12 @@ use adsense2::{Result, Error}; use std::default::Default; use adsense2::{Adsense, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -164,10 +164,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-adsense2/5.0.3+20230124/google_adsense2/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-adsense2/5.0.3+20230124/google_adsense2/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -177,25 +177,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-adsens You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-adsense2/5.0.3+20230124/google_adsense2/client::Delegate) to the -[Method Builder](https://docs.rs/google-adsense2/5.0.3+20230124/google_adsense2/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-adsense2/5.0.3+20230124/google_adsense2/client::Delegate) to the +[Method Builder](https://docs.rs/google-adsense2/5.0.3+20230124/google_adsense2/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-adsense2/5.0.3+20230124/google_adsense2/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-adsense2/5.0.3+20230124/google_adsense2/client::RequestValue) and -[decodable](https://docs.rs/google-adsense2/5.0.3+20230124/google_adsense2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-adsense2/5.0.3+20230124/google_adsense2/client::RequestValue) and +[decodable](https://docs.rs/google-adsense2/5.0.3+20230124/google_adsense2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-adsense2/5.0.3+20230124/google_adsense2/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-adsense2/5.0.3+20230124/google_adsense2/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -214,7 +214,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **adsense2** library was generated by Sebastian Thiel, and is placed +The **adsense2** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/adsense2/src/api.rs b/gen/adsense2/src/api.rs index 409641b7e9..a40b5b9e55 100644 --- a/gen/adsense2/src/api.rs +++ b/gen/adsense2/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your AdSense data Full, @@ -68,12 +68,12 @@ impl Default for Scope { /// use std::default::Default; /// use adsense2::{Adsense, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/adsense2/src/lib.rs b/gen/adsense2/src/lib.rs index 78a69b7894..dcf29143f1 100644 --- a/gen/adsense2/src/lib.rs +++ b/gen/adsense2/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/adsense2). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Adsense) ... +//! Handle the following *Resources* with ease from the central [hub](Adsense) ... //! //! * [accounts](api::Account) //! * [*adclients adunits create*](api::AccountAdclientAdunitCreateCall), [*adclients adunits get*](api::AccountAdclientAdunitGetCall), [*adclients adunits get adcode*](api::AccountAdclientAdunitGetAdcodeCall), [*adclients adunits list*](api::AccountAdclientAdunitListCall), [*adclients adunits list linked custom channels*](api::AccountAdclientAdunitListLinkedCustomChannelCall), [*adclients adunits patch*](api::AccountAdclientAdunitPatchCall), [*adclients customchannels create*](api::AccountAdclientCustomchannelCreateCall), [*adclients customchannels delete*](api::AccountAdclientCustomchannelDeleteCall), [*adclients customchannels get*](api::AccountAdclientCustomchannelGetCall), [*adclients customchannels list*](api::AccountAdclientCustomchannelListCall), [*adclients customchannels list linked ad units*](api::AccountAdclientCustomchannelListLinkedAdUnitCall), [*adclients customchannels patch*](api::AccountAdclientCustomchannelPatchCall), [*adclients get*](api::AccountAdclientGetCall), [*adclients get adcode*](api::AccountAdclientGetAdcodeCall), [*adclients list*](api::AccountAdclientListCall), [*adclients urlchannels get*](api::AccountAdclientUrlchannelGetCall), [*adclients urlchannels list*](api::AccountAdclientUrlchannelListCall), [*alerts list*](api::AccountAlertListCall), [*get*](api::AccountGetCall), [*get ad blocking recovery tag*](api::AccountGetAdBlockingRecoveryTagCall), [*list*](api::AccountListCall), [*list child accounts*](api::AccountListChildAccountCall), [*payments list*](api::AccountPaymentListCall), [*reports generate*](api::AccountReportGenerateCall), [*reports generate csv*](api::AccountReportGenerateCsvCall), [*reports get saved*](api::AccountReportGetSavedCall), [*reports saved generate*](api::AccountReportSavedGenerateCall), [*reports saved generate csv*](api::AccountReportSavedGenerateCsvCall), [*reports saved list*](api::AccountReportSavedListCall), [*sites get*](api::AccountSiteGetCall) and [*sites list*](api::AccountSiteListCall) @@ -80,8 +80,8 @@ //! let r = hub.accounts().list_child_accounts(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -109,12 +109,12 @@ //! use std::default::Default; //! use adsense2::{Adsense, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -165,10 +165,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -178,25 +178,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/adsensehost4d1/README.md b/gen/adsensehost4d1/README.md index 99ec093a94..56de3d147b 100644 --- a/gen/adsensehost4d1/README.md +++ b/gen/adsensehost4d1/README.md @@ -11,7 +11,7 @@ Everything else about the *AdSense Host* *v4d1* API can be found at the [official documentation site](https://developers.google.com/adsense/host/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-adsensehost4d1/5.0.3+20200930/google_adsensehost4d1/AdSenseHost) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-adsensehost4d1/5.0.3+20200930/google_adsensehost4d1/AdSenseHost) ... * [accounts](https://docs.rs/google-adsensehost4d1/5.0.3+20200930/google_adsensehost4d1/api::Account) * [*adclients get*](https://docs.rs/google-adsensehost4d1/5.0.3+20200930/google_adsensehost4d1/api::AccountAdclientGetCall), [*adclients list*](https://docs.rs/google-adsensehost4d1/5.0.3+20200930/google_adsensehost4d1/api::AccountAdclientListCall), [*adunits delete*](https://docs.rs/google-adsensehost4d1/5.0.3+20200930/google_adsensehost4d1/api::AccountAdunitDeleteCall), [*adunits get*](https://docs.rs/google-adsensehost4d1/5.0.3+20200930/google_adsensehost4d1/api::AccountAdunitGetCall), [*adunits get ad code*](https://docs.rs/google-adsensehost4d1/5.0.3+20200930/google_adsensehost4d1/api::AccountAdunitGetAdCodeCall), [*adunits insert*](https://docs.rs/google-adsensehost4d1/5.0.3+20200930/google_adsensehost4d1/api::AccountAdunitInsertCall), [*adunits list*](https://docs.rs/google-adsensehost4d1/5.0.3+20200930/google_adsensehost4d1/api::AccountAdunitListCall), [*adunits patch*](https://docs.rs/google-adsensehost4d1/5.0.3+20200930/google_adsensehost4d1/api::AccountAdunitPatchCall), [*adunits update*](https://docs.rs/google-adsensehost4d1/5.0.3+20200930/google_adsensehost4d1/api::AccountAdunitUpdateCall), [*get*](https://docs.rs/google-adsensehost4d1/5.0.3+20200930/google_adsensehost4d1/api::AccountGetCall), [*list*](https://docs.rs/google-adsensehost4d1/5.0.3+20200930/google_adsensehost4d1/api::AccountListCall) and [*reports generate*](https://docs.rs/google-adsensehost4d1/5.0.3+20200930/google_adsensehost4d1/api::AccountReportGenerateCall) @@ -71,8 +71,8 @@ let r = hub.accounts().get(...).doit().await let r = hub.accounts().list(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -99,12 +99,12 @@ use adsensehost4d1::{Result, Error}; use std::default::Default; use adsensehost4d1::{AdSenseHost, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -147,10 +147,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-adsensehost4d1/5.0.3+20200930/google_adsensehost4d1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-adsensehost4d1/5.0.3+20200930/google_adsensehost4d1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -160,25 +160,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-adsens You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-adsensehost4d1/5.0.3+20200930/google_adsensehost4d1/client::Delegate) to the -[Method Builder](https://docs.rs/google-adsensehost4d1/5.0.3+20200930/google_adsensehost4d1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-adsensehost4d1/5.0.3+20200930/google_adsensehost4d1/client::Delegate) to the +[Method Builder](https://docs.rs/google-adsensehost4d1/5.0.3+20200930/google_adsensehost4d1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-adsensehost4d1/5.0.3+20200930/google_adsensehost4d1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-adsensehost4d1/5.0.3+20200930/google_adsensehost4d1/client::RequestValue) and -[decodable](https://docs.rs/google-adsensehost4d1/5.0.3+20200930/google_adsensehost4d1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-adsensehost4d1/5.0.3+20200930/google_adsensehost4d1/client::RequestValue) and +[decodable](https://docs.rs/google-adsensehost4d1/5.0.3+20200930/google_adsensehost4d1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-adsensehost4d1/5.0.3+20200930/google_adsensehost4d1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-adsensehost4d1/5.0.3+20200930/google_adsensehost4d1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -197,7 +197,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **adsensehost4d1** library was generated by Sebastian Thiel, and is placed +The **adsensehost4d1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/adsensehost4d1/src/api.rs b/gen/adsensehost4d1/src/api.rs index 2946ee6274..31d44cc9bd 100644 --- a/gen/adsensehost4d1/src/api.rs +++ b/gen/adsensehost4d1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your AdSense host data and associated accounts Full, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use adsensehost4d1::{AdSenseHost, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/adsensehost4d1/src/lib.rs b/gen/adsensehost4d1/src/lib.rs index 71f499e3ca..3d9ee80ad7 100644 --- a/gen/adsensehost4d1/src/lib.rs +++ b/gen/adsensehost4d1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/adsensehost4d1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](AdSenseHost) ... +//! Handle the following *Resources* with ease from the central [hub](AdSenseHost) ... //! //! * [accounts](api::Account) //! * [*adclients get*](api::AccountAdclientGetCall), [*adclients list*](api::AccountAdclientListCall), [*adunits delete*](api::AccountAdunitDeleteCall), [*adunits get*](api::AccountAdunitGetCall), [*adunits get ad code*](api::AccountAdunitGetAdCodeCall), [*adunits insert*](api::AccountAdunitInsertCall), [*adunits list*](api::AccountAdunitListCall), [*adunits patch*](api::AccountAdunitPatchCall), [*adunits update*](api::AccountAdunitUpdateCall), [*get*](api::AccountGetCall), [*list*](api::AccountListCall) and [*reports generate*](api::AccountReportGenerateCall) @@ -71,8 +71,8 @@ //! let r = hub.accounts().list(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -100,12 +100,12 @@ //! use std::default::Default; //! use adsensehost4d1::{AdSenseHost, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -148,10 +148,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -161,25 +161,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/alertcenter1_beta1/README.md b/gen/alertcenter1_beta1/README.md index 03b19cf86c..ff5818e33b 100644 --- a/gen/alertcenter1_beta1/README.md +++ b/gen/alertcenter1_beta1/README.md @@ -11,7 +11,7 @@ Everything else about the *AlertCenter* *v1_beta1* API can be found at the [official documentation site](https://developers.google.com/admin-sdk/alertcenter/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-alertcenter1_beta1/5.0.3+20230123/google_alertcenter1_beta1/AlertCenter) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-alertcenter1_beta1/5.0.3+20230123/google_alertcenter1_beta1/AlertCenter) ... * [alerts](https://docs.rs/google-alertcenter1_beta1/5.0.3+20230123/google_alertcenter1_beta1/api::Alert) * [*batch delete*](https://docs.rs/google-alertcenter1_beta1/5.0.3+20230123/google_alertcenter1_beta1/api::AlertBatchDeleteCall), [*batch undelete*](https://docs.rs/google-alertcenter1_beta1/5.0.3+20230123/google_alertcenter1_beta1/api::AlertBatchUndeleteCall), [*delete*](https://docs.rs/google-alertcenter1_beta1/5.0.3+20230123/google_alertcenter1_beta1/api::AlertDeleteCall), [*feedback create*](https://docs.rs/google-alertcenter1_beta1/5.0.3+20230123/google_alertcenter1_beta1/api::AlertFeedbackCreateCall), [*feedback list*](https://docs.rs/google-alertcenter1_beta1/5.0.3+20230123/google_alertcenter1_beta1/api::AlertFeedbackListCall), [*get*](https://docs.rs/google-alertcenter1_beta1/5.0.3+20230123/google_alertcenter1_beta1/api::AlertGetCall), [*get metadata*](https://docs.rs/google-alertcenter1_beta1/5.0.3+20230123/google_alertcenter1_beta1/api::AlertGetMetadataCall), [*list*](https://docs.rs/google-alertcenter1_beta1/5.0.3+20230123/google_alertcenter1_beta1/api::AlertListCall) and [*undelete*](https://docs.rs/google-alertcenter1_beta1/5.0.3+20230123/google_alertcenter1_beta1/api::AlertUndeleteCall) @@ -62,8 +62,8 @@ let r = hub.alerts().list(...).doit().await let r = hub.alerts().undelete(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -90,12 +90,12 @@ use alertcenter1_beta1::{Result, Error}; use std::default::Default; use alertcenter1_beta1::{AlertCenter, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -136,10 +136,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-alertcenter1_beta1/5.0.3+20230123/google_alertcenter1_beta1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-alertcenter1_beta1/5.0.3+20230123/google_alertcenter1_beta1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -149,25 +149,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-alertc You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-alertcenter1_beta1/5.0.3+20230123/google_alertcenter1_beta1/client::Delegate) to the -[Method Builder](https://docs.rs/google-alertcenter1_beta1/5.0.3+20230123/google_alertcenter1_beta1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-alertcenter1_beta1/5.0.3+20230123/google_alertcenter1_beta1/client::Delegate) to the +[Method Builder](https://docs.rs/google-alertcenter1_beta1/5.0.3+20230123/google_alertcenter1_beta1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-alertcenter1_beta1/5.0.3+20230123/google_alertcenter1_beta1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-alertcenter1_beta1/5.0.3+20230123/google_alertcenter1_beta1/client::RequestValue) and -[decodable](https://docs.rs/google-alertcenter1_beta1/5.0.3+20230123/google_alertcenter1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-alertcenter1_beta1/5.0.3+20230123/google_alertcenter1_beta1/client::RequestValue) and +[decodable](https://docs.rs/google-alertcenter1_beta1/5.0.3+20230123/google_alertcenter1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-alertcenter1_beta1/5.0.3+20230123/google_alertcenter1_beta1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-alertcenter1_beta1/5.0.3+20230123/google_alertcenter1_beta1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -186,7 +186,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **alertcenter1_beta1** library was generated by Sebastian Thiel, and is placed +The **alertcenter1_beta1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/alertcenter1_beta1/src/api.rs b/gen/alertcenter1_beta1/src/api.rs index 4dd43b42d7..be53058e35 100644 --- a/gen/alertcenter1_beta1/src/api.rs +++ b/gen/alertcenter1_beta1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See and delete your domain's G Suite alerts, and send alert feedback AppAlert, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use alertcenter1_beta1::{AlertCenter, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/alertcenter1_beta1/src/lib.rs b/gen/alertcenter1_beta1/src/lib.rs index f2cfe1a242..158216070b 100644 --- a/gen/alertcenter1_beta1/src/lib.rs +++ b/gen/alertcenter1_beta1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/alertcenter1_beta1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](AlertCenter) ... +//! Handle the following *Resources* with ease from the central [hub](AlertCenter) ... //! //! * [alerts](api::Alert) //! * [*batch delete*](api::AlertBatchDeleteCall), [*batch undelete*](api::AlertBatchUndeleteCall), [*delete*](api::AlertDeleteCall), [*feedback create*](api::AlertFeedbackCreateCall), [*feedback list*](api::AlertFeedbackListCall), [*get*](api::AlertGetCall), [*get metadata*](api::AlertGetMetadataCall), [*list*](api::AlertListCall) and [*undelete*](api::AlertUndeleteCall) @@ -62,8 +62,8 @@ //! let r = hub.alerts().undelete(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -91,12 +91,12 @@ //! use std::default::Default; //! use alertcenter1_beta1::{AlertCenter, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -137,10 +137,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -150,25 +150,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/analytics3/README.md b/gen/analytics3/README.md index e4cb35c550..c751639950 100644 --- a/gen/analytics3/README.md +++ b/gen/analytics3/README.md @@ -11,7 +11,7 @@ Everything else about the *analytics* *v3* API can be found at the [official documentation site](https://developers.google.com/analytics/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-analytics3/5.0.3+20190807/google_analytics3/Analytics) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-analytics3/5.0.3+20190807/google_analytics3/Analytics) ... * data * [*ga get*](https://docs.rs/google-analytics3/5.0.3+20190807/google_analytics3/api::DataGaGetCall), [*mcf get*](https://docs.rs/google-analytics3/5.0.3+20190807/google_analytics3/api::DataMcfGetCall) and [*realtime get*](https://docs.rs/google-analytics3/5.0.3+20190807/google_analytics3/api::DataRealtimeGetCall) @@ -67,8 +67,8 @@ let r = hub.management().webproperty_user_links_insert(...).doit().await let r = hub.management().webproperty_user_links_update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -96,12 +96,12 @@ use analytics3::{Result, Error}; use std::default::Default; use analytics3::{Analytics, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -142,10 +142,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-analytics3/5.0.3+20190807/google_analytics3/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-analytics3/5.0.3+20190807/google_analytics3/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -155,25 +155,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-analyt You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-analytics3/5.0.3+20190807/google_analytics3/client::Delegate) to the -[Method Builder](https://docs.rs/google-analytics3/5.0.3+20190807/google_analytics3/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-analytics3/5.0.3+20190807/google_analytics3/client::Delegate) to the +[Method Builder](https://docs.rs/google-analytics3/5.0.3+20190807/google_analytics3/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-analytics3/5.0.3+20190807/google_analytics3/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-analytics3/5.0.3+20190807/google_analytics3/client::RequestValue) and -[decodable](https://docs.rs/google-analytics3/5.0.3+20190807/google_analytics3/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-analytics3/5.0.3+20190807/google_analytics3/client::RequestValue) and +[decodable](https://docs.rs/google-analytics3/5.0.3+20190807/google_analytics3/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-analytics3/5.0.3+20190807/google_analytics3/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-analytics3/5.0.3+20190807/google_analytics3/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -192,7 +192,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **analytics3** library was generated by Sebastian Thiel, and is placed +The **analytics3** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/analytics3/src/api.rs b/gen/analytics3/src/api.rs index 2c4fd66c22..7ab0b0b061 100644 --- a/gen/analytics3/src/api.rs +++ b/gen/analytics3/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your Google Analytics data Full, @@ -89,12 +89,12 @@ impl Default for Scope { /// use std::default::Default; /// use analytics3::{Analytics, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/analytics3/src/lib.rs b/gen/analytics3/src/lib.rs index 52d9479403..7d354e4525 100644 --- a/gen/analytics3/src/lib.rs +++ b/gen/analytics3/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/analytics3). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Analytics) ... +//! Handle the following *Resources* with ease from the central [hub](Analytics) ... //! //! * data //! * [*ga get*](api::DataGaGetCall), [*mcf get*](api::DataMcfGetCall) and [*realtime get*](api::DataRealtimeGetCall) @@ -67,8 +67,8 @@ //! let r = hub.management().webproperty_user_links_update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -97,12 +97,12 @@ //! use std::default::Default; //! use analytics3::{Analytics, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -143,10 +143,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -156,25 +156,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/analyticsadmin1_alpha/README.md b/gen/analyticsadmin1_alpha/README.md index 51be7a90cd..1216f85fd0 100644 --- a/gen/analyticsadmin1_alpha/README.md +++ b/gen/analyticsadmin1_alpha/README.md @@ -11,7 +11,7 @@ Everything else about the *Google Analytics Admin* *v1_alpha* API can be found a [official documentation site](http://code.google.com/apis/analytics/docs/mgmt/home.html). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-analyticsadmin1_alpha/5.0.3+20220307/google_analyticsadmin1_alpha/GoogleAnalyticsAdmin) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-analyticsadmin1_alpha/5.0.3+20220307/google_analyticsadmin1_alpha/GoogleAnalyticsAdmin) ... * account summaries * [*list*](https://docs.rs/google-analyticsadmin1_alpha/5.0.3+20220307/google_analyticsadmin1_alpha/api::AccountSummaryListCall) @@ -67,8 +67,8 @@ let r = hub.properties().user_links_batch_delete(...).doit().await let r = hub.properties().user_links_delete(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -96,12 +96,12 @@ use analyticsadmin1_alpha::{Result, Error}; use std::default::Default; use analyticsadmin1_alpha::{GoogleAnalyticsAdmin, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -142,10 +142,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-analyticsadmin1_alpha/5.0.3+20220307/google_analyticsadmin1_alpha/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-analyticsadmin1_alpha/5.0.3+20220307/google_analyticsadmin1_alpha/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -155,25 +155,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-analyt You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-analyticsadmin1_alpha/5.0.3+20220307/google_analyticsadmin1_alpha/client::Delegate) to the -[Method Builder](https://docs.rs/google-analyticsadmin1_alpha/5.0.3+20220307/google_analyticsadmin1_alpha/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-analyticsadmin1_alpha/5.0.3+20220307/google_analyticsadmin1_alpha/client::Delegate) to the +[Method Builder](https://docs.rs/google-analyticsadmin1_alpha/5.0.3+20220307/google_analyticsadmin1_alpha/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-analyticsadmin1_alpha/5.0.3+20220307/google_analyticsadmin1_alpha/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-analyticsadmin1_alpha/5.0.3+20220307/google_analyticsadmin1_alpha/client::RequestValue) and -[decodable](https://docs.rs/google-analyticsadmin1_alpha/5.0.3+20220307/google_analyticsadmin1_alpha/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-analyticsadmin1_alpha/5.0.3+20220307/google_analyticsadmin1_alpha/client::RequestValue) and +[decodable](https://docs.rs/google-analyticsadmin1_alpha/5.0.3+20220307/google_analyticsadmin1_alpha/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-analyticsadmin1_alpha/5.0.3+20220307/google_analyticsadmin1_alpha/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-analyticsadmin1_alpha/5.0.3+20220307/google_analyticsadmin1_alpha/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -192,7 +192,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **analyticsadmin1_alpha** library was generated by Sebastian Thiel, and is placed +The **analyticsadmin1_alpha** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/analyticsadmin1_alpha/src/api.rs b/gen/analyticsadmin1_alpha/src/api.rs index 3ce2dbb37c..27246c559b 100644 --- a/gen/analyticsadmin1_alpha/src/api.rs +++ b/gen/analyticsadmin1_alpha/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// Edit Google Analytics management entities AnalyticEdit, @@ -77,12 +77,12 @@ impl Default for Scope { /// use std::default::Default; /// use analyticsadmin1_alpha::{GoogleAnalyticsAdmin, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/analyticsadmin1_alpha/src/lib.rs b/gen/analyticsadmin1_alpha/src/lib.rs index 9d919140d4..04eba1a526 100644 --- a/gen/analyticsadmin1_alpha/src/lib.rs +++ b/gen/analyticsadmin1_alpha/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/analyticsadmin1_alpha). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](GoogleAnalyticsAdmin) ... +//! Handle the following *Resources* with ease from the central [hub](GoogleAnalyticsAdmin) ... //! //! * account summaries //! * [*list*](api::AccountSummaryListCall) @@ -67,8 +67,8 @@ //! let r = hub.properties().user_links_delete(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -97,12 +97,12 @@ //! use std::default::Default; //! use analyticsadmin1_alpha::{GoogleAnalyticsAdmin, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -143,10 +143,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -156,25 +156,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/analyticsdata1_beta/README.md b/gen/analyticsdata1_beta/README.md index 3ffb51cece..446aa80eb0 100644 --- a/gen/analyticsdata1_beta/README.md +++ b/gen/analyticsdata1_beta/README.md @@ -11,7 +11,7 @@ Everything else about the *AnalyticsData* *v1_beta* API can be found at the [official documentation site](https://developers.google.com/analytics/devguides/reporting/data/v1/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-analyticsdata1_beta/5.0.3+20230123/google_analyticsdata1_beta/AnalyticsData) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-analyticsdata1_beta/5.0.3+20230123/google_analyticsdata1_beta/AnalyticsData) ... * properties * [*batch run pivot reports*](https://docs.rs/google-analyticsdata1_beta/5.0.3+20230123/google_analyticsdata1_beta/api::PropertyBatchRunPivotReportCall), [*batch run reports*](https://docs.rs/google-analyticsdata1_beta/5.0.3+20230123/google_analyticsdata1_beta/api::PropertyBatchRunReportCall), [*check compatibility*](https://docs.rs/google-analyticsdata1_beta/5.0.3+20230123/google_analyticsdata1_beta/api::PropertyCheckCompatibilityCall), [*get metadata*](https://docs.rs/google-analyticsdata1_beta/5.0.3+20230123/google_analyticsdata1_beta/api::PropertyGetMetadataCall), [*run pivot report*](https://docs.rs/google-analyticsdata1_beta/5.0.3+20230123/google_analyticsdata1_beta/api::PropertyRunPivotReportCall), [*run realtime report*](https://docs.rs/google-analyticsdata1_beta/5.0.3+20230123/google_analyticsdata1_beta/api::PropertyRunRealtimeReportCall) and [*run report*](https://docs.rs/google-analyticsdata1_beta/5.0.3+20230123/google_analyticsdata1_beta/api::PropertyRunReportCall) @@ -50,8 +50,8 @@ Or specifically ... let r = hub.properties().run_report(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -79,12 +79,12 @@ use analyticsdata1_beta::{Result, Error}; use std::default::Default; use analyticsdata1_beta::{AnalyticsData, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -125,10 +125,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-analyticsdata1_beta/5.0.3+20230123/google_analyticsdata1_beta/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-analyticsdata1_beta/5.0.3+20230123/google_analyticsdata1_beta/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -138,25 +138,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-analyt You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-analyticsdata1_beta/5.0.3+20230123/google_analyticsdata1_beta/client::Delegate) to the -[Method Builder](https://docs.rs/google-analyticsdata1_beta/5.0.3+20230123/google_analyticsdata1_beta/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-analyticsdata1_beta/5.0.3+20230123/google_analyticsdata1_beta/client::Delegate) to the +[Method Builder](https://docs.rs/google-analyticsdata1_beta/5.0.3+20230123/google_analyticsdata1_beta/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-analyticsdata1_beta/5.0.3+20230123/google_analyticsdata1_beta/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-analyticsdata1_beta/5.0.3+20230123/google_analyticsdata1_beta/client::RequestValue) and -[decodable](https://docs.rs/google-analyticsdata1_beta/5.0.3+20230123/google_analyticsdata1_beta/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-analyticsdata1_beta/5.0.3+20230123/google_analyticsdata1_beta/client::RequestValue) and +[decodable](https://docs.rs/google-analyticsdata1_beta/5.0.3+20230123/google_analyticsdata1_beta/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-analyticsdata1_beta/5.0.3+20230123/google_analyticsdata1_beta/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-analyticsdata1_beta/5.0.3+20230123/google_analyticsdata1_beta/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -175,7 +175,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **analyticsdata1_beta** library was generated by Sebastian Thiel, and is placed +The **analyticsdata1_beta** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/analyticsdata1_beta/src/api.rs b/gen/analyticsdata1_beta/src/api.rs index 4d04623c77..8b0dd74955 100644 --- a/gen/analyticsdata1_beta/src/api.rs +++ b/gen/analyticsdata1_beta/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your Google Analytics data Analytic, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use analyticsdata1_beta::{AnalyticsData, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/analyticsdata1_beta/src/lib.rs b/gen/analyticsdata1_beta/src/lib.rs index f724ded2e3..4723e825a4 100644 --- a/gen/analyticsdata1_beta/src/lib.rs +++ b/gen/analyticsdata1_beta/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/analyticsdata1_beta). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](AnalyticsData) ... +//! Handle the following *Resources* with ease from the central [hub](AnalyticsData) ... //! //! * properties //! * [*batch run pivot reports*](api::PropertyBatchRunPivotReportCall), [*batch run reports*](api::PropertyBatchRunReportCall), [*check compatibility*](api::PropertyCheckCompatibilityCall), [*get metadata*](api::PropertyGetMetadataCall), [*run pivot report*](api::PropertyRunPivotReportCall), [*run realtime report*](api::PropertyRunRealtimeReportCall) and [*run report*](api::PropertyRunReportCall) @@ -50,8 +50,8 @@ //! let r = hub.properties().run_report(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -80,12 +80,12 @@ //! use std::default::Default; //! use analyticsdata1_beta::{AnalyticsData, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -126,10 +126,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -139,25 +139,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/analyticsreporting4/README.md b/gen/analyticsreporting4/README.md index 39211ecb9b..513b43b008 100644 --- a/gen/analyticsreporting4/README.md +++ b/gen/analyticsreporting4/README.md @@ -11,7 +11,7 @@ Everything else about the *AnalyticsReporting* *v4* API can be found at the [official documentation site](https://developers.google.com/analytics/devguides/reporting/core/v4/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-analyticsreporting4/5.0.3+20221104/google_analyticsreporting4/AnalyticsReporting) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-analyticsreporting4/5.0.3+20221104/google_analyticsreporting4/AnalyticsReporting) ... * [reports](https://docs.rs/google-analyticsreporting4/5.0.3+20221104/google_analyticsreporting4/api::Report) * [*batch get*](https://docs.rs/google-analyticsreporting4/5.0.3+20221104/google_analyticsreporting4/api::ReportBatchGetCall) @@ -52,8 +52,8 @@ Or specifically ... let r = hub.user_activity().search(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -81,12 +81,12 @@ use analyticsreporting4::{Result, Error}; use std::default::Default; use analyticsreporting4::{AnalyticsReporting, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -127,10 +127,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-analyticsreporting4/5.0.3+20221104/google_analyticsreporting4/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-analyticsreporting4/5.0.3+20221104/google_analyticsreporting4/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -140,25 +140,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-analyt You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-analyticsreporting4/5.0.3+20221104/google_analyticsreporting4/client::Delegate) to the -[Method Builder](https://docs.rs/google-analyticsreporting4/5.0.3+20221104/google_analyticsreporting4/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-analyticsreporting4/5.0.3+20221104/google_analyticsreporting4/client::Delegate) to the +[Method Builder](https://docs.rs/google-analyticsreporting4/5.0.3+20221104/google_analyticsreporting4/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-analyticsreporting4/5.0.3+20221104/google_analyticsreporting4/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-analyticsreporting4/5.0.3+20221104/google_analyticsreporting4/client::RequestValue) and -[decodable](https://docs.rs/google-analyticsreporting4/5.0.3+20221104/google_analyticsreporting4/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-analyticsreporting4/5.0.3+20221104/google_analyticsreporting4/client::RequestValue) and +[decodable](https://docs.rs/google-analyticsreporting4/5.0.3+20221104/google_analyticsreporting4/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-analyticsreporting4/5.0.3+20221104/google_analyticsreporting4/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-analyticsreporting4/5.0.3+20221104/google_analyticsreporting4/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -177,7 +177,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **analyticsreporting4** library was generated by Sebastian Thiel, and is placed +The **analyticsreporting4** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/analyticsreporting4/src/api.rs b/gen/analyticsreporting4/src/api.rs index ee8309e9ac..2cade67e3b 100644 --- a/gen/analyticsreporting4/src/api.rs +++ b/gen/analyticsreporting4/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your Google Analytics data Analytic, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use analyticsreporting4::{AnalyticsReporting, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/analyticsreporting4/src/lib.rs b/gen/analyticsreporting4/src/lib.rs index 530c5d11ed..1c6c34a04a 100644 --- a/gen/analyticsreporting4/src/lib.rs +++ b/gen/analyticsreporting4/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/analyticsreporting4). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](AnalyticsReporting) ... +//! Handle the following *Resources* with ease from the central [hub](AnalyticsReporting) ... //! //! * [reports](api::Report) //! * [*batch get*](api::ReportBatchGetCall) @@ -52,8 +52,8 @@ //! let r = hub.user_activity().search(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -82,12 +82,12 @@ //! use std::default::Default; //! use analyticsreporting4::{AnalyticsReporting, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -128,10 +128,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -141,25 +141,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/androiddeviceprovisioning1/README.md b/gen/androiddeviceprovisioning1/README.md index 05e4a26f31..162ed093f5 100644 --- a/gen/androiddeviceprovisioning1/README.md +++ b/gen/androiddeviceprovisioning1/README.md @@ -11,7 +11,7 @@ Everything else about the *Android Provisioning Partner* *v1* API can be found a [official documentation site](https://developers.google.com/zero-touch/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-androiddeviceprovisioning1/5.0.3+20230115/google_androiddeviceprovisioning1/AndroidProvisioningPartner) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-androiddeviceprovisioning1/5.0.3+20230115/google_androiddeviceprovisioning1/AndroidProvisioningPartner) ... * customers * [*configurations create*](https://docs.rs/google-androiddeviceprovisioning1/5.0.3+20230115/google_androiddeviceprovisioning1/api::CustomerConfigurationCreateCall), [*configurations delete*](https://docs.rs/google-androiddeviceprovisioning1/5.0.3+20230115/google_androiddeviceprovisioning1/api::CustomerConfigurationDeleteCall), [*configurations get*](https://docs.rs/google-androiddeviceprovisioning1/5.0.3+20230115/google_androiddeviceprovisioning1/api::CustomerConfigurationGetCall), [*configurations list*](https://docs.rs/google-androiddeviceprovisioning1/5.0.3+20230115/google_androiddeviceprovisioning1/api::CustomerConfigurationListCall), [*configurations patch*](https://docs.rs/google-androiddeviceprovisioning1/5.0.3+20230115/google_androiddeviceprovisioning1/api::CustomerConfigurationPatchCall), [*devices apply configuration*](https://docs.rs/google-androiddeviceprovisioning1/5.0.3+20230115/google_androiddeviceprovisioning1/api::CustomerDeviceApplyConfigurationCall), [*devices get*](https://docs.rs/google-androiddeviceprovisioning1/5.0.3+20230115/google_androiddeviceprovisioning1/api::CustomerDeviceGetCall), [*devices list*](https://docs.rs/google-androiddeviceprovisioning1/5.0.3+20230115/google_androiddeviceprovisioning1/api::CustomerDeviceListCall), [*devices remove configuration*](https://docs.rs/google-androiddeviceprovisioning1/5.0.3+20230115/google_androiddeviceprovisioning1/api::CustomerDeviceRemoveConfigurationCall), [*devices unclaim*](https://docs.rs/google-androiddeviceprovisioning1/5.0.3+20230115/google_androiddeviceprovisioning1/api::CustomerDeviceUnclaimCall), [*dpcs list*](https://docs.rs/google-androiddeviceprovisioning1/5.0.3+20230115/google_androiddeviceprovisioning1/api::CustomerDpcListCall) and [*list*](https://docs.rs/google-androiddeviceprovisioning1/5.0.3+20230115/google_androiddeviceprovisioning1/api::CustomerListCall) @@ -58,8 +58,8 @@ let r = hub.customers().devices_unclaim(...).doit().await let r = hub.partners().devices_unclaim(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -87,12 +87,12 @@ use androiddeviceprovisioning1::{Result, Error}; use std::default::Default; use androiddeviceprovisioning1::{AndroidProvisioningPartner, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -133,10 +133,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-androiddeviceprovisioning1/5.0.3+20230115/google_androiddeviceprovisioning1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-androiddeviceprovisioning1/5.0.3+20230115/google_androiddeviceprovisioning1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -146,25 +146,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-androi You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-androiddeviceprovisioning1/5.0.3+20230115/google_androiddeviceprovisioning1/client::Delegate) to the -[Method Builder](https://docs.rs/google-androiddeviceprovisioning1/5.0.3+20230115/google_androiddeviceprovisioning1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-androiddeviceprovisioning1/5.0.3+20230115/google_androiddeviceprovisioning1/client::Delegate) to the +[Method Builder](https://docs.rs/google-androiddeviceprovisioning1/5.0.3+20230115/google_androiddeviceprovisioning1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-androiddeviceprovisioning1/5.0.3+20230115/google_androiddeviceprovisioning1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-androiddeviceprovisioning1/5.0.3+20230115/google_androiddeviceprovisioning1/client::RequestValue) and -[decodable](https://docs.rs/google-androiddeviceprovisioning1/5.0.3+20230115/google_androiddeviceprovisioning1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-androiddeviceprovisioning1/5.0.3+20230115/google_androiddeviceprovisioning1/client::RequestValue) and +[decodable](https://docs.rs/google-androiddeviceprovisioning1/5.0.3+20230115/google_androiddeviceprovisioning1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-androiddeviceprovisioning1/5.0.3+20230115/google_androiddeviceprovisioning1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-androiddeviceprovisioning1/5.0.3+20230115/google_androiddeviceprovisioning1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -183,7 +183,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **androiddeviceprovisioning1** library was generated by Sebastian Thiel, and is placed +The **androiddeviceprovisioning1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/androiddeviceprovisioning1/src/api.rs b/gen/androiddeviceprovisioning1/src/api.rs index ff06ce03fa..39aeb40b7b 100644 --- a/gen/androiddeviceprovisioning1/src/api.rs +++ b/gen/androiddeviceprovisioning1/src/api.rs @@ -43,12 +43,12 @@ use crate::{client, client::GetToken, client::serde_with}; /// use std::default::Default; /// use androiddeviceprovisioning1::{AndroidProvisioningPartner, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/androiddeviceprovisioning1/src/lib.rs b/gen/androiddeviceprovisioning1/src/lib.rs index 3e5914e2bf..8c4cf7c7ec 100644 --- a/gen/androiddeviceprovisioning1/src/lib.rs +++ b/gen/androiddeviceprovisioning1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/androiddeviceprovisioning1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](AndroidProvisioningPartner) ... +//! Handle the following *Resources* with ease from the central [hub](AndroidProvisioningPartner) ... //! //! * customers //! * [*configurations create*](api::CustomerConfigurationCreateCall), [*configurations delete*](api::CustomerConfigurationDeleteCall), [*configurations get*](api::CustomerConfigurationGetCall), [*configurations list*](api::CustomerConfigurationListCall), [*configurations patch*](api::CustomerConfigurationPatchCall), [*devices apply configuration*](api::CustomerDeviceApplyConfigurationCall), [*devices get*](api::CustomerDeviceGetCall), [*devices list*](api::CustomerDeviceListCall), [*devices remove configuration*](api::CustomerDeviceRemoveConfigurationCall), [*devices unclaim*](api::CustomerDeviceUnclaimCall), [*dpcs list*](api::CustomerDpcListCall) and [*list*](api::CustomerListCall) @@ -58,8 +58,8 @@ //! let r = hub.partners().devices_unclaim(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -88,12 +88,12 @@ //! use std::default::Default; //! use androiddeviceprovisioning1::{AndroidProvisioningPartner, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -134,10 +134,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -147,25 +147,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/androidenterprise1/README.md b/gen/androidenterprise1/README.md index fb9ebf72f5..b211931bea 100644 --- a/gen/androidenterprise1/README.md +++ b/gen/androidenterprise1/README.md @@ -11,7 +11,7 @@ Everything else about the *Android Enterprise* *v1* API can be found at the [official documentation site](https://developers.google.com/android/work/play/emm-api). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-androidenterprise1/5.0.3+20230123/google_androidenterprise1/AndroidEnterprise) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-androidenterprise1/5.0.3+20230123/google_androidenterprise1/AndroidEnterprise) ... * [devices](https://docs.rs/google-androidenterprise1/5.0.3+20230123/google_androidenterprise1/api::Device) * [*force report upload*](https://docs.rs/google-androidenterprise1/5.0.3+20230123/google_androidenterprise1/api::DeviceForceReportUploadCall), [*get*](https://docs.rs/google-androidenterprise1/5.0.3+20230123/google_androidenterprise1/api::DeviceGetCall), [*get state*](https://docs.rs/google-androidenterprise1/5.0.3+20230123/google_androidenterprise1/api::DeviceGetStateCall), [*list*](https://docs.rs/google-androidenterprise1/5.0.3+20230123/google_androidenterprise1/api::DeviceListCall), [*set state*](https://docs.rs/google-androidenterprise1/5.0.3+20230123/google_androidenterprise1/api::DeviceSetStateCall) and [*update*](https://docs.rs/google-androidenterprise1/5.0.3+20230123/google_androidenterprise1/api::DeviceUpdateCall) @@ -94,8 +94,8 @@ let r = hub.enterprises().set_store_layout(...).doit().await let r = hub.enterprises().unenroll(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -122,12 +122,12 @@ use androidenterprise1::{Result, Error}; use std::default::Default; use androidenterprise1::{AndroidEnterprise, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -165,10 +165,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-androidenterprise1/5.0.3+20230123/google_androidenterprise1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-androidenterprise1/5.0.3+20230123/google_androidenterprise1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -178,25 +178,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-androi You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-androidenterprise1/5.0.3+20230123/google_androidenterprise1/client::Delegate) to the -[Method Builder](https://docs.rs/google-androidenterprise1/5.0.3+20230123/google_androidenterprise1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-androidenterprise1/5.0.3+20230123/google_androidenterprise1/client::Delegate) to the +[Method Builder](https://docs.rs/google-androidenterprise1/5.0.3+20230123/google_androidenterprise1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-androidenterprise1/5.0.3+20230123/google_androidenterprise1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-androidenterprise1/5.0.3+20230123/google_androidenterprise1/client::RequestValue) and -[decodable](https://docs.rs/google-androidenterprise1/5.0.3+20230123/google_androidenterprise1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-androidenterprise1/5.0.3+20230123/google_androidenterprise1/client::RequestValue) and +[decodable](https://docs.rs/google-androidenterprise1/5.0.3+20230123/google_androidenterprise1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-androidenterprise1/5.0.3+20230123/google_androidenterprise1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-androidenterprise1/5.0.3+20230123/google_androidenterprise1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -215,7 +215,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **androidenterprise1** library was generated by Sebastian Thiel, and is placed +The **androidenterprise1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/androidenterprise1/src/api.rs b/gen/androidenterprise1/src/api.rs index f1448db2f4..11dc82a114 100644 --- a/gen/androidenterprise1/src/api.rs +++ b/gen/androidenterprise1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// Manage corporate Android devices Full, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use androidenterprise1::{AndroidEnterprise, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/androidenterprise1/src/lib.rs b/gen/androidenterprise1/src/lib.rs index 6e0672b1a4..af711bb83c 100644 --- a/gen/androidenterprise1/src/lib.rs +++ b/gen/androidenterprise1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/androidenterprise1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](AndroidEnterprise) ... +//! Handle the following *Resources* with ease from the central [hub](AndroidEnterprise) ... //! //! * [devices](api::Device) //! * [*force report upload*](api::DeviceForceReportUploadCall), [*get*](api::DeviceGetCall), [*get state*](api::DeviceGetStateCall), [*list*](api::DeviceListCall), [*set state*](api::DeviceSetStateCall) and [*update*](api::DeviceUpdateCall) @@ -94,8 +94,8 @@ //! let r = hub.enterprises().unenroll(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -123,12 +123,12 @@ //! use std::default::Default; //! use androidenterprise1::{AndroidEnterprise, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -166,10 +166,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -179,25 +179,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/androidmanagement1/README.md b/gen/androidmanagement1/README.md index e721bae617..7b786ed734 100644 --- a/gen/androidmanagement1/README.md +++ b/gen/androidmanagement1/README.md @@ -11,7 +11,7 @@ Everything else about the *Android Management* *v1* API can be found at the [official documentation site](https://developers.google.com/android/management). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-androidmanagement1/5.0.3+20230119/google_androidmanagement1/AndroidManagement) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-androidmanagement1/5.0.3+20230119/google_androidmanagement1/AndroidManagement) ... * [enterprises](https://docs.rs/google-androidmanagement1/5.0.3+20230119/google_androidmanagement1/api::Enterprise) * [*applications get*](https://docs.rs/google-androidmanagement1/5.0.3+20230119/google_androidmanagement1/api::EnterpriseApplicationGetCall), [*create*](https://docs.rs/google-androidmanagement1/5.0.3+20230119/google_androidmanagement1/api::EnterpriseCreateCall), [*delete*](https://docs.rs/google-androidmanagement1/5.0.3+20230119/google_androidmanagement1/api::EnterpriseDeleteCall), [*devices delete*](https://docs.rs/google-androidmanagement1/5.0.3+20230119/google_androidmanagement1/api::EnterpriseDeviceDeleteCall), [*devices get*](https://docs.rs/google-androidmanagement1/5.0.3+20230119/google_androidmanagement1/api::EnterpriseDeviceGetCall), [*devices issue command*](https://docs.rs/google-androidmanagement1/5.0.3+20230119/google_androidmanagement1/api::EnterpriseDeviceIssueCommandCall), [*devices list*](https://docs.rs/google-androidmanagement1/5.0.3+20230119/google_androidmanagement1/api::EnterpriseDeviceListCall), [*devices operations cancel*](https://docs.rs/google-androidmanagement1/5.0.3+20230119/google_androidmanagement1/api::EnterpriseDeviceOperationCancelCall), [*devices operations delete*](https://docs.rs/google-androidmanagement1/5.0.3+20230119/google_androidmanagement1/api::EnterpriseDeviceOperationDeleteCall), [*devices operations get*](https://docs.rs/google-androidmanagement1/5.0.3+20230119/google_androidmanagement1/api::EnterpriseDeviceOperationGetCall), [*devices operations list*](https://docs.rs/google-androidmanagement1/5.0.3+20230119/google_androidmanagement1/api::EnterpriseDeviceOperationListCall), [*devices patch*](https://docs.rs/google-androidmanagement1/5.0.3+20230119/google_androidmanagement1/api::EnterpriseDevicePatchCall), [*enrollment tokens create*](https://docs.rs/google-androidmanagement1/5.0.3+20230119/google_androidmanagement1/api::EnterpriseEnrollmentTokenCreateCall), [*enrollment tokens delete*](https://docs.rs/google-androidmanagement1/5.0.3+20230119/google_androidmanagement1/api::EnterpriseEnrollmentTokenDeleteCall), [*enrollment tokens get*](https://docs.rs/google-androidmanagement1/5.0.3+20230119/google_androidmanagement1/api::EnterpriseEnrollmentTokenGetCall), [*enrollment tokens list*](https://docs.rs/google-androidmanagement1/5.0.3+20230119/google_androidmanagement1/api::EnterpriseEnrollmentTokenListCall), [*get*](https://docs.rs/google-androidmanagement1/5.0.3+20230119/google_androidmanagement1/api::EnterpriseGetCall), [*list*](https://docs.rs/google-androidmanagement1/5.0.3+20230119/google_androidmanagement1/api::EnterpriseListCall), [*patch*](https://docs.rs/google-androidmanagement1/5.0.3+20230119/google_androidmanagement1/api::EnterprisePatchCall), [*policies delete*](https://docs.rs/google-androidmanagement1/5.0.3+20230119/google_androidmanagement1/api::EnterprisePolicyDeleteCall), [*policies get*](https://docs.rs/google-androidmanagement1/5.0.3+20230119/google_androidmanagement1/api::EnterprisePolicyGetCall), [*policies list*](https://docs.rs/google-androidmanagement1/5.0.3+20230119/google_androidmanagement1/api::EnterprisePolicyListCall), [*policies patch*](https://docs.rs/google-androidmanagement1/5.0.3+20230119/google_androidmanagement1/api::EnterprisePolicyPatchCall), [*web apps create*](https://docs.rs/google-androidmanagement1/5.0.3+20230119/google_androidmanagement1/api::EnterpriseWebAppCreateCall), [*web apps delete*](https://docs.rs/google-androidmanagement1/5.0.3+20230119/google_androidmanagement1/api::EnterpriseWebAppDeleteCall), [*web apps get*](https://docs.rs/google-androidmanagement1/5.0.3+20230119/google_androidmanagement1/api::EnterpriseWebAppGetCall), [*web apps list*](https://docs.rs/google-androidmanagement1/5.0.3+20230119/google_androidmanagement1/api::EnterpriseWebAppListCall), [*web apps patch*](https://docs.rs/google-androidmanagement1/5.0.3+20230119/google_androidmanagement1/api::EnterpriseWebAppPatchCall) and [*web tokens create*](https://docs.rs/google-androidmanagement1/5.0.3+20230119/google_androidmanagement1/api::EnterpriseWebTokenCreateCall) @@ -80,8 +80,8 @@ let r = hub.enterprises().list(...).doit().await let r = hub.enterprises().patch(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -109,12 +109,12 @@ use androidmanagement1::{Result, Error}; use std::default::Default; use androidmanagement1::{AndroidManagement, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -159,10 +159,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-androidmanagement1/5.0.3+20230119/google_androidmanagement1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-androidmanagement1/5.0.3+20230119/google_androidmanagement1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -172,25 +172,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-androi You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-androidmanagement1/5.0.3+20230119/google_androidmanagement1/client::Delegate) to the -[Method Builder](https://docs.rs/google-androidmanagement1/5.0.3+20230119/google_androidmanagement1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-androidmanagement1/5.0.3+20230119/google_androidmanagement1/client::Delegate) to the +[Method Builder](https://docs.rs/google-androidmanagement1/5.0.3+20230119/google_androidmanagement1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-androidmanagement1/5.0.3+20230119/google_androidmanagement1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-androidmanagement1/5.0.3+20230119/google_androidmanagement1/client::RequestValue) and -[decodable](https://docs.rs/google-androidmanagement1/5.0.3+20230119/google_androidmanagement1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-androidmanagement1/5.0.3+20230119/google_androidmanagement1/client::RequestValue) and +[decodable](https://docs.rs/google-androidmanagement1/5.0.3+20230119/google_androidmanagement1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-androidmanagement1/5.0.3+20230119/google_androidmanagement1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-androidmanagement1/5.0.3+20230119/google_androidmanagement1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -209,7 +209,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **androidmanagement1** library was generated by Sebastian Thiel, and is placed +The **androidmanagement1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/androidmanagement1/src/api.rs b/gen/androidmanagement1/src/api.rs index a31686741f..dbb9208a3f 100644 --- a/gen/androidmanagement1/src/api.rs +++ b/gen/androidmanagement1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// Manage Android devices and apps for your customers Full, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use androidmanagement1::{AndroidManagement, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/androidmanagement1/src/lib.rs b/gen/androidmanagement1/src/lib.rs index 716de95682..f1eae78b15 100644 --- a/gen/androidmanagement1/src/lib.rs +++ b/gen/androidmanagement1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/androidmanagement1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](AndroidManagement) ... +//! Handle the following *Resources* with ease from the central [hub](AndroidManagement) ... //! //! * [enterprises](api::Enterprise) //! * [*applications get*](api::EnterpriseApplicationGetCall), [*create*](api::EnterpriseCreateCall), [*delete*](api::EnterpriseDeleteCall), [*devices delete*](api::EnterpriseDeviceDeleteCall), [*devices get*](api::EnterpriseDeviceGetCall), [*devices issue command*](api::EnterpriseDeviceIssueCommandCall), [*devices list*](api::EnterpriseDeviceListCall), [*devices operations cancel*](api::EnterpriseDeviceOperationCancelCall), [*devices operations delete*](api::EnterpriseDeviceOperationDeleteCall), [*devices operations get*](api::EnterpriseDeviceOperationGetCall), [*devices operations list*](api::EnterpriseDeviceOperationListCall), [*devices patch*](api::EnterpriseDevicePatchCall), [*enrollment tokens create*](api::EnterpriseEnrollmentTokenCreateCall), [*enrollment tokens delete*](api::EnterpriseEnrollmentTokenDeleteCall), [*enrollment tokens get*](api::EnterpriseEnrollmentTokenGetCall), [*enrollment tokens list*](api::EnterpriseEnrollmentTokenListCall), [*get*](api::EnterpriseGetCall), [*list*](api::EnterpriseListCall), [*patch*](api::EnterprisePatchCall), [*policies delete*](api::EnterprisePolicyDeleteCall), [*policies get*](api::EnterprisePolicyGetCall), [*policies list*](api::EnterprisePolicyListCall), [*policies patch*](api::EnterprisePolicyPatchCall), [*web apps create*](api::EnterpriseWebAppCreateCall), [*web apps delete*](api::EnterpriseWebAppDeleteCall), [*web apps get*](api::EnterpriseWebAppGetCall), [*web apps list*](api::EnterpriseWebAppListCall), [*web apps patch*](api::EnterpriseWebAppPatchCall) and [*web tokens create*](api::EnterpriseWebTokenCreateCall) @@ -80,8 +80,8 @@ //! let r = hub.enterprises().patch(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -110,12 +110,12 @@ //! use std::default::Default; //! use androidmanagement1::{AndroidManagement, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -160,10 +160,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -173,25 +173,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/androidpublisher2/README.md b/gen/androidpublisher2/README.md index 67b2b3a27b..af7e43a2d3 100644 --- a/gen/androidpublisher2/README.md +++ b/gen/androidpublisher2/README.md @@ -11,7 +11,7 @@ Everything else about the *Android Publisher* *v2* API can be found at the [official documentation site](https://developers.google.com/android-publisher). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/AndroidPublisher) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/AndroidPublisher) ... * edits * [*apklistings delete*](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/api::EditApklistingDeleteCall), [*apklistings deleteall*](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/api::EditApklistingDeleteallCall), [*apklistings get*](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/api::EditApklistingGetCall), [*apklistings list*](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/api::EditApklistingListCall), [*apklistings patch*](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/api::EditApklistingPatchCall), [*apklistings update*](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/api::EditApklistingUpdateCall), [*apks addexternallyhosted*](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/api::EditApkAddexternallyhostedCall), [*apks list*](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/api::EditApkListCall), [*apks upload*](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/api::EditApkUploadCall), [*bundles list*](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/api::EditBundleListCall), [*bundles upload*](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/api::EditBundleUploadCall), [*commit*](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/api::EditCommitCall), [*delete*](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/api::EditDeleteCall), [*deobfuscationfiles upload*](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/api::EditDeobfuscationfileUploadCall), [*details get*](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/api::EditDetailGetCall), [*details patch*](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/api::EditDetailPatchCall), [*details update*](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/api::EditDetailUpdateCall), [*expansionfiles get*](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/api::EditExpansionfileGetCall), [*expansionfiles patch*](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/api::EditExpansionfilePatchCall), [*expansionfiles update*](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/api::EditExpansionfileUpdateCall), [*expansionfiles upload*](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/api::EditExpansionfileUploadCall), [*get*](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/api::EditGetCall), [*images delete*](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/api::EditImageDeleteCall), [*images deleteall*](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/api::EditImageDeleteallCall), [*images list*](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/api::EditImageListCall), [*images upload*](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/api::EditImageUploadCall), [*insert*](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/api::EditInsertCall), [*listings delete*](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/api::EditListingDeleteCall), [*listings deleteall*](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/api::EditListingDeleteallCall), [*listings get*](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/api::EditListingGetCall), [*listings list*](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/api::EditListingListCall), [*listings patch*](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/api::EditListingPatchCall), [*listings update*](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/api::EditListingUpdateCall), [*testers get*](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/api::EditTesterGetCall), [*testers patch*](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/api::EditTesterPatchCall), [*testers update*](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/api::EditTesterUpdateCall), [*tracks get*](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/api::EditTrackGetCall), [*tracks list*](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/api::EditTrackListCall), [*tracks patch*](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/api::EditTrackPatchCall), [*tracks update*](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/api::EditTrackUpdateCall) and [*validate*](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/api::EditValidateCall) @@ -69,8 +69,8 @@ let r = hub.inappproducts().patch(...).doit().await let r = hub.inappproducts().update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -98,12 +98,12 @@ use androidpublisher2::{Result, Error}; use std::default::Default; use androidpublisher2::{AndroidPublisher, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -145,10 +145,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -158,25 +158,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-androi You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/client::Delegate) to the -[Method Builder](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/client::Delegate) to the +[Method Builder](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/client::RequestValue) and -[decodable](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/client::RequestValue) and +[decodable](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-androidpublisher2/5.0.3+20200331/google_androidpublisher2/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -195,7 +195,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **androidpublisher2** library was generated by Sebastian Thiel, and is placed +The **androidpublisher2** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/androidpublisher2/src/api.rs b/gen/androidpublisher2/src/api.rs index 70e3e0bc35..7a715cdcee 100644 --- a/gen/androidpublisher2/src/api.rs +++ b/gen/androidpublisher2/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your Google Play Developer account Full, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use androidpublisher2::{AndroidPublisher, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/androidpublisher2/src/lib.rs b/gen/androidpublisher2/src/lib.rs index a912d147f8..062e997240 100644 --- a/gen/androidpublisher2/src/lib.rs +++ b/gen/androidpublisher2/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/androidpublisher2). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](AndroidPublisher) ... +//! Handle the following *Resources* with ease from the central [hub](AndroidPublisher) ... //! //! * edits //! * [*apklistings delete*](api::EditApklistingDeleteCall), [*apklistings deleteall*](api::EditApklistingDeleteallCall), [*apklistings get*](api::EditApklistingGetCall), [*apklistings list*](api::EditApklistingListCall), [*apklistings patch*](api::EditApklistingPatchCall), [*apklistings update*](api::EditApklistingUpdateCall), [*apks addexternallyhosted*](api::EditApkAddexternallyhostedCall), [*apks list*](api::EditApkListCall), [*apks upload*](api::EditApkUploadCall), [*bundles list*](api::EditBundleListCall), [*bundles upload*](api::EditBundleUploadCall), [*commit*](api::EditCommitCall), [*delete*](api::EditDeleteCall), [*deobfuscationfiles upload*](api::EditDeobfuscationfileUploadCall), [*details get*](api::EditDetailGetCall), [*details patch*](api::EditDetailPatchCall), [*details update*](api::EditDetailUpdateCall), [*expansionfiles get*](api::EditExpansionfileGetCall), [*expansionfiles patch*](api::EditExpansionfilePatchCall), [*expansionfiles update*](api::EditExpansionfileUpdateCall), [*expansionfiles upload*](api::EditExpansionfileUploadCall), [*get*](api::EditGetCall), [*images delete*](api::EditImageDeleteCall), [*images deleteall*](api::EditImageDeleteallCall), [*images list*](api::EditImageListCall), [*images upload*](api::EditImageUploadCall), [*insert*](api::EditInsertCall), [*listings delete*](api::EditListingDeleteCall), [*listings deleteall*](api::EditListingDeleteallCall), [*listings get*](api::EditListingGetCall), [*listings list*](api::EditListingListCall), [*listings patch*](api::EditListingPatchCall), [*listings update*](api::EditListingUpdateCall), [*testers get*](api::EditTesterGetCall), [*testers patch*](api::EditTesterPatchCall), [*testers update*](api::EditTesterUpdateCall), [*tracks get*](api::EditTrackGetCall), [*tracks list*](api::EditTrackListCall), [*tracks patch*](api::EditTrackPatchCall), [*tracks update*](api::EditTrackUpdateCall) and [*validate*](api::EditValidateCall) @@ -69,8 +69,8 @@ //! let r = hub.inappproducts().update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -99,12 +99,12 @@ //! use std::default::Default; //! use androidpublisher2::{AndroidPublisher, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -146,10 +146,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -159,25 +159,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/androidpublisher3/README.md b/gen/androidpublisher3/README.md index ac9d1b1458..74a77f874f 100644 --- a/gen/androidpublisher3/README.md +++ b/gen/androidpublisher3/README.md @@ -11,7 +11,7 @@ Everything else about the *Android Publisher* *v3* API can be found at the [official documentation site](https://developers.google.com/android-publisher). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-androidpublisher3/5.0.3+20230124/google_androidpublisher3/AndroidPublisher) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-androidpublisher3/5.0.3+20230124/google_androidpublisher3/AndroidPublisher) ... * applications * [*device tier configs create*](https://docs.rs/google-androidpublisher3/5.0.3+20230124/google_androidpublisher3/api::ApplicationDeviceTierConfigCreateCall), [*device tier configs get*](https://docs.rs/google-androidpublisher3/5.0.3+20230124/google_androidpublisher3/api::ApplicationDeviceTierConfigGetCall) and [*device tier configs list*](https://docs.rs/google-androidpublisher3/5.0.3+20230124/google_androidpublisher3/api::ApplicationDeviceTierConfigListCall) @@ -92,8 +92,8 @@ let r = hub.monetization().subscriptions_get(...).doit().await let r = hub.monetization().subscriptions_patch(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -121,12 +121,12 @@ use androidpublisher3::{Result, Error}; use std::default::Default; use androidpublisher3::{AndroidPublisher, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -169,10 +169,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-androidpublisher3/5.0.3+20230124/google_androidpublisher3/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-androidpublisher3/5.0.3+20230124/google_androidpublisher3/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -182,25 +182,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-androi You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-androidpublisher3/5.0.3+20230124/google_androidpublisher3/client::Delegate) to the -[Method Builder](https://docs.rs/google-androidpublisher3/5.0.3+20230124/google_androidpublisher3/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-androidpublisher3/5.0.3+20230124/google_androidpublisher3/client::Delegate) to the +[Method Builder](https://docs.rs/google-androidpublisher3/5.0.3+20230124/google_androidpublisher3/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-androidpublisher3/5.0.3+20230124/google_androidpublisher3/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-androidpublisher3/5.0.3+20230124/google_androidpublisher3/client::RequestValue) and -[decodable](https://docs.rs/google-androidpublisher3/5.0.3+20230124/google_androidpublisher3/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-androidpublisher3/5.0.3+20230124/google_androidpublisher3/client::RequestValue) and +[decodable](https://docs.rs/google-androidpublisher3/5.0.3+20230124/google_androidpublisher3/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-androidpublisher3/5.0.3+20230124/google_androidpublisher3/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-androidpublisher3/5.0.3+20230124/google_androidpublisher3/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -219,7 +219,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **androidpublisher3** library was generated by Sebastian Thiel, and is placed +The **androidpublisher3** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/androidpublisher3/src/api.rs b/gen/androidpublisher3/src/api.rs index 8ec010cf1b..cf0e66bf1d 100644 --- a/gen/androidpublisher3/src/api.rs +++ b/gen/androidpublisher3/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your Google Play Developer account Full, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use androidpublisher3::{AndroidPublisher, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/androidpublisher3/src/lib.rs b/gen/androidpublisher3/src/lib.rs index efafa6601e..e6be917c80 100644 --- a/gen/androidpublisher3/src/lib.rs +++ b/gen/androidpublisher3/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/androidpublisher3). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](AndroidPublisher) ... +//! Handle the following *Resources* with ease from the central [hub](AndroidPublisher) ... //! //! * applications //! * [*device tier configs create*](api::ApplicationDeviceTierConfigCreateCall), [*device tier configs get*](api::ApplicationDeviceTierConfigGetCall) and [*device tier configs list*](api::ApplicationDeviceTierConfigListCall) @@ -92,8 +92,8 @@ //! let r = hub.monetization().subscriptions_patch(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -122,12 +122,12 @@ //! use std::default::Default; //! use androidpublisher3::{AndroidPublisher, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -170,10 +170,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -183,25 +183,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/apigateway1/README.md b/gen/apigateway1/README.md index 6d81398dee..b6793fbb67 100644 --- a/gen/apigateway1/README.md +++ b/gen/apigateway1/README.md @@ -11,7 +11,7 @@ Everything else about the *apigateway* *v1* API can be found at the [official documentation site](https://cloud.google.com/api-gateway/docs). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-apigateway1/5.0.3+20221213/google_apigateway1/Apigateway) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-apigateway1/5.0.3+20221213/google_apigateway1/Apigateway) ... * projects * [*locations apis configs create*](https://docs.rs/google-apigateway1/5.0.3+20221213/google_apigateway1/api::ProjectLocationApiConfigCreateCall), [*locations apis configs delete*](https://docs.rs/google-apigateway1/5.0.3+20221213/google_apigateway1/api::ProjectLocationApiConfigDeleteCall), [*locations apis configs get*](https://docs.rs/google-apigateway1/5.0.3+20221213/google_apigateway1/api::ProjectLocationApiConfigGetCall), [*locations apis configs get iam policy*](https://docs.rs/google-apigateway1/5.0.3+20221213/google_apigateway1/api::ProjectLocationApiConfigGetIamPolicyCall), [*locations apis configs list*](https://docs.rs/google-apigateway1/5.0.3+20221213/google_apigateway1/api::ProjectLocationApiConfigListCall), [*locations apis configs patch*](https://docs.rs/google-apigateway1/5.0.3+20221213/google_apigateway1/api::ProjectLocationApiConfigPatchCall), [*locations apis configs set iam policy*](https://docs.rs/google-apigateway1/5.0.3+20221213/google_apigateway1/api::ProjectLocationApiConfigSetIamPolicyCall), [*locations apis configs test iam permissions*](https://docs.rs/google-apigateway1/5.0.3+20221213/google_apigateway1/api::ProjectLocationApiConfigTestIamPermissionCall), [*locations apis create*](https://docs.rs/google-apigateway1/5.0.3+20221213/google_apigateway1/api::ProjectLocationApiCreateCall), [*locations apis delete*](https://docs.rs/google-apigateway1/5.0.3+20221213/google_apigateway1/api::ProjectLocationApiDeleteCall), [*locations apis get*](https://docs.rs/google-apigateway1/5.0.3+20221213/google_apigateway1/api::ProjectLocationApiGetCall), [*locations apis get iam policy*](https://docs.rs/google-apigateway1/5.0.3+20221213/google_apigateway1/api::ProjectLocationApiGetIamPolicyCall), [*locations apis list*](https://docs.rs/google-apigateway1/5.0.3+20221213/google_apigateway1/api::ProjectLocationApiListCall), [*locations apis patch*](https://docs.rs/google-apigateway1/5.0.3+20221213/google_apigateway1/api::ProjectLocationApiPatchCall), [*locations apis set iam policy*](https://docs.rs/google-apigateway1/5.0.3+20221213/google_apigateway1/api::ProjectLocationApiSetIamPolicyCall), [*locations apis test iam permissions*](https://docs.rs/google-apigateway1/5.0.3+20221213/google_apigateway1/api::ProjectLocationApiTestIamPermissionCall), [*locations gateways create*](https://docs.rs/google-apigateway1/5.0.3+20221213/google_apigateway1/api::ProjectLocationGatewayCreateCall), [*locations gateways delete*](https://docs.rs/google-apigateway1/5.0.3+20221213/google_apigateway1/api::ProjectLocationGatewayDeleteCall), [*locations gateways get*](https://docs.rs/google-apigateway1/5.0.3+20221213/google_apigateway1/api::ProjectLocationGatewayGetCall), [*locations gateways get iam policy*](https://docs.rs/google-apigateway1/5.0.3+20221213/google_apigateway1/api::ProjectLocationGatewayGetIamPolicyCall), [*locations gateways list*](https://docs.rs/google-apigateway1/5.0.3+20221213/google_apigateway1/api::ProjectLocationGatewayListCall), [*locations gateways patch*](https://docs.rs/google-apigateway1/5.0.3+20221213/google_apigateway1/api::ProjectLocationGatewayPatchCall), [*locations gateways set iam policy*](https://docs.rs/google-apigateway1/5.0.3+20221213/google_apigateway1/api::ProjectLocationGatewaySetIamPolicyCall), [*locations gateways test iam permissions*](https://docs.rs/google-apigateway1/5.0.3+20221213/google_apigateway1/api::ProjectLocationGatewayTestIamPermissionCall), [*locations get*](https://docs.rs/google-apigateway1/5.0.3+20221213/google_apigateway1/api::ProjectLocationGetCall), [*locations list*](https://docs.rs/google-apigateway1/5.0.3+20221213/google_apigateway1/api::ProjectLocationListCall), [*locations operations cancel*](https://docs.rs/google-apigateway1/5.0.3+20221213/google_apigateway1/api::ProjectLocationOperationCancelCall), [*locations operations delete*](https://docs.rs/google-apigateway1/5.0.3+20221213/google_apigateway1/api::ProjectLocationOperationDeleteCall), [*locations operations get*](https://docs.rs/google-apigateway1/5.0.3+20221213/google_apigateway1/api::ProjectLocationOperationGetCall) and [*locations operations list*](https://docs.rs/google-apigateway1/5.0.3+20221213/google_apigateway1/api::ProjectLocationOperationListCall) @@ -59,8 +59,8 @@ let r = hub.projects().locations_gateways_patch(...).doit().await let r = hub.projects().locations_operations_get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -88,12 +88,12 @@ use apigateway1::{Result, Error}; use std::default::Default; use apigateway1::{Apigateway, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -135,10 +135,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-apigateway1/5.0.3+20221213/google_apigateway1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-apigateway1/5.0.3+20221213/google_apigateway1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -148,25 +148,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-apigat You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-apigateway1/5.0.3+20221213/google_apigateway1/client::Delegate) to the -[Method Builder](https://docs.rs/google-apigateway1/5.0.3+20221213/google_apigateway1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-apigateway1/5.0.3+20221213/google_apigateway1/client::Delegate) to the +[Method Builder](https://docs.rs/google-apigateway1/5.0.3+20221213/google_apigateway1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-apigateway1/5.0.3+20221213/google_apigateway1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-apigateway1/5.0.3+20221213/google_apigateway1/client::RequestValue) and -[decodable](https://docs.rs/google-apigateway1/5.0.3+20221213/google_apigateway1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-apigateway1/5.0.3+20221213/google_apigateway1/client::RequestValue) and +[decodable](https://docs.rs/google-apigateway1/5.0.3+20221213/google_apigateway1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-apigateway1/5.0.3+20221213/google_apigateway1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-apigateway1/5.0.3+20221213/google_apigateway1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -185,7 +185,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **apigateway1** library was generated by Sebastian Thiel, and is placed +The **apigateway1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/apigateway1/src/api.rs b/gen/apigateway1/src/api.rs index cf6d2335da..6f67d08fe4 100644 --- a/gen/apigateway1/src/api.rs +++ b/gen/apigateway1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use apigateway1::{Apigateway, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/apigateway1/src/lib.rs b/gen/apigateway1/src/lib.rs index 9ef64366bd..d9a7721144 100644 --- a/gen/apigateway1/src/lib.rs +++ b/gen/apigateway1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/apigateway1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Apigateway) ... +//! Handle the following *Resources* with ease from the central [hub](Apigateway) ... //! //! * projects //! * [*locations apis configs create*](api::ProjectLocationApiConfigCreateCall), [*locations apis configs delete*](api::ProjectLocationApiConfigDeleteCall), [*locations apis configs get*](api::ProjectLocationApiConfigGetCall), [*locations apis configs get iam policy*](api::ProjectLocationApiConfigGetIamPolicyCall), [*locations apis configs list*](api::ProjectLocationApiConfigListCall), [*locations apis configs patch*](api::ProjectLocationApiConfigPatchCall), [*locations apis configs set iam policy*](api::ProjectLocationApiConfigSetIamPolicyCall), [*locations apis configs test iam permissions*](api::ProjectLocationApiConfigTestIamPermissionCall), [*locations apis create*](api::ProjectLocationApiCreateCall), [*locations apis delete*](api::ProjectLocationApiDeleteCall), [*locations apis get*](api::ProjectLocationApiGetCall), [*locations apis get iam policy*](api::ProjectLocationApiGetIamPolicyCall), [*locations apis list*](api::ProjectLocationApiListCall), [*locations apis patch*](api::ProjectLocationApiPatchCall), [*locations apis set iam policy*](api::ProjectLocationApiSetIamPolicyCall), [*locations apis test iam permissions*](api::ProjectLocationApiTestIamPermissionCall), [*locations gateways create*](api::ProjectLocationGatewayCreateCall), [*locations gateways delete*](api::ProjectLocationGatewayDeleteCall), [*locations gateways get*](api::ProjectLocationGatewayGetCall), [*locations gateways get iam policy*](api::ProjectLocationGatewayGetIamPolicyCall), [*locations gateways list*](api::ProjectLocationGatewayListCall), [*locations gateways patch*](api::ProjectLocationGatewayPatchCall), [*locations gateways set iam policy*](api::ProjectLocationGatewaySetIamPolicyCall), [*locations gateways test iam permissions*](api::ProjectLocationGatewayTestIamPermissionCall), [*locations get*](api::ProjectLocationGetCall), [*locations list*](api::ProjectLocationListCall), [*locations operations cancel*](api::ProjectLocationOperationCancelCall), [*locations operations delete*](api::ProjectLocationOperationDeleteCall), [*locations operations get*](api::ProjectLocationOperationGetCall) and [*locations operations list*](api::ProjectLocationOperationListCall) @@ -59,8 +59,8 @@ //! let r = hub.projects().locations_operations_get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -89,12 +89,12 @@ //! use std::default::Default; //! use apigateway1::{Apigateway, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -136,10 +136,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -149,25 +149,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/apigee1/README.md b/gen/apigee1/README.md index e129ad01a1..5d3c88e2c7 100644 --- a/gen/apigee1/README.md +++ b/gen/apigee1/README.md @@ -11,7 +11,7 @@ Everything else about the *Apigee* *v1* API can be found at the [official documentation site](https://cloud.google.com/apigee-api-management/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-apigee1/5.0.3+20230104/google_apigee1/Apigee) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-apigee1/5.0.3+20230104/google_apigee1/Apigee) ... * hybrid * [*issuers list*](https://docs.rs/google-apigee1/5.0.3+20230104/google_apigee1/api::HybridIssuerListCall) @@ -78,8 +78,8 @@ let r = hub.organizations().set_addons(...).doit().await let r = hub.projects().provision_organization(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -107,12 +107,12 @@ use apigee1::{Result, Error}; use std::default::Default; use apigee1::{Apigee, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -154,10 +154,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-apigee1/5.0.3+20230104/google_apigee1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-apigee1/5.0.3+20230104/google_apigee1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -167,25 +167,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-apigee You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-apigee1/5.0.3+20230104/google_apigee1/client::Delegate) to the -[Method Builder](https://docs.rs/google-apigee1/5.0.3+20230104/google_apigee1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-apigee1/5.0.3+20230104/google_apigee1/client::Delegate) to the +[Method Builder](https://docs.rs/google-apigee1/5.0.3+20230104/google_apigee1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-apigee1/5.0.3+20230104/google_apigee1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-apigee1/5.0.3+20230104/google_apigee1/client::RequestValue) and -[decodable](https://docs.rs/google-apigee1/5.0.3+20230104/google_apigee1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-apigee1/5.0.3+20230104/google_apigee1/client::RequestValue) and +[decodable](https://docs.rs/google-apigee1/5.0.3+20230104/google_apigee1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-apigee1/5.0.3+20230104/google_apigee1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-apigee1/5.0.3+20230104/google_apigee1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -204,7 +204,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **apigee1** library was generated by Sebastian Thiel, and is placed +The **apigee1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/apigee1/src/api.rs b/gen/apigee1/src/api.rs index eb31ae989c..25b3ae9bd4 100644 --- a/gen/apigee1/src/api.rs +++ b/gen/apigee1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use apigee1::{Apigee, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/apigee1/src/lib.rs b/gen/apigee1/src/lib.rs index f48c4470e5..c8a475c935 100644 --- a/gen/apigee1/src/lib.rs +++ b/gen/apigee1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/apigee1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Apigee) ... +//! Handle the following *Resources* with ease from the central [hub](Apigee) ... //! //! * hybrid //! * [*issuers list*](api::HybridIssuerListCall) @@ -78,8 +78,8 @@ //! let r = hub.projects().provision_organization(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -108,12 +108,12 @@ //! use std::default::Default; //! use apigee1::{Apigee, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -155,10 +155,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -168,25 +168,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/apikeys2/README.md b/gen/apikeys2/README.md index 8be7e4d9e8..4eb3724d12 100644 --- a/gen/apikeys2/README.md +++ b/gen/apikeys2/README.md @@ -11,7 +11,7 @@ Everything else about the *Api Keys Service* *v2* API can be found at the [official documentation site](https://cloud.google.com/api-keys/docs). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-apikeys2/5.0.3+20230118/google_apikeys2/ApiKeysService) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-apikeys2/5.0.3+20230118/google_apikeys2/ApiKeysService) ... * keys * [*lookup key*](https://docs.rs/google-apikeys2/5.0.3+20230118/google_apikeys2/api::KeyLookupKeyCall) @@ -58,8 +58,8 @@ let r = hub.projects().locations_keys_patch(...).doit().await let r = hub.projects().locations_keys_undelete(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -87,12 +87,12 @@ use apikeys2::{Result, Error}; use std::default::Default; use apikeys2::{ApiKeysService, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -134,10 +134,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-apikeys2/5.0.3+20230118/google_apikeys2/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-apikeys2/5.0.3+20230118/google_apikeys2/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -147,25 +147,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-apikey You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-apikeys2/5.0.3+20230118/google_apikeys2/client::Delegate) to the -[Method Builder](https://docs.rs/google-apikeys2/5.0.3+20230118/google_apikeys2/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-apikeys2/5.0.3+20230118/google_apikeys2/client::Delegate) to the +[Method Builder](https://docs.rs/google-apikeys2/5.0.3+20230118/google_apikeys2/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-apikeys2/5.0.3+20230118/google_apikeys2/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-apikeys2/5.0.3+20230118/google_apikeys2/client::RequestValue) and -[decodable](https://docs.rs/google-apikeys2/5.0.3+20230118/google_apikeys2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-apikeys2/5.0.3+20230118/google_apikeys2/client::RequestValue) and +[decodable](https://docs.rs/google-apikeys2/5.0.3+20230118/google_apikeys2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-apikeys2/5.0.3+20230118/google_apikeys2/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-apikeys2/5.0.3+20230118/google_apikeys2/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -184,7 +184,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **apikeys2** library was generated by Sebastian Thiel, and is placed +The **apikeys2** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/apikeys2/src/api.rs b/gen/apikeys2/src/api.rs index 9dcfd1f5ec..978dd9b274 100644 --- a/gen/apikeys2/src/api.rs +++ b/gen/apikeys2/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use apikeys2::{ApiKeysService, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/apikeys2/src/lib.rs b/gen/apikeys2/src/lib.rs index 892beb78a1..682d59cb64 100644 --- a/gen/apikeys2/src/lib.rs +++ b/gen/apikeys2/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/apikeys2). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](ApiKeysService) ... +//! Handle the following *Resources* with ease from the central [hub](ApiKeysService) ... //! //! * keys //! * [*lookup key*](api::KeyLookupKeyCall) @@ -58,8 +58,8 @@ //! let r = hub.projects().locations_keys_undelete(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -88,12 +88,12 @@ //! use std::default::Default; //! use apikeys2::{ApiKeysService, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -135,10 +135,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -148,25 +148,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/appengine1/README.md b/gen/appengine1/README.md index f54ef00df1..263ec099d8 100644 --- a/gen/appengine1/README.md +++ b/gen/appengine1/README.md @@ -11,7 +11,7 @@ Everything else about the *appengine* *v1* API can be found at the [official documentation site](https://cloud.google.com/appengine/docs/admin-api/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/Appengine) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/Appengine) ... * apps * [*authorized certificates create*](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/api::AppAuthorizedCertificateCreateCall), [*authorized certificates delete*](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/api::AppAuthorizedCertificateDeleteCall), [*authorized certificates get*](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/api::AppAuthorizedCertificateGetCall), [*authorized certificates list*](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/api::AppAuthorizedCertificateListCall), [*authorized certificates patch*](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/api::AppAuthorizedCertificatePatchCall), [*authorized domains list*](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/api::AppAuthorizedDomainListCall), [*create*](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/api::AppCreateCall), [*domain mappings create*](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/api::AppDomainMappingCreateCall), [*domain mappings delete*](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/api::AppDomainMappingDeleteCall), [*domain mappings get*](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/api::AppDomainMappingGetCall), [*domain mappings list*](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/api::AppDomainMappingListCall), [*domain mappings patch*](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/api::AppDomainMappingPatchCall), [*firewall ingress rules batch update*](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/api::AppFirewallIngressRuleBatchUpdateCall), [*firewall ingress rules create*](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/api::AppFirewallIngressRuleCreateCall), [*firewall ingress rules delete*](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/api::AppFirewallIngressRuleDeleteCall), [*firewall ingress rules get*](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/api::AppFirewallIngressRuleGetCall), [*firewall ingress rules list*](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/api::AppFirewallIngressRuleListCall), [*firewall ingress rules patch*](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/api::AppFirewallIngressRulePatchCall), [*get*](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/api::AppGetCall), [*locations get*](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/api::AppLocationGetCall), [*locations list*](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/api::AppLocationListCall), [*operations get*](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/api::AppOperationGetCall), [*operations list*](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/api::AppOperationListCall), [*patch*](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/api::AppPatchCall), [*repair*](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/api::AppRepairCall), [*services delete*](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/api::AppServiceDeleteCall), [*services get*](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/api::AppServiceGetCall), [*services list*](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/api::AppServiceListCall), [*services patch*](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/api::AppServicePatchCall), [*services versions create*](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/api::AppServiceVersionCreateCall), [*services versions delete*](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/api::AppServiceVersionDeleteCall), [*services versions get*](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/api::AppServiceVersionGetCall), [*services versions instances debug*](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/api::AppServiceVersionInstanceDebugCall), [*services versions instances delete*](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/api::AppServiceVersionInstanceDeleteCall), [*services versions instances get*](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/api::AppServiceVersionInstanceGetCall), [*services versions instances list*](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/api::AppServiceVersionInstanceListCall), [*services versions list*](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/api::AppServiceVersionListCall) and [*services versions patch*](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/api::AppServiceVersionPatchCall) @@ -65,8 +65,8 @@ let r = hub.apps().patch(...).doit().await let r = hub.apps().repair(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -94,12 +94,12 @@ use appengine1::{Result, Error}; use std::default::Default; use appengine1::{Appengine, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -140,10 +140,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -153,25 +153,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-appeng You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/client::Delegate) to the -[Method Builder](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/client::Delegate) to the +[Method Builder](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/client::RequestValue) and -[decodable](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/client::RequestValue) and +[decodable](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-appengine1/5.0.3+20230114/google_appengine1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -190,7 +190,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **appengine1** library was generated by Sebastian Thiel, and is placed +The **appengine1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/appengine1/src/api.rs b/gen/appengine1/src/api.rs index 1f351b1459..341d6554e1 100644 --- a/gen/appengine1/src/api.rs +++ b/gen/appengine1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your applications deployed on Google App Engine Admin, @@ -73,12 +73,12 @@ impl Default for Scope { /// use std::default::Default; /// use appengine1::{Appengine, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/appengine1/src/lib.rs b/gen/appengine1/src/lib.rs index 5cbc2408ba..bfbbac1e3f 100644 --- a/gen/appengine1/src/lib.rs +++ b/gen/appengine1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/appengine1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Appengine) ... +//! Handle the following *Resources* with ease from the central [hub](Appengine) ... //! //! * apps //! * [*authorized certificates create*](api::AppAuthorizedCertificateCreateCall), [*authorized certificates delete*](api::AppAuthorizedCertificateDeleteCall), [*authorized certificates get*](api::AppAuthorizedCertificateGetCall), [*authorized certificates list*](api::AppAuthorizedCertificateListCall), [*authorized certificates patch*](api::AppAuthorizedCertificatePatchCall), [*authorized domains list*](api::AppAuthorizedDomainListCall), [*create*](api::AppCreateCall), [*domain mappings create*](api::AppDomainMappingCreateCall), [*domain mappings delete*](api::AppDomainMappingDeleteCall), [*domain mappings get*](api::AppDomainMappingGetCall), [*domain mappings list*](api::AppDomainMappingListCall), [*domain mappings patch*](api::AppDomainMappingPatchCall), [*firewall ingress rules batch update*](api::AppFirewallIngressRuleBatchUpdateCall), [*firewall ingress rules create*](api::AppFirewallIngressRuleCreateCall), [*firewall ingress rules delete*](api::AppFirewallIngressRuleDeleteCall), [*firewall ingress rules get*](api::AppFirewallIngressRuleGetCall), [*firewall ingress rules list*](api::AppFirewallIngressRuleListCall), [*firewall ingress rules patch*](api::AppFirewallIngressRulePatchCall), [*get*](api::AppGetCall), [*locations get*](api::AppLocationGetCall), [*locations list*](api::AppLocationListCall), [*operations get*](api::AppOperationGetCall), [*operations list*](api::AppOperationListCall), [*patch*](api::AppPatchCall), [*repair*](api::AppRepairCall), [*services delete*](api::AppServiceDeleteCall), [*services get*](api::AppServiceGetCall), [*services list*](api::AppServiceListCall), [*services patch*](api::AppServicePatchCall), [*services versions create*](api::AppServiceVersionCreateCall), [*services versions delete*](api::AppServiceVersionDeleteCall), [*services versions get*](api::AppServiceVersionGetCall), [*services versions instances debug*](api::AppServiceVersionInstanceDebugCall), [*services versions instances delete*](api::AppServiceVersionInstanceDeleteCall), [*services versions instances get*](api::AppServiceVersionInstanceGetCall), [*services versions instances list*](api::AppServiceVersionInstanceListCall), [*services versions list*](api::AppServiceVersionListCall) and [*services versions patch*](api::AppServiceVersionPatchCall) @@ -65,8 +65,8 @@ //! let r = hub.apps().repair(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -95,12 +95,12 @@ //! use std::default::Default; //! use appengine1::{Appengine, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -141,10 +141,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -154,25 +154,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/appengine1_beta4/README.md b/gen/appengine1_beta4/README.md index 767eae8a37..fea4e8d033 100644 --- a/gen/appengine1_beta4/README.md +++ b/gen/appengine1_beta4/README.md @@ -11,7 +11,7 @@ Everything else about the *appengine* *v1_beta4* API can be found at the [official documentation site](https://cloud.google.com/appengine/docs/admin-api/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-appengine1_beta4/5.0.3+20181005/google_appengine1_beta4/Appengine) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-appengine1_beta4/5.0.3+20181005/google_appengine1_beta4/Appengine) ... * apps * [*create*](https://docs.rs/google-appengine1_beta4/5.0.3+20181005/google_appengine1_beta4/api::AppCreateCall), [*get*](https://docs.rs/google-appengine1_beta4/5.0.3+20181005/google_appengine1_beta4/api::AppGetCall), [*locations get*](https://docs.rs/google-appengine1_beta4/5.0.3+20181005/google_appengine1_beta4/api::AppLocationGetCall), [*locations list*](https://docs.rs/google-appengine1_beta4/5.0.3+20181005/google_appengine1_beta4/api::AppLocationListCall), [*modules delete*](https://docs.rs/google-appengine1_beta4/5.0.3+20181005/google_appengine1_beta4/api::AppModuleDeleteCall), [*modules get*](https://docs.rs/google-appengine1_beta4/5.0.3+20181005/google_appengine1_beta4/api::AppModuleGetCall), [*modules list*](https://docs.rs/google-appengine1_beta4/5.0.3+20181005/google_appengine1_beta4/api::AppModuleListCall), [*modules patch*](https://docs.rs/google-appengine1_beta4/5.0.3+20181005/google_appengine1_beta4/api::AppModulePatchCall), [*modules versions create*](https://docs.rs/google-appengine1_beta4/5.0.3+20181005/google_appengine1_beta4/api::AppModuleVersionCreateCall), [*modules versions delete*](https://docs.rs/google-appengine1_beta4/5.0.3+20181005/google_appengine1_beta4/api::AppModuleVersionDeleteCall), [*modules versions get*](https://docs.rs/google-appengine1_beta4/5.0.3+20181005/google_appengine1_beta4/api::AppModuleVersionGetCall), [*modules versions instances debug*](https://docs.rs/google-appengine1_beta4/5.0.3+20181005/google_appengine1_beta4/api::AppModuleVersionInstanceDebugCall), [*modules versions instances delete*](https://docs.rs/google-appengine1_beta4/5.0.3+20181005/google_appengine1_beta4/api::AppModuleVersionInstanceDeleteCall), [*modules versions instances get*](https://docs.rs/google-appengine1_beta4/5.0.3+20181005/google_appengine1_beta4/api::AppModuleVersionInstanceGetCall), [*modules versions instances list*](https://docs.rs/google-appengine1_beta4/5.0.3+20181005/google_appengine1_beta4/api::AppModuleVersionInstanceListCall), [*modules versions list*](https://docs.rs/google-appengine1_beta4/5.0.3+20181005/google_appengine1_beta4/api::AppModuleVersionListCall), [*modules versions patch*](https://docs.rs/google-appengine1_beta4/5.0.3+20181005/google_appengine1_beta4/api::AppModuleVersionPatchCall), [*operations get*](https://docs.rs/google-appengine1_beta4/5.0.3+20181005/google_appengine1_beta4/api::AppOperationGetCall), [*operations list*](https://docs.rs/google-appengine1_beta4/5.0.3+20181005/google_appengine1_beta4/api::AppOperationListCall) and [*patch*](https://docs.rs/google-appengine1_beta4/5.0.3+20181005/google_appengine1_beta4/api::AppPatchCall) @@ -59,8 +59,8 @@ let r = hub.apps().create(...).doit().await let r = hub.apps().patch(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -88,12 +88,12 @@ use appengine1_beta4::{Result, Error}; use std::default::Default; use appengine1_beta4::{Appengine, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -134,10 +134,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-appengine1_beta4/5.0.3+20181005/google_appengine1_beta4/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-appengine1_beta4/5.0.3+20181005/google_appengine1_beta4/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -147,25 +147,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-appeng You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-appengine1_beta4/5.0.3+20181005/google_appengine1_beta4/client::Delegate) to the -[Method Builder](https://docs.rs/google-appengine1_beta4/5.0.3+20181005/google_appengine1_beta4/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-appengine1_beta4/5.0.3+20181005/google_appengine1_beta4/client::Delegate) to the +[Method Builder](https://docs.rs/google-appengine1_beta4/5.0.3+20181005/google_appengine1_beta4/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-appengine1_beta4/5.0.3+20181005/google_appengine1_beta4/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-appengine1_beta4/5.0.3+20181005/google_appengine1_beta4/client::RequestValue) and -[decodable](https://docs.rs/google-appengine1_beta4/5.0.3+20181005/google_appengine1_beta4/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-appengine1_beta4/5.0.3+20181005/google_appengine1_beta4/client::RequestValue) and +[decodable](https://docs.rs/google-appengine1_beta4/5.0.3+20181005/google_appengine1_beta4/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-appengine1_beta4/5.0.3+20181005/google_appengine1_beta4/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-appengine1_beta4/5.0.3+20181005/google_appengine1_beta4/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -184,7 +184,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **appengine1_beta4** library was generated by Sebastian Thiel, and is placed +The **appengine1_beta4** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/appengine1_beta4/src/api.rs b/gen/appengine1_beta4/src/api.rs index 4303e6334f..8c2bcf6de6 100644 --- a/gen/appengine1_beta4/src/api.rs +++ b/gen/appengine1_beta4/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your applications deployed on Google App Engine Admin, @@ -73,12 +73,12 @@ impl Default for Scope { /// use std::default::Default; /// use appengine1_beta4::{Appengine, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/appengine1_beta4/src/lib.rs b/gen/appengine1_beta4/src/lib.rs index 02e53072ea..25d3c2cc2d 100644 --- a/gen/appengine1_beta4/src/lib.rs +++ b/gen/appengine1_beta4/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/appengine1_beta4). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Appengine) ... +//! Handle the following *Resources* with ease from the central [hub](Appengine) ... //! //! * apps //! * [*create*](api::AppCreateCall), [*get*](api::AppGetCall), [*locations get*](api::AppLocationGetCall), [*locations list*](api::AppLocationListCall), [*modules delete*](api::AppModuleDeleteCall), [*modules get*](api::AppModuleGetCall), [*modules list*](api::AppModuleListCall), [*modules patch*](api::AppModulePatchCall), [*modules versions create*](api::AppModuleVersionCreateCall), [*modules versions delete*](api::AppModuleVersionDeleteCall), [*modules versions get*](api::AppModuleVersionGetCall), [*modules versions instances debug*](api::AppModuleVersionInstanceDebugCall), [*modules versions instances delete*](api::AppModuleVersionInstanceDeleteCall), [*modules versions instances get*](api::AppModuleVersionInstanceGetCall), [*modules versions instances list*](api::AppModuleVersionInstanceListCall), [*modules versions list*](api::AppModuleVersionListCall), [*modules versions patch*](api::AppModuleVersionPatchCall), [*operations get*](api::AppOperationGetCall), [*operations list*](api::AppOperationListCall) and [*patch*](api::AppPatchCall) @@ -59,8 +59,8 @@ //! let r = hub.apps().patch(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -89,12 +89,12 @@ //! use std::default::Default; //! use appengine1_beta4::{Appengine, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -135,10 +135,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -148,25 +148,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/appengine1_beta5/README.md b/gen/appengine1_beta5/README.md index c32e2bc0f2..5620c73cdf 100644 --- a/gen/appengine1_beta5/README.md +++ b/gen/appengine1_beta5/README.md @@ -11,7 +11,7 @@ Everything else about the *appengine* *v1_beta5* API can be found at the [official documentation site](https://cloud.google.com/appengine/docs/admin-api/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-appengine1_beta5/5.0.3+20181005/google_appengine1_beta5/Appengine) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-appengine1_beta5/5.0.3+20181005/google_appengine1_beta5/Appengine) ... * apps * [*create*](https://docs.rs/google-appengine1_beta5/5.0.3+20181005/google_appengine1_beta5/api::AppCreateCall), [*get*](https://docs.rs/google-appengine1_beta5/5.0.3+20181005/google_appengine1_beta5/api::AppGetCall), [*locations get*](https://docs.rs/google-appengine1_beta5/5.0.3+20181005/google_appengine1_beta5/api::AppLocationGetCall), [*locations list*](https://docs.rs/google-appengine1_beta5/5.0.3+20181005/google_appengine1_beta5/api::AppLocationListCall), [*operations get*](https://docs.rs/google-appengine1_beta5/5.0.3+20181005/google_appengine1_beta5/api::AppOperationGetCall), [*operations list*](https://docs.rs/google-appengine1_beta5/5.0.3+20181005/google_appengine1_beta5/api::AppOperationListCall), [*patch*](https://docs.rs/google-appengine1_beta5/5.0.3+20181005/google_appengine1_beta5/api::AppPatchCall), [*services delete*](https://docs.rs/google-appengine1_beta5/5.0.3+20181005/google_appengine1_beta5/api::AppServiceDeleteCall), [*services get*](https://docs.rs/google-appengine1_beta5/5.0.3+20181005/google_appengine1_beta5/api::AppServiceGetCall), [*services list*](https://docs.rs/google-appengine1_beta5/5.0.3+20181005/google_appengine1_beta5/api::AppServiceListCall), [*services patch*](https://docs.rs/google-appengine1_beta5/5.0.3+20181005/google_appengine1_beta5/api::AppServicePatchCall), [*services versions create*](https://docs.rs/google-appengine1_beta5/5.0.3+20181005/google_appengine1_beta5/api::AppServiceVersionCreateCall), [*services versions delete*](https://docs.rs/google-appengine1_beta5/5.0.3+20181005/google_appengine1_beta5/api::AppServiceVersionDeleteCall), [*services versions get*](https://docs.rs/google-appengine1_beta5/5.0.3+20181005/google_appengine1_beta5/api::AppServiceVersionGetCall), [*services versions instances debug*](https://docs.rs/google-appengine1_beta5/5.0.3+20181005/google_appengine1_beta5/api::AppServiceVersionInstanceDebugCall), [*services versions instances delete*](https://docs.rs/google-appengine1_beta5/5.0.3+20181005/google_appengine1_beta5/api::AppServiceVersionInstanceDeleteCall), [*services versions instances get*](https://docs.rs/google-appengine1_beta5/5.0.3+20181005/google_appengine1_beta5/api::AppServiceVersionInstanceGetCall), [*services versions instances list*](https://docs.rs/google-appengine1_beta5/5.0.3+20181005/google_appengine1_beta5/api::AppServiceVersionInstanceListCall), [*services versions list*](https://docs.rs/google-appengine1_beta5/5.0.3+20181005/google_appengine1_beta5/api::AppServiceVersionListCall) and [*services versions patch*](https://docs.rs/google-appengine1_beta5/5.0.3+20181005/google_appengine1_beta5/api::AppServiceVersionPatchCall) @@ -59,8 +59,8 @@ let r = hub.apps().create(...).doit().await let r = hub.apps().patch(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -88,12 +88,12 @@ use appengine1_beta5::{Result, Error}; use std::default::Default; use appengine1_beta5::{Appengine, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -134,10 +134,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-appengine1_beta5/5.0.3+20181005/google_appengine1_beta5/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-appengine1_beta5/5.0.3+20181005/google_appengine1_beta5/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -147,25 +147,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-appeng You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-appengine1_beta5/5.0.3+20181005/google_appengine1_beta5/client::Delegate) to the -[Method Builder](https://docs.rs/google-appengine1_beta5/5.0.3+20181005/google_appengine1_beta5/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-appengine1_beta5/5.0.3+20181005/google_appengine1_beta5/client::Delegate) to the +[Method Builder](https://docs.rs/google-appengine1_beta5/5.0.3+20181005/google_appengine1_beta5/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-appengine1_beta5/5.0.3+20181005/google_appengine1_beta5/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-appengine1_beta5/5.0.3+20181005/google_appengine1_beta5/client::RequestValue) and -[decodable](https://docs.rs/google-appengine1_beta5/5.0.3+20181005/google_appengine1_beta5/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-appengine1_beta5/5.0.3+20181005/google_appengine1_beta5/client::RequestValue) and +[decodable](https://docs.rs/google-appengine1_beta5/5.0.3+20181005/google_appengine1_beta5/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-appengine1_beta5/5.0.3+20181005/google_appengine1_beta5/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-appengine1_beta5/5.0.3+20181005/google_appengine1_beta5/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -184,7 +184,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **appengine1_beta5** library was generated by Sebastian Thiel, and is placed +The **appengine1_beta5** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/appengine1_beta5/src/api.rs b/gen/appengine1_beta5/src/api.rs index 37c4201814..2f7a934a6c 100644 --- a/gen/appengine1_beta5/src/api.rs +++ b/gen/appengine1_beta5/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your applications deployed on Google App Engine Admin, @@ -73,12 +73,12 @@ impl Default for Scope { /// use std::default::Default; /// use appengine1_beta5::{Appengine, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/appengine1_beta5/src/lib.rs b/gen/appengine1_beta5/src/lib.rs index 46d7501475..cdbaa60797 100644 --- a/gen/appengine1_beta5/src/lib.rs +++ b/gen/appengine1_beta5/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/appengine1_beta5). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Appengine) ... +//! Handle the following *Resources* with ease from the central [hub](Appengine) ... //! //! * apps //! * [*create*](api::AppCreateCall), [*get*](api::AppGetCall), [*locations get*](api::AppLocationGetCall), [*locations list*](api::AppLocationListCall), [*operations get*](api::AppOperationGetCall), [*operations list*](api::AppOperationListCall), [*patch*](api::AppPatchCall), [*services delete*](api::AppServiceDeleteCall), [*services get*](api::AppServiceGetCall), [*services list*](api::AppServiceListCall), [*services patch*](api::AppServicePatchCall), [*services versions create*](api::AppServiceVersionCreateCall), [*services versions delete*](api::AppServiceVersionDeleteCall), [*services versions get*](api::AppServiceVersionGetCall), [*services versions instances debug*](api::AppServiceVersionInstanceDebugCall), [*services versions instances delete*](api::AppServiceVersionInstanceDeleteCall), [*services versions instances get*](api::AppServiceVersionInstanceGetCall), [*services versions instances list*](api::AppServiceVersionInstanceListCall), [*services versions list*](api::AppServiceVersionListCall) and [*services versions patch*](api::AppServiceVersionPatchCall) @@ -59,8 +59,8 @@ //! let r = hub.apps().patch(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -89,12 +89,12 @@ //! use std::default::Default; //! use appengine1_beta5::{Appengine, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -135,10 +135,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -148,25 +148,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/appsactivity1/README.md b/gen/appsactivity1/README.md index a6fcc4367e..38b5758e45 100644 --- a/gen/appsactivity1/README.md +++ b/gen/appsactivity1/README.md @@ -11,7 +11,7 @@ Everything else about the *appsactivity* *v1* API can be found at the [official documentation site](https://developers.google.com/google-apps/activity/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-appsactivity1/5.0.3+20200628/google_appsactivity1/Appsactivity) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-appsactivity1/5.0.3+20200628/google_appsactivity1/Appsactivity) ... * [activities](https://docs.rs/google-appsactivity1/5.0.3+20200628/google_appsactivity1/api::Activity) * [*list*](https://docs.rs/google-appsactivity1/5.0.3+20200628/google_appsactivity1/api::ActivityListCall) @@ -50,8 +50,8 @@ Or specifically ... let r = hub.activities().list(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -78,12 +78,12 @@ use appsactivity1::{Result, Error}; use std::default::Default; use appsactivity1::{Appsactivity, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -126,10 +126,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-appsactivity1/5.0.3+20200628/google_appsactivity1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-appsactivity1/5.0.3+20200628/google_appsactivity1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -139,25 +139,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-appsac You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-appsactivity1/5.0.3+20200628/google_appsactivity1/client::Delegate) to the -[Method Builder](https://docs.rs/google-appsactivity1/5.0.3+20200628/google_appsactivity1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-appsactivity1/5.0.3+20200628/google_appsactivity1/client::Delegate) to the +[Method Builder](https://docs.rs/google-appsactivity1/5.0.3+20200628/google_appsactivity1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-appsactivity1/5.0.3+20200628/google_appsactivity1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-appsactivity1/5.0.3+20200628/google_appsactivity1/client::RequestValue) and -[decodable](https://docs.rs/google-appsactivity1/5.0.3+20200628/google_appsactivity1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-appsactivity1/5.0.3+20200628/google_appsactivity1/client::RequestValue) and +[decodable](https://docs.rs/google-appsactivity1/5.0.3+20200628/google_appsactivity1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-appsactivity1/5.0.3+20200628/google_appsactivity1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-appsactivity1/5.0.3+20200628/google_appsactivity1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -176,7 +176,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **appsactivity1** library was generated by Sebastian Thiel, and is placed +The **appsactivity1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/appsactivity1/src/api.rs b/gen/appsactivity1/src/api.rs index 0289a94b87..a398ca2a67 100644 --- a/gen/appsactivity1/src/api.rs +++ b/gen/appsactivity1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View the activity history of your Google apps Activity, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use appsactivity1::{Appsactivity, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/appsactivity1/src/lib.rs b/gen/appsactivity1/src/lib.rs index 759a7c2931..2fc24eee1a 100644 --- a/gen/appsactivity1/src/lib.rs +++ b/gen/appsactivity1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/appsactivity1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Appsactivity) ... +//! Handle the following *Resources* with ease from the central [hub](Appsactivity) ... //! //! * [activities](api::Activity) //! * [*list*](api::ActivityListCall) @@ -50,8 +50,8 @@ //! let r = hub.activities().list(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -79,12 +79,12 @@ //! use std::default::Default; //! use appsactivity1::{Appsactivity, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -127,10 +127,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -140,25 +140,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/appstate1/README.md b/gen/appstate1/README.md index 88ab36d622..1f7db21460 100644 --- a/gen/appstate1/README.md +++ b/gen/appstate1/README.md @@ -11,7 +11,7 @@ Everything else about the *App State* *v1* API can be found at the [official documentation site](https://developers.google.com/games/services/web/api/states). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-appstate1/5.0.3+20190627/google_appstate1/AppState) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-appstate1/5.0.3+20190627/google_appstate1/AppState) ... * states * [*clear*](https://docs.rs/google-appstate1/5.0.3+20190627/google_appstate1/api::StateClearCall), [*delete*](https://docs.rs/google-appstate1/5.0.3+20190627/google_appstate1/api::StateDeleteCall), [*get*](https://docs.rs/google-appstate1/5.0.3+20190627/google_appstate1/api::StateGetCall), [*list*](https://docs.rs/google-appstate1/5.0.3+20190627/google_appstate1/api::StateListCall) and [*update*](https://docs.rs/google-appstate1/5.0.3+20190627/google_appstate1/api::StateUpdateCall) @@ -51,8 +51,8 @@ let r = hub.states().clear(...).doit().await let r = hub.states().update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -80,12 +80,12 @@ use appstate1::{Result, Error}; use std::default::Default; use appstate1::{AppState, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -127,10 +127,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-appstate1/5.0.3+20190627/google_appstate1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-appstate1/5.0.3+20190627/google_appstate1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -140,25 +140,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-appsta You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-appstate1/5.0.3+20190627/google_appstate1/client::Delegate) to the -[Method Builder](https://docs.rs/google-appstate1/5.0.3+20190627/google_appstate1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-appstate1/5.0.3+20190627/google_appstate1/client::Delegate) to the +[Method Builder](https://docs.rs/google-appstate1/5.0.3+20190627/google_appstate1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-appstate1/5.0.3+20190627/google_appstate1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-appstate1/5.0.3+20190627/google_appstate1/client::RequestValue) and -[decodable](https://docs.rs/google-appstate1/5.0.3+20190627/google_appstate1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-appstate1/5.0.3+20190627/google_appstate1/client::RequestValue) and +[decodable](https://docs.rs/google-appstate1/5.0.3+20190627/google_appstate1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-appstate1/5.0.3+20190627/google_appstate1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-appstate1/5.0.3+20190627/google_appstate1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -177,7 +177,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **appstate1** library was generated by Sebastian Thiel, and is placed +The **appstate1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/appstate1/src/api.rs b/gen/appstate1/src/api.rs index 3faeb17712..f19f38d7e1 100644 --- a/gen/appstate1/src/api.rs +++ b/gen/appstate1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your data for this application Full, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use appstate1::{AppState, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/appstate1/src/lib.rs b/gen/appstate1/src/lib.rs index 1bf18a9e45..035c0ae0be 100644 --- a/gen/appstate1/src/lib.rs +++ b/gen/appstate1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/appstate1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](AppState) ... +//! Handle the following *Resources* with ease from the central [hub](AppState) ... //! //! * states //! * [*clear*](api::StateClearCall), [*delete*](api::StateDeleteCall), [*get*](api::StateGetCall), [*list*](api::StateListCall) and [*update*](api::StateUpdateCall) @@ -51,8 +51,8 @@ //! let r = hub.states().update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -81,12 +81,12 @@ //! use std::default::Default; //! use appstate1::{AppState, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -128,10 +128,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -141,25 +141,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/area120tables1_alpha1/README.md b/gen/area120tables1_alpha1/README.md index b419058209..f57dada14b 100644 --- a/gen/area120tables1_alpha1/README.md +++ b/gen/area120tables1_alpha1/README.md @@ -11,7 +11,7 @@ Everything else about the *Area120 Tables* *v1_alpha1* API can be found at the [official documentation site](https://support.google.com/area120-tables/answer/10011390). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-area120tables1_alpha1/5.0.3+20230123/google_area120tables1_alpha1/Area120Tables) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-area120tables1_alpha1/5.0.3+20230123/google_area120tables1_alpha1/Area120Tables) ... * [tables](https://docs.rs/google-area120tables1_alpha1/5.0.3+20230123/google_area120tables1_alpha1/api::Table) * [*get*](https://docs.rs/google-area120tables1_alpha1/5.0.3+20230123/google_area120tables1_alpha1/api::TableGetCall), [*list*](https://docs.rs/google-area120tables1_alpha1/5.0.3+20230123/google_area120tables1_alpha1/api::TableListCall), [*rows batch create*](https://docs.rs/google-area120tables1_alpha1/5.0.3+20230123/google_area120tables1_alpha1/api::TableRowBatchCreateCall), [*rows batch delete*](https://docs.rs/google-area120tables1_alpha1/5.0.3+20230123/google_area120tables1_alpha1/api::TableRowBatchDeleteCall), [*rows batch update*](https://docs.rs/google-area120tables1_alpha1/5.0.3+20230123/google_area120tables1_alpha1/api::TableRowBatchUpdateCall), [*rows create*](https://docs.rs/google-area120tables1_alpha1/5.0.3+20230123/google_area120tables1_alpha1/api::TableRowCreateCall), [*rows delete*](https://docs.rs/google-area120tables1_alpha1/5.0.3+20230123/google_area120tables1_alpha1/api::TableRowDeleteCall), [*rows get*](https://docs.rs/google-area120tables1_alpha1/5.0.3+20230123/google_area120tables1_alpha1/api::TableRowGetCall), [*rows list*](https://docs.rs/google-area120tables1_alpha1/5.0.3+20230123/google_area120tables1_alpha1/api::TableRowListCall) and [*rows patch*](https://docs.rs/google-area120tables1_alpha1/5.0.3+20230123/google_area120tables1_alpha1/api::TableRowPatchCall) @@ -61,8 +61,8 @@ let r = hub.tables().get(...).doit().await let r = hub.tables().list(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -89,12 +89,12 @@ use area120tables1_alpha1::{Result, Error}; use std::default::Default; use area120tables1_alpha1::{Area120Tables, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -135,10 +135,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-area120tables1_alpha1/5.0.3+20230123/google_area120tables1_alpha1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-area120tables1_alpha1/5.0.3+20230123/google_area120tables1_alpha1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -148,25 +148,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-area12 You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-area120tables1_alpha1/5.0.3+20230123/google_area120tables1_alpha1/client::Delegate) to the -[Method Builder](https://docs.rs/google-area120tables1_alpha1/5.0.3+20230123/google_area120tables1_alpha1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-area120tables1_alpha1/5.0.3+20230123/google_area120tables1_alpha1/client::Delegate) to the +[Method Builder](https://docs.rs/google-area120tables1_alpha1/5.0.3+20230123/google_area120tables1_alpha1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-area120tables1_alpha1/5.0.3+20230123/google_area120tables1_alpha1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-area120tables1_alpha1/5.0.3+20230123/google_area120tables1_alpha1/client::RequestValue) and -[decodable](https://docs.rs/google-area120tables1_alpha1/5.0.3+20230123/google_area120tables1_alpha1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-area120tables1_alpha1/5.0.3+20230123/google_area120tables1_alpha1/client::RequestValue) and +[decodable](https://docs.rs/google-area120tables1_alpha1/5.0.3+20230123/google_area120tables1_alpha1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-area120tables1_alpha1/5.0.3+20230123/google_area120tables1_alpha1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-area120tables1_alpha1/5.0.3+20230123/google_area120tables1_alpha1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -185,7 +185,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **area120tables1_alpha1** library was generated by Sebastian Thiel, and is placed +The **area120tables1_alpha1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/area120tables1_alpha1/src/api.rs b/gen/area120tables1_alpha1/src/api.rs index 5853c95249..1571746ca6 100644 --- a/gen/area120tables1_alpha1/src/api.rs +++ b/gen/area120tables1_alpha1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, create, and delete all of your Google Drive files Drive, @@ -84,12 +84,12 @@ impl Default for Scope { /// use std::default::Default; /// use area120tables1_alpha1::{Area120Tables, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/area120tables1_alpha1/src/lib.rs b/gen/area120tables1_alpha1/src/lib.rs index d461cba516..26e1e63b90 100644 --- a/gen/area120tables1_alpha1/src/lib.rs +++ b/gen/area120tables1_alpha1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/area120tables1_alpha1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Area120Tables) ... +//! Handle the following *Resources* with ease from the central [hub](Area120Tables) ... //! //! * [tables](api::Table) //! * [*get*](api::TableGetCall), [*list*](api::TableListCall), [*rows batch create*](api::TableRowBatchCreateCall), [*rows batch delete*](api::TableRowBatchDeleteCall), [*rows batch update*](api::TableRowBatchUpdateCall), [*rows create*](api::TableRowCreateCall), [*rows delete*](api::TableRowDeleteCall), [*rows get*](api::TableRowGetCall), [*rows list*](api::TableRowListCall) and [*rows patch*](api::TableRowPatchCall) @@ -61,8 +61,8 @@ //! let r = hub.tables().list(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -90,12 +90,12 @@ //! use std::default::Default; //! use area120tables1_alpha1::{Area120Tables, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -136,10 +136,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -149,25 +149,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/artifactregistry1/README.md b/gen/artifactregistry1/README.md index 0b57ed4bc7..2f929221f2 100644 --- a/gen/artifactregistry1/README.md +++ b/gen/artifactregistry1/README.md @@ -11,7 +11,7 @@ Everything else about the *Artifact Registry* *v1* API can be found at the [official documentation site](https://cloud.google.com/artifacts/docs/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/ArtifactRegistry) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/ArtifactRegistry) ... * projects * [*get project settings*](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/api::ProjectGetProjectSettingCall), [*locations get*](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/api::ProjectLocationGetCall), [*locations list*](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/api::ProjectLocationListCall), [*locations operations get*](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/api::ProjectLocationOperationGetCall), [*locations repositories apt artifacts import*](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/api::ProjectLocationRepositoryAptArtifactImportCall), [*locations repositories apt artifacts upload*](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/api::ProjectLocationRepositoryAptArtifactUploadCall), [*locations repositories create*](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/api::ProjectLocationRepositoryCreateCall), [*locations repositories delete*](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/api::ProjectLocationRepositoryDeleteCall), [*locations repositories docker images get*](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/api::ProjectLocationRepositoryDockerImageGetCall), [*locations repositories docker images list*](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/api::ProjectLocationRepositoryDockerImageListCall), [*locations repositories files get*](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/api::ProjectLocationRepositoryFileGetCall), [*locations repositories files list*](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/api::ProjectLocationRepositoryFileListCall), [*locations repositories get*](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/api::ProjectLocationRepositoryGetCall), [*locations repositories get iam policy*](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/api::ProjectLocationRepositoryGetIamPolicyCall), [*locations repositories kfp artifacts upload*](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/api::ProjectLocationRepositoryKfpArtifactUploadCall), [*locations repositories list*](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/api::ProjectLocationRepositoryListCall), [*locations repositories maven artifacts get*](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/api::ProjectLocationRepositoryMavenArtifactGetCall), [*locations repositories maven artifacts list*](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/api::ProjectLocationRepositoryMavenArtifactListCall), [*locations repositories npm packages get*](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/api::ProjectLocationRepositoryNpmPackageGetCall), [*locations repositories npm packages list*](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/api::ProjectLocationRepositoryNpmPackageListCall), [*locations repositories packages delete*](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/api::ProjectLocationRepositoryPackageDeleteCall), [*locations repositories packages get*](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/api::ProjectLocationRepositoryPackageGetCall), [*locations repositories packages list*](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/api::ProjectLocationRepositoryPackageListCall), [*locations repositories packages tags create*](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/api::ProjectLocationRepositoryPackageTagCreateCall), [*locations repositories packages tags delete*](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/api::ProjectLocationRepositoryPackageTagDeleteCall), [*locations repositories packages tags get*](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/api::ProjectLocationRepositoryPackageTagGetCall), [*locations repositories packages tags list*](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/api::ProjectLocationRepositoryPackageTagListCall), [*locations repositories packages tags patch*](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/api::ProjectLocationRepositoryPackageTagPatchCall), [*locations repositories packages versions delete*](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/api::ProjectLocationRepositoryPackageVersionDeleteCall), [*locations repositories packages versions get*](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/api::ProjectLocationRepositoryPackageVersionGetCall), [*locations repositories packages versions list*](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/api::ProjectLocationRepositoryPackageVersionListCall), [*locations repositories patch*](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/api::ProjectLocationRepositoryPatchCall), [*locations repositories python packages get*](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/api::ProjectLocationRepositoryPythonPackageGetCall), [*locations repositories python packages list*](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/api::ProjectLocationRepositoryPythonPackageListCall), [*locations repositories set iam policy*](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/api::ProjectLocationRepositorySetIamPolicyCall), [*locations repositories test iam permissions*](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/api::ProjectLocationRepositoryTestIamPermissionCall), [*locations repositories yum artifacts import*](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/api::ProjectLocationRepositoryYumArtifactImportCall), [*locations repositories yum artifacts upload*](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/api::ProjectLocationRepositoryYumArtifactUploadCall) and [*update project settings*](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/api::ProjectUpdateProjectSettingCall) @@ -62,8 +62,8 @@ let r = hub.projects().locations_repositories_create(...).doit().await let r = hub.projects().locations_repositories_delete(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -91,12 +91,12 @@ use artifactregistry1::{Result, Error}; use std::default::Default; use artifactregistry1::{ArtifactRegistry, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -138,10 +138,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -151,25 +151,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-artifa You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/client::Delegate) to the -[Method Builder](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/client::Delegate) to the +[Method Builder](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/client::RequestValue) and -[decodable](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/client::RequestValue) and +[decodable](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-artifactregistry1/5.0.3+20230113/google_artifactregistry1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -188,7 +188,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **artifactregistry1** library was generated by Sebastian Thiel, and is placed +The **artifactregistry1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/artifactregistry1/src/api.rs b/gen/artifactregistry1/src/api.rs index 032ec1d6c8..1f3d6416be 100644 --- a/gen/artifactregistry1/src/api.rs +++ b/gen/artifactregistry1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use artifactregistry1::{ArtifactRegistry, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/artifactregistry1/src/lib.rs b/gen/artifactregistry1/src/lib.rs index cc70087f4a..8fff077881 100644 --- a/gen/artifactregistry1/src/lib.rs +++ b/gen/artifactregistry1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/artifactregistry1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](ArtifactRegistry) ... +//! Handle the following *Resources* with ease from the central [hub](ArtifactRegistry) ... //! //! * projects //! * [*get project settings*](api::ProjectGetProjectSettingCall), [*locations get*](api::ProjectLocationGetCall), [*locations list*](api::ProjectLocationListCall), [*locations operations get*](api::ProjectLocationOperationGetCall), [*locations repositories apt artifacts import*](api::ProjectLocationRepositoryAptArtifactImportCall), [*locations repositories apt artifacts upload*](api::ProjectLocationRepositoryAptArtifactUploadCall), [*locations repositories create*](api::ProjectLocationRepositoryCreateCall), [*locations repositories delete*](api::ProjectLocationRepositoryDeleteCall), [*locations repositories docker images get*](api::ProjectLocationRepositoryDockerImageGetCall), [*locations repositories docker images list*](api::ProjectLocationRepositoryDockerImageListCall), [*locations repositories files get*](api::ProjectLocationRepositoryFileGetCall), [*locations repositories files list*](api::ProjectLocationRepositoryFileListCall), [*locations repositories get*](api::ProjectLocationRepositoryGetCall), [*locations repositories get iam policy*](api::ProjectLocationRepositoryGetIamPolicyCall), [*locations repositories kfp artifacts upload*](api::ProjectLocationRepositoryKfpArtifactUploadCall), [*locations repositories list*](api::ProjectLocationRepositoryListCall), [*locations repositories maven artifacts get*](api::ProjectLocationRepositoryMavenArtifactGetCall), [*locations repositories maven artifacts list*](api::ProjectLocationRepositoryMavenArtifactListCall), [*locations repositories npm packages get*](api::ProjectLocationRepositoryNpmPackageGetCall), [*locations repositories npm packages list*](api::ProjectLocationRepositoryNpmPackageListCall), [*locations repositories packages delete*](api::ProjectLocationRepositoryPackageDeleteCall), [*locations repositories packages get*](api::ProjectLocationRepositoryPackageGetCall), [*locations repositories packages list*](api::ProjectLocationRepositoryPackageListCall), [*locations repositories packages tags create*](api::ProjectLocationRepositoryPackageTagCreateCall), [*locations repositories packages tags delete*](api::ProjectLocationRepositoryPackageTagDeleteCall), [*locations repositories packages tags get*](api::ProjectLocationRepositoryPackageTagGetCall), [*locations repositories packages tags list*](api::ProjectLocationRepositoryPackageTagListCall), [*locations repositories packages tags patch*](api::ProjectLocationRepositoryPackageTagPatchCall), [*locations repositories packages versions delete*](api::ProjectLocationRepositoryPackageVersionDeleteCall), [*locations repositories packages versions get*](api::ProjectLocationRepositoryPackageVersionGetCall), [*locations repositories packages versions list*](api::ProjectLocationRepositoryPackageVersionListCall), [*locations repositories patch*](api::ProjectLocationRepositoryPatchCall), [*locations repositories python packages get*](api::ProjectLocationRepositoryPythonPackageGetCall), [*locations repositories python packages list*](api::ProjectLocationRepositoryPythonPackageListCall), [*locations repositories set iam policy*](api::ProjectLocationRepositorySetIamPolicyCall), [*locations repositories test iam permissions*](api::ProjectLocationRepositoryTestIamPermissionCall), [*locations repositories yum artifacts import*](api::ProjectLocationRepositoryYumArtifactImportCall), [*locations repositories yum artifacts upload*](api::ProjectLocationRepositoryYumArtifactUploadCall) and [*update project settings*](api::ProjectUpdateProjectSettingCall) @@ -62,8 +62,8 @@ //! let r = hub.projects().locations_repositories_delete(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -92,12 +92,12 @@ //! use std::default::Default; //! use artifactregistry1::{ArtifactRegistry, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -139,10 +139,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -152,25 +152,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/artifactregistry1_beta1/README.md b/gen/artifactregistry1_beta1/README.md index 8ed46fd302..7b1e01a67f 100644 --- a/gen/artifactregistry1_beta1/README.md +++ b/gen/artifactregistry1_beta1/README.md @@ -11,7 +11,7 @@ Everything else about the *Artifact Registry* *v1_beta1* API can be found at the [official documentation site](https://cloud.google.com/artifacts/docs/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-artifactregistry1_beta1/5.0.3+20230113/google_artifactregistry1_beta1/ArtifactRegistry) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-artifactregistry1_beta1/5.0.3+20230113/google_artifactregistry1_beta1/ArtifactRegistry) ... * projects * [*locations get*](https://docs.rs/google-artifactregistry1_beta1/5.0.3+20230113/google_artifactregistry1_beta1/api::ProjectLocationGetCall), [*locations list*](https://docs.rs/google-artifactregistry1_beta1/5.0.3+20230113/google_artifactregistry1_beta1/api::ProjectLocationListCall), [*locations operations get*](https://docs.rs/google-artifactregistry1_beta1/5.0.3+20230113/google_artifactregistry1_beta1/api::ProjectLocationOperationGetCall), [*locations repositories create*](https://docs.rs/google-artifactregistry1_beta1/5.0.3+20230113/google_artifactregistry1_beta1/api::ProjectLocationRepositoryCreateCall), [*locations repositories delete*](https://docs.rs/google-artifactregistry1_beta1/5.0.3+20230113/google_artifactregistry1_beta1/api::ProjectLocationRepositoryDeleteCall), [*locations repositories files get*](https://docs.rs/google-artifactregistry1_beta1/5.0.3+20230113/google_artifactregistry1_beta1/api::ProjectLocationRepositoryFileGetCall), [*locations repositories files list*](https://docs.rs/google-artifactregistry1_beta1/5.0.3+20230113/google_artifactregistry1_beta1/api::ProjectLocationRepositoryFileListCall), [*locations repositories get*](https://docs.rs/google-artifactregistry1_beta1/5.0.3+20230113/google_artifactregistry1_beta1/api::ProjectLocationRepositoryGetCall), [*locations repositories get iam policy*](https://docs.rs/google-artifactregistry1_beta1/5.0.3+20230113/google_artifactregistry1_beta1/api::ProjectLocationRepositoryGetIamPolicyCall), [*locations repositories list*](https://docs.rs/google-artifactregistry1_beta1/5.0.3+20230113/google_artifactregistry1_beta1/api::ProjectLocationRepositoryListCall), [*locations repositories packages delete*](https://docs.rs/google-artifactregistry1_beta1/5.0.3+20230113/google_artifactregistry1_beta1/api::ProjectLocationRepositoryPackageDeleteCall), [*locations repositories packages get*](https://docs.rs/google-artifactregistry1_beta1/5.0.3+20230113/google_artifactregistry1_beta1/api::ProjectLocationRepositoryPackageGetCall), [*locations repositories packages list*](https://docs.rs/google-artifactregistry1_beta1/5.0.3+20230113/google_artifactregistry1_beta1/api::ProjectLocationRepositoryPackageListCall), [*locations repositories packages tags create*](https://docs.rs/google-artifactregistry1_beta1/5.0.3+20230113/google_artifactregistry1_beta1/api::ProjectLocationRepositoryPackageTagCreateCall), [*locations repositories packages tags delete*](https://docs.rs/google-artifactregistry1_beta1/5.0.3+20230113/google_artifactregistry1_beta1/api::ProjectLocationRepositoryPackageTagDeleteCall), [*locations repositories packages tags get*](https://docs.rs/google-artifactregistry1_beta1/5.0.3+20230113/google_artifactregistry1_beta1/api::ProjectLocationRepositoryPackageTagGetCall), [*locations repositories packages tags list*](https://docs.rs/google-artifactregistry1_beta1/5.0.3+20230113/google_artifactregistry1_beta1/api::ProjectLocationRepositoryPackageTagListCall), [*locations repositories packages tags patch*](https://docs.rs/google-artifactregistry1_beta1/5.0.3+20230113/google_artifactregistry1_beta1/api::ProjectLocationRepositoryPackageTagPatchCall), [*locations repositories packages versions delete*](https://docs.rs/google-artifactregistry1_beta1/5.0.3+20230113/google_artifactregistry1_beta1/api::ProjectLocationRepositoryPackageVersionDeleteCall), [*locations repositories packages versions get*](https://docs.rs/google-artifactregistry1_beta1/5.0.3+20230113/google_artifactregistry1_beta1/api::ProjectLocationRepositoryPackageVersionGetCall), [*locations repositories packages versions list*](https://docs.rs/google-artifactregistry1_beta1/5.0.3+20230113/google_artifactregistry1_beta1/api::ProjectLocationRepositoryPackageVersionListCall), [*locations repositories patch*](https://docs.rs/google-artifactregistry1_beta1/5.0.3+20230113/google_artifactregistry1_beta1/api::ProjectLocationRepositoryPatchCall), [*locations repositories set iam policy*](https://docs.rs/google-artifactregistry1_beta1/5.0.3+20230113/google_artifactregistry1_beta1/api::ProjectLocationRepositorySetIamPolicyCall) and [*locations repositories test iam permissions*](https://docs.rs/google-artifactregistry1_beta1/5.0.3+20230113/google_artifactregistry1_beta1/api::ProjectLocationRepositoryTestIamPermissionCall) @@ -54,8 +54,8 @@ let r = hub.projects().locations_repositories_create(...).doit().await let r = hub.projects().locations_repositories_delete(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -83,12 +83,12 @@ use artifactregistry1_beta1::{Result, Error}; use std::default::Default; use artifactregistry1_beta1::{ArtifactRegistry, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -130,10 +130,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-artifactregistry1_beta1/5.0.3+20230113/google_artifactregistry1_beta1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-artifactregistry1_beta1/5.0.3+20230113/google_artifactregistry1_beta1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -143,25 +143,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-artifa You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-artifactregistry1_beta1/5.0.3+20230113/google_artifactregistry1_beta1/client::Delegate) to the -[Method Builder](https://docs.rs/google-artifactregistry1_beta1/5.0.3+20230113/google_artifactregistry1_beta1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-artifactregistry1_beta1/5.0.3+20230113/google_artifactregistry1_beta1/client::Delegate) to the +[Method Builder](https://docs.rs/google-artifactregistry1_beta1/5.0.3+20230113/google_artifactregistry1_beta1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-artifactregistry1_beta1/5.0.3+20230113/google_artifactregistry1_beta1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-artifactregistry1_beta1/5.0.3+20230113/google_artifactregistry1_beta1/client::RequestValue) and -[decodable](https://docs.rs/google-artifactregistry1_beta1/5.0.3+20230113/google_artifactregistry1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-artifactregistry1_beta1/5.0.3+20230113/google_artifactregistry1_beta1/client::RequestValue) and +[decodable](https://docs.rs/google-artifactregistry1_beta1/5.0.3+20230113/google_artifactregistry1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-artifactregistry1_beta1/5.0.3+20230113/google_artifactregistry1_beta1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-artifactregistry1_beta1/5.0.3+20230113/google_artifactregistry1_beta1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -180,7 +180,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **artifactregistry1_beta1** library was generated by Sebastian Thiel, and is placed +The **artifactregistry1_beta1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/artifactregistry1_beta1/src/api.rs b/gen/artifactregistry1_beta1/src/api.rs index 48eabaf5db..f1be75c11e 100644 --- a/gen/artifactregistry1_beta1/src/api.rs +++ b/gen/artifactregistry1_beta1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use artifactregistry1_beta1::{ArtifactRegistry, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/artifactregistry1_beta1/src/lib.rs b/gen/artifactregistry1_beta1/src/lib.rs index f3aab24c59..3f93329233 100644 --- a/gen/artifactregistry1_beta1/src/lib.rs +++ b/gen/artifactregistry1_beta1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/artifactregistry1_beta1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](ArtifactRegistry) ... +//! Handle the following *Resources* with ease from the central [hub](ArtifactRegistry) ... //! //! * projects //! * [*locations get*](api::ProjectLocationGetCall), [*locations list*](api::ProjectLocationListCall), [*locations operations get*](api::ProjectLocationOperationGetCall), [*locations repositories create*](api::ProjectLocationRepositoryCreateCall), [*locations repositories delete*](api::ProjectLocationRepositoryDeleteCall), [*locations repositories files get*](api::ProjectLocationRepositoryFileGetCall), [*locations repositories files list*](api::ProjectLocationRepositoryFileListCall), [*locations repositories get*](api::ProjectLocationRepositoryGetCall), [*locations repositories get iam policy*](api::ProjectLocationRepositoryGetIamPolicyCall), [*locations repositories list*](api::ProjectLocationRepositoryListCall), [*locations repositories packages delete*](api::ProjectLocationRepositoryPackageDeleteCall), [*locations repositories packages get*](api::ProjectLocationRepositoryPackageGetCall), [*locations repositories packages list*](api::ProjectLocationRepositoryPackageListCall), [*locations repositories packages tags create*](api::ProjectLocationRepositoryPackageTagCreateCall), [*locations repositories packages tags delete*](api::ProjectLocationRepositoryPackageTagDeleteCall), [*locations repositories packages tags get*](api::ProjectLocationRepositoryPackageTagGetCall), [*locations repositories packages tags list*](api::ProjectLocationRepositoryPackageTagListCall), [*locations repositories packages tags patch*](api::ProjectLocationRepositoryPackageTagPatchCall), [*locations repositories packages versions delete*](api::ProjectLocationRepositoryPackageVersionDeleteCall), [*locations repositories packages versions get*](api::ProjectLocationRepositoryPackageVersionGetCall), [*locations repositories packages versions list*](api::ProjectLocationRepositoryPackageVersionListCall), [*locations repositories patch*](api::ProjectLocationRepositoryPatchCall), [*locations repositories set iam policy*](api::ProjectLocationRepositorySetIamPolicyCall) and [*locations repositories test iam permissions*](api::ProjectLocationRepositoryTestIamPermissionCall) @@ -54,8 +54,8 @@ //! let r = hub.projects().locations_repositories_delete(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -84,12 +84,12 @@ //! use std::default::Default; //! use artifactregistry1_beta1::{ArtifactRegistry, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -131,10 +131,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -144,25 +144,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/assuredworkloads1/README.md b/gen/assuredworkloads1/README.md index 835c2e84c4..e5e53cc653 100644 --- a/gen/assuredworkloads1/README.md +++ b/gen/assuredworkloads1/README.md @@ -11,7 +11,7 @@ Everything else about the *Assuredworkloads* *v1* API can be found at the [official documentation site](https://cloud.google.com/learnmoreurl). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-assuredworkloads1/5.0.3+20230116/google_assuredworkloads1/Assuredworkloads) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-assuredworkloads1/5.0.3+20230116/google_assuredworkloads1/Assuredworkloads) ... * organizations * [*locations operations get*](https://docs.rs/google-assuredworkloads1/5.0.3+20230116/google_assuredworkloads1/api::OrganizationLocationOperationGetCall), [*locations operations list*](https://docs.rs/google-assuredworkloads1/5.0.3+20230116/google_assuredworkloads1/api::OrganizationLocationOperationListCall), [*locations workloads create*](https://docs.rs/google-assuredworkloads1/5.0.3+20230116/google_assuredworkloads1/api::OrganizationLocationWorkloadCreateCall), [*locations workloads delete*](https://docs.rs/google-assuredworkloads1/5.0.3+20230116/google_assuredworkloads1/api::OrganizationLocationWorkloadDeleteCall), [*locations workloads get*](https://docs.rs/google-assuredworkloads1/5.0.3+20230116/google_assuredworkloads1/api::OrganizationLocationWorkloadGetCall), [*locations workloads list*](https://docs.rs/google-assuredworkloads1/5.0.3+20230116/google_assuredworkloads1/api::OrganizationLocationWorkloadListCall), [*locations workloads mutate partner permissions*](https://docs.rs/google-assuredworkloads1/5.0.3+20230116/google_assuredworkloads1/api::OrganizationLocationWorkloadMutatePartnerPermissionCall), [*locations workloads patch*](https://docs.rs/google-assuredworkloads1/5.0.3+20230116/google_assuredworkloads1/api::OrganizationLocationWorkloadPatchCall), [*locations workloads restrict allowed resources*](https://docs.rs/google-assuredworkloads1/5.0.3+20230116/google_assuredworkloads1/api::OrganizationLocationWorkloadRestrictAllowedResourceCall), [*locations workloads violations acknowledge*](https://docs.rs/google-assuredworkloads1/5.0.3+20230116/google_assuredworkloads1/api::OrganizationLocationWorkloadViolationAcknowledgeCall), [*locations workloads violations get*](https://docs.rs/google-assuredworkloads1/5.0.3+20230116/google_assuredworkloads1/api::OrganizationLocationWorkloadViolationGetCall) and [*locations workloads violations list*](https://docs.rs/google-assuredworkloads1/5.0.3+20230116/google_assuredworkloads1/api::OrganizationLocationWorkloadViolationListCall) @@ -53,8 +53,8 @@ let r = hub.organizations().locations_workloads_mutate_partner_permissions(...). let r = hub.organizations().locations_workloads_patch(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -82,12 +82,12 @@ use assuredworkloads1::{Result, Error}; use std::default::Default; use assuredworkloads1::{Assuredworkloads, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -129,10 +129,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-assuredworkloads1/5.0.3+20230116/google_assuredworkloads1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-assuredworkloads1/5.0.3+20230116/google_assuredworkloads1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -142,25 +142,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-assure You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-assuredworkloads1/5.0.3+20230116/google_assuredworkloads1/client::Delegate) to the -[Method Builder](https://docs.rs/google-assuredworkloads1/5.0.3+20230116/google_assuredworkloads1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-assuredworkloads1/5.0.3+20230116/google_assuredworkloads1/client::Delegate) to the +[Method Builder](https://docs.rs/google-assuredworkloads1/5.0.3+20230116/google_assuredworkloads1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-assuredworkloads1/5.0.3+20230116/google_assuredworkloads1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-assuredworkloads1/5.0.3+20230116/google_assuredworkloads1/client::RequestValue) and -[decodable](https://docs.rs/google-assuredworkloads1/5.0.3+20230116/google_assuredworkloads1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-assuredworkloads1/5.0.3+20230116/google_assuredworkloads1/client::RequestValue) and +[decodable](https://docs.rs/google-assuredworkloads1/5.0.3+20230116/google_assuredworkloads1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-assuredworkloads1/5.0.3+20230116/google_assuredworkloads1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-assuredworkloads1/5.0.3+20230116/google_assuredworkloads1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -179,7 +179,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **assuredworkloads1** library was generated by Sebastian Thiel, and is placed +The **assuredworkloads1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/assuredworkloads1/src/api.rs b/gen/assuredworkloads1/src/api.rs index 7f550345a8..09408e23e5 100644 --- a/gen/assuredworkloads1/src/api.rs +++ b/gen/assuredworkloads1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use assuredworkloads1::{Assuredworkloads, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/assuredworkloads1/src/lib.rs b/gen/assuredworkloads1/src/lib.rs index 2ac3fd4d9b..7104aa5de6 100644 --- a/gen/assuredworkloads1/src/lib.rs +++ b/gen/assuredworkloads1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/assuredworkloads1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Assuredworkloads) ... +//! Handle the following *Resources* with ease from the central [hub](Assuredworkloads) ... //! //! * organizations //! * [*locations operations get*](api::OrganizationLocationOperationGetCall), [*locations operations list*](api::OrganizationLocationOperationListCall), [*locations workloads create*](api::OrganizationLocationWorkloadCreateCall), [*locations workloads delete*](api::OrganizationLocationWorkloadDeleteCall), [*locations workloads get*](api::OrganizationLocationWorkloadGetCall), [*locations workloads list*](api::OrganizationLocationWorkloadListCall), [*locations workloads mutate partner permissions*](api::OrganizationLocationWorkloadMutatePartnerPermissionCall), [*locations workloads patch*](api::OrganizationLocationWorkloadPatchCall), [*locations workloads restrict allowed resources*](api::OrganizationLocationWorkloadRestrictAllowedResourceCall), [*locations workloads violations acknowledge*](api::OrganizationLocationWorkloadViolationAcknowledgeCall), [*locations workloads violations get*](api::OrganizationLocationWorkloadViolationGetCall) and [*locations workloads violations list*](api::OrganizationLocationWorkloadViolationListCall) @@ -53,8 +53,8 @@ //! let r = hub.organizations().locations_workloads_patch(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -83,12 +83,12 @@ //! use std::default::Default; //! use assuredworkloads1::{Assuredworkloads, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -130,10 +130,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -143,25 +143,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/authorizedbuyersmarketplace1/README.md b/gen/authorizedbuyersmarketplace1/README.md index d6c3ef91b9..a6f51a0a4e 100644 --- a/gen/authorizedbuyersmarketplace1/README.md +++ b/gen/authorizedbuyersmarketplace1/README.md @@ -11,7 +11,7 @@ Everything else about the *Authorized Buyers Marketplace* *v1* API can be found [official documentation site](https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-authorizedbuyersmarketplace1/5.0.3+20230124/google_authorizedbuyersmarketplace1/AuthorizedBuyersMarketplace) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-authorizedbuyersmarketplace1/5.0.3+20230124/google_authorizedbuyersmarketplace1/AuthorizedBuyersMarketplace) ... * bidders * [*finalized deals list*](https://docs.rs/google-authorizedbuyersmarketplace1/5.0.3+20230124/google_authorizedbuyersmarketplace1/api::BidderFinalizedDealListCall) @@ -57,8 +57,8 @@ let r = hub.buyers().proposals_patch(...).doit().await let r = hub.buyers().proposals_send_rfp(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -86,12 +86,12 @@ use authorizedbuyersmarketplace1::{Result, Error}; use std::default::Default; use authorizedbuyersmarketplace1::{AuthorizedBuyersMarketplace, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -133,10 +133,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-authorizedbuyersmarketplace1/5.0.3+20230124/google_authorizedbuyersmarketplace1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-authorizedbuyersmarketplace1/5.0.3+20230124/google_authorizedbuyersmarketplace1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -146,25 +146,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-author You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-authorizedbuyersmarketplace1/5.0.3+20230124/google_authorizedbuyersmarketplace1/client::Delegate) to the -[Method Builder](https://docs.rs/google-authorizedbuyersmarketplace1/5.0.3+20230124/google_authorizedbuyersmarketplace1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-authorizedbuyersmarketplace1/5.0.3+20230124/google_authorizedbuyersmarketplace1/client::Delegate) to the +[Method Builder](https://docs.rs/google-authorizedbuyersmarketplace1/5.0.3+20230124/google_authorizedbuyersmarketplace1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-authorizedbuyersmarketplace1/5.0.3+20230124/google_authorizedbuyersmarketplace1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-authorizedbuyersmarketplace1/5.0.3+20230124/google_authorizedbuyersmarketplace1/client::RequestValue) and -[decodable](https://docs.rs/google-authorizedbuyersmarketplace1/5.0.3+20230124/google_authorizedbuyersmarketplace1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-authorizedbuyersmarketplace1/5.0.3+20230124/google_authorizedbuyersmarketplace1/client::RequestValue) and +[decodable](https://docs.rs/google-authorizedbuyersmarketplace1/5.0.3+20230124/google_authorizedbuyersmarketplace1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-authorizedbuyersmarketplace1/5.0.3+20230124/google_authorizedbuyersmarketplace1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-authorizedbuyersmarketplace1/5.0.3+20230124/google_authorizedbuyersmarketplace1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -183,7 +183,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **authorizedbuyersmarketplace1** library was generated by Sebastian Thiel, and is placed +The **authorizedbuyersmarketplace1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/authorizedbuyersmarketplace1/src/api.rs b/gen/authorizedbuyersmarketplace1/src/api.rs index 408a1d27ef..f88d5aff5e 100644 --- a/gen/authorizedbuyersmarketplace1/src/api.rs +++ b/gen/authorizedbuyersmarketplace1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, create, edit, and delete your Authorized Buyers Marketplace entities. AuthorizedBuyerMarketplace, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use authorizedbuyersmarketplace1::{AuthorizedBuyersMarketplace, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/authorizedbuyersmarketplace1/src/lib.rs b/gen/authorizedbuyersmarketplace1/src/lib.rs index 19d7250e98..71a26b60dd 100644 --- a/gen/authorizedbuyersmarketplace1/src/lib.rs +++ b/gen/authorizedbuyersmarketplace1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/authorizedbuyersmarketplace1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](AuthorizedBuyersMarketplace) ... +//! Handle the following *Resources* with ease from the central [hub](AuthorizedBuyersMarketplace) ... //! //! * bidders //! * [*finalized deals list*](api::BidderFinalizedDealListCall) @@ -57,8 +57,8 @@ //! let r = hub.buyers().proposals_send_rfp(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -87,12 +87,12 @@ //! use std::default::Default; //! use authorizedbuyersmarketplace1::{AuthorizedBuyersMarketplace, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -134,10 +134,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -147,25 +147,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/autoscaler1_beta2/README.md b/gen/autoscaler1_beta2/README.md index 8004f087aa..0664c1be8e 100644 --- a/gen/autoscaler1_beta2/README.md +++ b/gen/autoscaler1_beta2/README.md @@ -11,7 +11,7 @@ Everything else about the *autoscaler* *v1_beta2* API can be found at the [official documentation site](http://developers.google.com/compute/docs/autoscaler). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-autoscaler1_beta2/5.0.3+20150629/google_autoscaler1_beta2/AutoscalerHub) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-autoscaler1_beta2/5.0.3+20150629/google_autoscaler1_beta2/AutoscalerHub) ... * [autoscalers](https://docs.rs/google-autoscaler1_beta2/5.0.3+20150629/google_autoscaler1_beta2/api::Autoscaler) * [*delete*](https://docs.rs/google-autoscaler1_beta2/5.0.3+20150629/google_autoscaler1_beta2/api::AutoscalerDeleteCall), [*get*](https://docs.rs/google-autoscaler1_beta2/5.0.3+20150629/google_autoscaler1_beta2/api::AutoscalerGetCall), [*insert*](https://docs.rs/google-autoscaler1_beta2/5.0.3+20150629/google_autoscaler1_beta2/api::AutoscalerInsertCall), [*list*](https://docs.rs/google-autoscaler1_beta2/5.0.3+20150629/google_autoscaler1_beta2/api::AutoscalerListCall), [*patch*](https://docs.rs/google-autoscaler1_beta2/5.0.3+20150629/google_autoscaler1_beta2/api::AutoscalerPatchCall) and [*update*](https://docs.rs/google-autoscaler1_beta2/5.0.3+20150629/google_autoscaler1_beta2/api::AutoscalerUpdateCall) @@ -59,8 +59,8 @@ let r = hub.autoscalers().patch(...).doit().await let r = hub.autoscalers().update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -87,12 +87,12 @@ use autoscaler1_beta2::{Result, Error}; use std::default::Default; use autoscaler1_beta2::{AutoscalerHub, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -131,10 +131,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-autoscaler1_beta2/5.0.3+20150629/google_autoscaler1_beta2/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-autoscaler1_beta2/5.0.3+20150629/google_autoscaler1_beta2/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -144,25 +144,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-autosc You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-autoscaler1_beta2/5.0.3+20150629/google_autoscaler1_beta2/client::Delegate) to the -[Method Builder](https://docs.rs/google-autoscaler1_beta2/5.0.3+20150629/google_autoscaler1_beta2/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-autoscaler1_beta2/5.0.3+20150629/google_autoscaler1_beta2/client::Delegate) to the +[Method Builder](https://docs.rs/google-autoscaler1_beta2/5.0.3+20150629/google_autoscaler1_beta2/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-autoscaler1_beta2/5.0.3+20150629/google_autoscaler1_beta2/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-autoscaler1_beta2/5.0.3+20150629/google_autoscaler1_beta2/client::RequestValue) and -[decodable](https://docs.rs/google-autoscaler1_beta2/5.0.3+20150629/google_autoscaler1_beta2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-autoscaler1_beta2/5.0.3+20150629/google_autoscaler1_beta2/client::RequestValue) and +[decodable](https://docs.rs/google-autoscaler1_beta2/5.0.3+20150629/google_autoscaler1_beta2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-autoscaler1_beta2/5.0.3+20150629/google_autoscaler1_beta2/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-autoscaler1_beta2/5.0.3+20150629/google_autoscaler1_beta2/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -181,7 +181,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **autoscaler1_beta2** library was generated by Sebastian Thiel, and is placed +The **autoscaler1_beta2** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/autoscaler1_beta2/src/api.rs b/gen/autoscaler1_beta2/src/api.rs index bc9502bb6f..c3a578301c 100644 --- a/gen/autoscaler1_beta2/src/api.rs +++ b/gen/autoscaler1_beta2/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your Google Compute Engine resources Compute, @@ -68,12 +68,12 @@ impl Default for Scope { /// use std::default::Default; /// use autoscaler1_beta2::{AutoscalerHub, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/autoscaler1_beta2/src/lib.rs b/gen/autoscaler1_beta2/src/lib.rs index 921182873d..1bf4ba8582 100644 --- a/gen/autoscaler1_beta2/src/lib.rs +++ b/gen/autoscaler1_beta2/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/autoscaler1_beta2). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](AutoscalerHub) ... +//! Handle the following *Resources* with ease from the central [hub](AutoscalerHub) ... //! //! * [autoscalers](api::Autoscaler) //! * [*delete*](api::AutoscalerDeleteCall), [*get*](api::AutoscalerGetCall), [*insert*](api::AutoscalerInsertCall), [*list*](api::AutoscalerListCall), [*patch*](api::AutoscalerPatchCall) and [*update*](api::AutoscalerUpdateCall) @@ -59,8 +59,8 @@ //! let r = hub.autoscalers().update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -88,12 +88,12 @@ //! use std::default::Default; //! use autoscaler1_beta2::{AutoscalerHub, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -132,10 +132,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -145,25 +145,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/baremetalsolution2/README.md b/gen/baremetalsolution2/README.md index f410021ec0..a74d103f6b 100644 --- a/gen/baremetalsolution2/README.md +++ b/gen/baremetalsolution2/README.md @@ -11,7 +11,7 @@ Everything else about the *baremetalsolution* *v2* API can be found at the [official documentation site](https://cloud.google.com/bare-metal). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/Baremetalsolution) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/Baremetalsolution) ... * projects * [*locations get*](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/api::ProjectLocationGetCall), [*locations instance provisioning settings fetch*](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/api::ProjectLocationInstanceProvisioningSettingFetchCall), [*locations instances create*](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/api::ProjectLocationInstanceCreateCall), [*locations instances detach lun*](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/api::ProjectLocationInstanceDetachLunCall), [*locations instances disable interactive serial console*](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/api::ProjectLocationInstanceDisableInteractiveSerialConsoleCall), [*locations instances enable interactive serial console*](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/api::ProjectLocationInstanceEnableInteractiveSerialConsoleCall), [*locations instances get*](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/api::ProjectLocationInstanceGetCall), [*locations instances list*](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/api::ProjectLocationInstanceListCall), [*locations instances patch*](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/api::ProjectLocationInstancePatchCall), [*locations instances reset*](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/api::ProjectLocationInstanceResetCall), [*locations instances start*](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/api::ProjectLocationInstanceStartCall), [*locations instances stop*](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/api::ProjectLocationInstanceStopCall), [*locations list*](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/api::ProjectLocationListCall), [*locations networks get*](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/api::ProjectLocationNetworkGetCall), [*locations networks list*](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/api::ProjectLocationNetworkListCall), [*locations networks list network usage*](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/api::ProjectLocationNetworkListNetworkUsageCall), [*locations networks patch*](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/api::ProjectLocationNetworkPatchCall), [*locations nfs shares create*](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/api::ProjectLocationNfsShareCreateCall), [*locations nfs shares delete*](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/api::ProjectLocationNfsShareDeleteCall), [*locations nfs shares get*](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/api::ProjectLocationNfsShareGetCall), [*locations nfs shares list*](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/api::ProjectLocationNfsShareListCall), [*locations nfs shares patch*](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/api::ProjectLocationNfsSharePatchCall), [*locations operations get*](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/api::ProjectLocationOperationGetCall), [*locations provisioning configs create*](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/api::ProjectLocationProvisioningConfigCreateCall), [*locations provisioning configs get*](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/api::ProjectLocationProvisioningConfigGetCall), [*locations provisioning configs patch*](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/api::ProjectLocationProvisioningConfigPatchCall), [*locations provisioning configs submit*](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/api::ProjectLocationProvisioningConfigSubmitCall), [*locations provisioning quotas list*](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/api::ProjectLocationProvisioningQuotaListCall), [*locations ssh keys create*](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/api::ProjectLocationSshKeyCreateCall), [*locations ssh keys delete*](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/api::ProjectLocationSshKeyDeleteCall), [*locations ssh keys list*](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/api::ProjectLocationSshKeyListCall), [*locations volumes get*](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/api::ProjectLocationVolumeGetCall), [*locations volumes list*](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/api::ProjectLocationVolumeListCall), [*locations volumes luns get*](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/api::ProjectLocationVolumeLunGetCall), [*locations volumes luns list*](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/api::ProjectLocationVolumeLunListCall), [*locations volumes patch*](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/api::ProjectLocationVolumePatchCall), [*locations volumes resize*](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/api::ProjectLocationVolumeResizeCall), [*locations volumes snapshots create*](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/api::ProjectLocationVolumeSnapshotCreateCall), [*locations volumes snapshots delete*](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/api::ProjectLocationVolumeSnapshotDeleteCall), [*locations volumes snapshots get*](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/api::ProjectLocationVolumeSnapshotGetCall), [*locations volumes snapshots list*](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/api::ProjectLocationVolumeSnapshotListCall) and [*locations volumes snapshots restore volume snapshot*](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/api::ProjectLocationVolumeSnapshotRestoreVolumeSnapshotCall) @@ -65,8 +65,8 @@ let r = hub.projects().locations_volumes_patch(...).doit().await let r = hub.projects().locations_volumes_resize(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -94,12 +94,12 @@ use baremetalsolution2::{Result, Error}; use std::default::Default; use baremetalsolution2::{Baremetalsolution, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -141,10 +141,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -154,25 +154,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-bareme You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/client::Delegate) to the -[Method Builder](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/client::Delegate) to the +[Method Builder](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/client::RequestValue) and -[decodable](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/client::RequestValue) and +[decodable](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-baremetalsolution2/5.0.3+20230113/google_baremetalsolution2/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -191,7 +191,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **baremetalsolution2** library was generated by Sebastian Thiel, and is placed +The **baremetalsolution2** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/baremetalsolution2/src/api.rs b/gen/baremetalsolution2/src/api.rs index 166b8e9d62..0187af73d1 100644 --- a/gen/baremetalsolution2/src/api.rs +++ b/gen/baremetalsolution2/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use baremetalsolution2::{Baremetalsolution, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/baremetalsolution2/src/lib.rs b/gen/baremetalsolution2/src/lib.rs index ffb99961c7..862fffe02c 100644 --- a/gen/baremetalsolution2/src/lib.rs +++ b/gen/baremetalsolution2/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/baremetalsolution2). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Baremetalsolution) ... +//! Handle the following *Resources* with ease from the central [hub](Baremetalsolution) ... //! //! * projects //! * [*locations get*](api::ProjectLocationGetCall), [*locations instance provisioning settings fetch*](api::ProjectLocationInstanceProvisioningSettingFetchCall), [*locations instances create*](api::ProjectLocationInstanceCreateCall), [*locations instances detach lun*](api::ProjectLocationInstanceDetachLunCall), [*locations instances disable interactive serial console*](api::ProjectLocationInstanceDisableInteractiveSerialConsoleCall), [*locations instances enable interactive serial console*](api::ProjectLocationInstanceEnableInteractiveSerialConsoleCall), [*locations instances get*](api::ProjectLocationInstanceGetCall), [*locations instances list*](api::ProjectLocationInstanceListCall), [*locations instances patch*](api::ProjectLocationInstancePatchCall), [*locations instances reset*](api::ProjectLocationInstanceResetCall), [*locations instances start*](api::ProjectLocationInstanceStartCall), [*locations instances stop*](api::ProjectLocationInstanceStopCall), [*locations list*](api::ProjectLocationListCall), [*locations networks get*](api::ProjectLocationNetworkGetCall), [*locations networks list*](api::ProjectLocationNetworkListCall), [*locations networks list network usage*](api::ProjectLocationNetworkListNetworkUsageCall), [*locations networks patch*](api::ProjectLocationNetworkPatchCall), [*locations nfs shares create*](api::ProjectLocationNfsShareCreateCall), [*locations nfs shares delete*](api::ProjectLocationNfsShareDeleteCall), [*locations nfs shares get*](api::ProjectLocationNfsShareGetCall), [*locations nfs shares list*](api::ProjectLocationNfsShareListCall), [*locations nfs shares patch*](api::ProjectLocationNfsSharePatchCall), [*locations operations get*](api::ProjectLocationOperationGetCall), [*locations provisioning configs create*](api::ProjectLocationProvisioningConfigCreateCall), [*locations provisioning configs get*](api::ProjectLocationProvisioningConfigGetCall), [*locations provisioning configs patch*](api::ProjectLocationProvisioningConfigPatchCall), [*locations provisioning configs submit*](api::ProjectLocationProvisioningConfigSubmitCall), [*locations provisioning quotas list*](api::ProjectLocationProvisioningQuotaListCall), [*locations ssh keys create*](api::ProjectLocationSshKeyCreateCall), [*locations ssh keys delete*](api::ProjectLocationSshKeyDeleteCall), [*locations ssh keys list*](api::ProjectLocationSshKeyListCall), [*locations volumes get*](api::ProjectLocationVolumeGetCall), [*locations volumes list*](api::ProjectLocationVolumeListCall), [*locations volumes luns get*](api::ProjectLocationVolumeLunGetCall), [*locations volumes luns list*](api::ProjectLocationVolumeLunListCall), [*locations volumes patch*](api::ProjectLocationVolumePatchCall), [*locations volumes resize*](api::ProjectLocationVolumeResizeCall), [*locations volumes snapshots create*](api::ProjectLocationVolumeSnapshotCreateCall), [*locations volumes snapshots delete*](api::ProjectLocationVolumeSnapshotDeleteCall), [*locations volumes snapshots get*](api::ProjectLocationVolumeSnapshotGetCall), [*locations volumes snapshots list*](api::ProjectLocationVolumeSnapshotListCall) and [*locations volumes snapshots restore volume snapshot*](api::ProjectLocationVolumeSnapshotRestoreVolumeSnapshotCall) @@ -65,8 +65,8 @@ //! let r = hub.projects().locations_volumes_resize(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -95,12 +95,12 @@ //! use std::default::Default; //! use baremetalsolution2::{Baremetalsolution, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -142,10 +142,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -155,25 +155,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/bigquery2/README.md b/gen/bigquery2/README.md index 1f35d2dc82..fa1d4d3f64 100644 --- a/gen/bigquery2/README.md +++ b/gen/bigquery2/README.md @@ -11,7 +11,7 @@ Everything else about the *bigquery* *v2* API can be found at the [official documentation site](https://cloud.google.com/bigquery/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-bigquery2/5.0.3+20230114/google_bigquery2/Bigquery) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-bigquery2/5.0.3+20230114/google_bigquery2/Bigquery) ... * [datasets](https://docs.rs/google-bigquery2/5.0.3+20230114/google_bigquery2/api::Dataset) * [*delete*](https://docs.rs/google-bigquery2/5.0.3+20230114/google_bigquery2/api::DatasetDeleteCall), [*get*](https://docs.rs/google-bigquery2/5.0.3+20230114/google_bigquery2/api::DatasetGetCall), [*insert*](https://docs.rs/google-bigquery2/5.0.3+20230114/google_bigquery2/api::DatasetInsertCall), [*list*](https://docs.rs/google-bigquery2/5.0.3+20230114/google_bigquery2/api::DatasetListCall), [*patch*](https://docs.rs/google-bigquery2/5.0.3+20230114/google_bigquery2/api::DatasetPatchCall) and [*update*](https://docs.rs/google-bigquery2/5.0.3+20230114/google_bigquery2/api::DatasetUpdateCall) @@ -76,8 +76,8 @@ let r = hub.tables().test_iam_permissions(...).doit().await let r = hub.tables().update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -104,12 +104,12 @@ use bigquery2::{Result, Error}; use std::default::Default; use bigquery2::{Bigquery, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -147,10 +147,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-bigquery2/5.0.3+20230114/google_bigquery2/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-bigquery2/5.0.3+20230114/google_bigquery2/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -160,25 +160,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-bigque You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-bigquery2/5.0.3+20230114/google_bigquery2/client::Delegate) to the -[Method Builder](https://docs.rs/google-bigquery2/5.0.3+20230114/google_bigquery2/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-bigquery2/5.0.3+20230114/google_bigquery2/client::Delegate) to the +[Method Builder](https://docs.rs/google-bigquery2/5.0.3+20230114/google_bigquery2/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-bigquery2/5.0.3+20230114/google_bigquery2/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-bigquery2/5.0.3+20230114/google_bigquery2/client::RequestValue) and -[decodable](https://docs.rs/google-bigquery2/5.0.3+20230114/google_bigquery2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-bigquery2/5.0.3+20230114/google_bigquery2/client::RequestValue) and +[decodable](https://docs.rs/google-bigquery2/5.0.3+20230114/google_bigquery2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-bigquery2/5.0.3+20230114/google_bigquery2/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-bigquery2/5.0.3+20230114/google_bigquery2/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -197,7 +197,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **bigquery2** library was generated by Sebastian Thiel, and is placed +The **bigquery2** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/bigquery2/src/api.rs b/gen/bigquery2/src/api.rs index c6b6b9088b..e3d5f6bc05 100644 --- a/gen/bigquery2/src/api.rs +++ b/gen/bigquery2/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your data in Google BigQuery and see the email address for your Google Account Full, @@ -88,12 +88,12 @@ impl Default for Scope { /// use std::default::Default; /// use bigquery2::{Bigquery, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/bigquery2/src/lib.rs b/gen/bigquery2/src/lib.rs index 4527b0bd06..ad5efc595f 100644 --- a/gen/bigquery2/src/lib.rs +++ b/gen/bigquery2/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/bigquery2). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Bigquery) ... +//! Handle the following *Resources* with ease from the central [hub](Bigquery) ... //! //! * [datasets](api::Dataset) //! * [*delete*](api::DatasetDeleteCall), [*get*](api::DatasetGetCall), [*insert*](api::DatasetInsertCall), [*list*](api::DatasetListCall), [*patch*](api::DatasetPatchCall) and [*update*](api::DatasetUpdateCall) @@ -76,8 +76,8 @@ //! let r = hub.tables().update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -105,12 +105,12 @@ //! use std::default::Default; //! use bigquery2::{Bigquery, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -148,10 +148,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -161,25 +161,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/bigqueryconnection1_beta1/README.md b/gen/bigqueryconnection1_beta1/README.md index 2dd58632b4..400897529b 100644 --- a/gen/bigqueryconnection1_beta1/README.md +++ b/gen/bigqueryconnection1_beta1/README.md @@ -11,7 +11,7 @@ Everything else about the *BigQuery Connection Service* *v1_beta1* API can be fo [official documentation site](https://cloud.google.com/bigquery/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-bigqueryconnection1_beta1/5.0.3+20230115/google_bigqueryconnection1_beta1/BigQueryConnectionService) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-bigqueryconnection1_beta1/5.0.3+20230115/google_bigqueryconnection1_beta1/BigQueryConnectionService) ... * projects * [*locations connections create*](https://docs.rs/google-bigqueryconnection1_beta1/5.0.3+20230115/google_bigqueryconnection1_beta1/api::ProjectLocationConnectionCreateCall), [*locations connections delete*](https://docs.rs/google-bigqueryconnection1_beta1/5.0.3+20230115/google_bigqueryconnection1_beta1/api::ProjectLocationConnectionDeleteCall), [*locations connections get*](https://docs.rs/google-bigqueryconnection1_beta1/5.0.3+20230115/google_bigqueryconnection1_beta1/api::ProjectLocationConnectionGetCall), [*locations connections get iam policy*](https://docs.rs/google-bigqueryconnection1_beta1/5.0.3+20230115/google_bigqueryconnection1_beta1/api::ProjectLocationConnectionGetIamPolicyCall), [*locations connections list*](https://docs.rs/google-bigqueryconnection1_beta1/5.0.3+20230115/google_bigqueryconnection1_beta1/api::ProjectLocationConnectionListCall), [*locations connections patch*](https://docs.rs/google-bigqueryconnection1_beta1/5.0.3+20230115/google_bigqueryconnection1_beta1/api::ProjectLocationConnectionPatchCall), [*locations connections set iam policy*](https://docs.rs/google-bigqueryconnection1_beta1/5.0.3+20230115/google_bigqueryconnection1_beta1/api::ProjectLocationConnectionSetIamPolicyCall), [*locations connections test iam permissions*](https://docs.rs/google-bigqueryconnection1_beta1/5.0.3+20230115/google_bigqueryconnection1_beta1/api::ProjectLocationConnectionTestIamPermissionCall) and [*locations connections update credential*](https://docs.rs/google-bigqueryconnection1_beta1/5.0.3+20230115/google_bigqueryconnection1_beta1/api::ProjectLocationConnectionUpdateCredentialCall) @@ -52,8 +52,8 @@ let r = hub.projects().locations_connections_get(...).doit().await let r = hub.projects().locations_connections_patch(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -81,12 +81,12 @@ use bigqueryconnection1_beta1::{Result, Error}; use std::default::Default; use bigqueryconnection1_beta1::{BigQueryConnectionService, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -128,10 +128,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-bigqueryconnection1_beta1/5.0.3+20230115/google_bigqueryconnection1_beta1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-bigqueryconnection1_beta1/5.0.3+20230115/google_bigqueryconnection1_beta1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -141,25 +141,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-bigque You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-bigqueryconnection1_beta1/5.0.3+20230115/google_bigqueryconnection1_beta1/client::Delegate) to the -[Method Builder](https://docs.rs/google-bigqueryconnection1_beta1/5.0.3+20230115/google_bigqueryconnection1_beta1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-bigqueryconnection1_beta1/5.0.3+20230115/google_bigqueryconnection1_beta1/client::Delegate) to the +[Method Builder](https://docs.rs/google-bigqueryconnection1_beta1/5.0.3+20230115/google_bigqueryconnection1_beta1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-bigqueryconnection1_beta1/5.0.3+20230115/google_bigqueryconnection1_beta1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-bigqueryconnection1_beta1/5.0.3+20230115/google_bigqueryconnection1_beta1/client::RequestValue) and -[decodable](https://docs.rs/google-bigqueryconnection1_beta1/5.0.3+20230115/google_bigqueryconnection1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-bigqueryconnection1_beta1/5.0.3+20230115/google_bigqueryconnection1_beta1/client::RequestValue) and +[decodable](https://docs.rs/google-bigqueryconnection1_beta1/5.0.3+20230115/google_bigqueryconnection1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-bigqueryconnection1_beta1/5.0.3+20230115/google_bigqueryconnection1_beta1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-bigqueryconnection1_beta1/5.0.3+20230115/google_bigqueryconnection1_beta1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -178,7 +178,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **bigqueryconnection1_beta1** library was generated by Sebastian Thiel, and is placed +The **bigqueryconnection1_beta1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/bigqueryconnection1_beta1/src/api.rs b/gen/bigqueryconnection1_beta1/src/api.rs index 4103d2d111..137a13743e 100644 --- a/gen/bigqueryconnection1_beta1/src/api.rs +++ b/gen/bigqueryconnection1_beta1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your data in Google BigQuery and see the email address for your Google Account Bigquery, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use bigqueryconnection1_beta1::{BigQueryConnectionService, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/bigqueryconnection1_beta1/src/lib.rs b/gen/bigqueryconnection1_beta1/src/lib.rs index 7a79d73a5a..cf6902f14c 100644 --- a/gen/bigqueryconnection1_beta1/src/lib.rs +++ b/gen/bigqueryconnection1_beta1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/bigqueryconnection1_beta1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](BigQueryConnectionService) ... +//! Handle the following *Resources* with ease from the central [hub](BigQueryConnectionService) ... //! //! * projects //! * [*locations connections create*](api::ProjectLocationConnectionCreateCall), [*locations connections delete*](api::ProjectLocationConnectionDeleteCall), [*locations connections get*](api::ProjectLocationConnectionGetCall), [*locations connections get iam policy*](api::ProjectLocationConnectionGetIamPolicyCall), [*locations connections list*](api::ProjectLocationConnectionListCall), [*locations connections patch*](api::ProjectLocationConnectionPatchCall), [*locations connections set iam policy*](api::ProjectLocationConnectionSetIamPolicyCall), [*locations connections test iam permissions*](api::ProjectLocationConnectionTestIamPermissionCall) and [*locations connections update credential*](api::ProjectLocationConnectionUpdateCredentialCall) @@ -52,8 +52,8 @@ //! let r = hub.projects().locations_connections_patch(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -82,12 +82,12 @@ //! use std::default::Default; //! use bigqueryconnection1_beta1::{BigQueryConnectionService, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -129,10 +129,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -142,25 +142,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/bigquerydatatransfer1/README.md b/gen/bigquerydatatransfer1/README.md index c2f07f870a..bb05cc106b 100644 --- a/gen/bigquerydatatransfer1/README.md +++ b/gen/bigquerydatatransfer1/README.md @@ -11,7 +11,7 @@ Everything else about the *BigQuery Data Transfer* *v1* API can be found at the [official documentation site](https://cloud.google.com/bigquery-transfer/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-bigquerydatatransfer1/5.0.3+20230115/google_bigquerydatatransfer1/BigQueryDataTransfer) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-bigquerydatatransfer1/5.0.3+20230115/google_bigquerydatatransfer1/BigQueryDataTransfer) ... * projects * [*data sources check valid creds*](https://docs.rs/google-bigquerydatatransfer1/5.0.3+20230115/google_bigquerydatatransfer1/api::ProjectDataSourceCheckValidCredCall), [*data sources get*](https://docs.rs/google-bigquerydatatransfer1/5.0.3+20230115/google_bigquerydatatransfer1/api::ProjectDataSourceGetCall), [*data sources list*](https://docs.rs/google-bigquerydatatransfer1/5.0.3+20230115/google_bigquerydatatransfer1/api::ProjectDataSourceListCall), [*enroll data sources*](https://docs.rs/google-bigquerydatatransfer1/5.0.3+20230115/google_bigquerydatatransfer1/api::ProjectEnrollDataSourceCall), [*locations data sources check valid creds*](https://docs.rs/google-bigquerydatatransfer1/5.0.3+20230115/google_bigquerydatatransfer1/api::ProjectLocationDataSourceCheckValidCredCall), [*locations data sources get*](https://docs.rs/google-bigquerydatatransfer1/5.0.3+20230115/google_bigquerydatatransfer1/api::ProjectLocationDataSourceGetCall), [*locations data sources list*](https://docs.rs/google-bigquerydatatransfer1/5.0.3+20230115/google_bigquerydatatransfer1/api::ProjectLocationDataSourceListCall), [*locations enroll data sources*](https://docs.rs/google-bigquerydatatransfer1/5.0.3+20230115/google_bigquerydatatransfer1/api::ProjectLocationEnrollDataSourceCall), [*locations get*](https://docs.rs/google-bigquerydatatransfer1/5.0.3+20230115/google_bigquerydatatransfer1/api::ProjectLocationGetCall), [*locations list*](https://docs.rs/google-bigquerydatatransfer1/5.0.3+20230115/google_bigquerydatatransfer1/api::ProjectLocationListCall), [*locations transfer configs create*](https://docs.rs/google-bigquerydatatransfer1/5.0.3+20230115/google_bigquerydatatransfer1/api::ProjectLocationTransferConfigCreateCall), [*locations transfer configs delete*](https://docs.rs/google-bigquerydatatransfer1/5.0.3+20230115/google_bigquerydatatransfer1/api::ProjectLocationTransferConfigDeleteCall), [*locations transfer configs get*](https://docs.rs/google-bigquerydatatransfer1/5.0.3+20230115/google_bigquerydatatransfer1/api::ProjectLocationTransferConfigGetCall), [*locations transfer configs list*](https://docs.rs/google-bigquerydatatransfer1/5.0.3+20230115/google_bigquerydatatransfer1/api::ProjectLocationTransferConfigListCall), [*locations transfer configs patch*](https://docs.rs/google-bigquerydatatransfer1/5.0.3+20230115/google_bigquerydatatransfer1/api::ProjectLocationTransferConfigPatchCall), [*locations transfer configs runs delete*](https://docs.rs/google-bigquerydatatransfer1/5.0.3+20230115/google_bigquerydatatransfer1/api::ProjectLocationTransferConfigRunDeleteCall), [*locations transfer configs runs get*](https://docs.rs/google-bigquerydatatransfer1/5.0.3+20230115/google_bigquerydatatransfer1/api::ProjectLocationTransferConfigRunGetCall), [*locations transfer configs runs list*](https://docs.rs/google-bigquerydatatransfer1/5.0.3+20230115/google_bigquerydatatransfer1/api::ProjectLocationTransferConfigRunListCall), [*locations transfer configs runs transfer logs list*](https://docs.rs/google-bigquerydatatransfer1/5.0.3+20230115/google_bigquerydatatransfer1/api::ProjectLocationTransferConfigRunTransferLogListCall), [*locations transfer configs schedule runs*](https://docs.rs/google-bigquerydatatransfer1/5.0.3+20230115/google_bigquerydatatransfer1/api::ProjectLocationTransferConfigScheduleRunCall), [*locations transfer configs start manual runs*](https://docs.rs/google-bigquerydatatransfer1/5.0.3+20230115/google_bigquerydatatransfer1/api::ProjectLocationTransferConfigStartManualRunCall), [*transfer configs create*](https://docs.rs/google-bigquerydatatransfer1/5.0.3+20230115/google_bigquerydatatransfer1/api::ProjectTransferConfigCreateCall), [*transfer configs delete*](https://docs.rs/google-bigquerydatatransfer1/5.0.3+20230115/google_bigquerydatatransfer1/api::ProjectTransferConfigDeleteCall), [*transfer configs get*](https://docs.rs/google-bigquerydatatransfer1/5.0.3+20230115/google_bigquerydatatransfer1/api::ProjectTransferConfigGetCall), [*transfer configs list*](https://docs.rs/google-bigquerydatatransfer1/5.0.3+20230115/google_bigquerydatatransfer1/api::ProjectTransferConfigListCall), [*transfer configs patch*](https://docs.rs/google-bigquerydatatransfer1/5.0.3+20230115/google_bigquerydatatransfer1/api::ProjectTransferConfigPatchCall), [*transfer configs runs delete*](https://docs.rs/google-bigquerydatatransfer1/5.0.3+20230115/google_bigquerydatatransfer1/api::ProjectTransferConfigRunDeleteCall), [*transfer configs runs get*](https://docs.rs/google-bigquerydatatransfer1/5.0.3+20230115/google_bigquerydatatransfer1/api::ProjectTransferConfigRunGetCall), [*transfer configs runs list*](https://docs.rs/google-bigquerydatatransfer1/5.0.3+20230115/google_bigquerydatatransfer1/api::ProjectTransferConfigRunListCall), [*transfer configs runs transfer logs list*](https://docs.rs/google-bigquerydatatransfer1/5.0.3+20230115/google_bigquerydatatransfer1/api::ProjectTransferConfigRunTransferLogListCall), [*transfer configs schedule runs*](https://docs.rs/google-bigquerydatatransfer1/5.0.3+20230115/google_bigquerydatatransfer1/api::ProjectTransferConfigScheduleRunCall) and [*transfer configs start manual runs*](https://docs.rs/google-bigquerydatatransfer1/5.0.3+20230115/google_bigquerydatatransfer1/api::ProjectTransferConfigStartManualRunCall) @@ -55,8 +55,8 @@ let r = hub.projects().transfer_configs_get(...).doit().await let r = hub.projects().transfer_configs_patch(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -84,12 +84,12 @@ use bigquerydatatransfer1::{Result, Error}; use std::default::Default; use bigquerydatatransfer1::{BigQueryDataTransfer, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -134,10 +134,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-bigquerydatatransfer1/5.0.3+20230115/google_bigquerydatatransfer1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-bigquerydatatransfer1/5.0.3+20230115/google_bigquerydatatransfer1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -147,25 +147,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-bigque You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-bigquerydatatransfer1/5.0.3+20230115/google_bigquerydatatransfer1/client::Delegate) to the -[Method Builder](https://docs.rs/google-bigquerydatatransfer1/5.0.3+20230115/google_bigquerydatatransfer1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-bigquerydatatransfer1/5.0.3+20230115/google_bigquerydatatransfer1/client::Delegate) to the +[Method Builder](https://docs.rs/google-bigquerydatatransfer1/5.0.3+20230115/google_bigquerydatatransfer1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-bigquerydatatransfer1/5.0.3+20230115/google_bigquerydatatransfer1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-bigquerydatatransfer1/5.0.3+20230115/google_bigquerydatatransfer1/client::RequestValue) and -[decodable](https://docs.rs/google-bigquerydatatransfer1/5.0.3+20230115/google_bigquerydatatransfer1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-bigquerydatatransfer1/5.0.3+20230115/google_bigquerydatatransfer1/client::RequestValue) and +[decodable](https://docs.rs/google-bigquerydatatransfer1/5.0.3+20230115/google_bigquerydatatransfer1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-bigquerydatatransfer1/5.0.3+20230115/google_bigquerydatatransfer1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-bigquerydatatransfer1/5.0.3+20230115/google_bigquerydatatransfer1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -184,7 +184,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **bigquerydatatransfer1** library was generated by Sebastian Thiel, and is placed +The **bigquerydatatransfer1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/bigquerydatatransfer1/src/api.rs b/gen/bigquerydatatransfer1/src/api.rs index af6fe605e6..130edefb75 100644 --- a/gen/bigquerydatatransfer1/src/api.rs +++ b/gen/bigquerydatatransfer1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your data in Google BigQuery and see the email address for your Google Account Bigquery, @@ -73,12 +73,12 @@ impl Default for Scope { /// use std::default::Default; /// use bigquerydatatransfer1::{BigQueryDataTransfer, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/bigquerydatatransfer1/src/lib.rs b/gen/bigquerydatatransfer1/src/lib.rs index a17d6a5eb1..325eedc8d6 100644 --- a/gen/bigquerydatatransfer1/src/lib.rs +++ b/gen/bigquerydatatransfer1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/bigquerydatatransfer1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](BigQueryDataTransfer) ... +//! Handle the following *Resources* with ease from the central [hub](BigQueryDataTransfer) ... //! //! * projects //! * [*data sources check valid creds*](api::ProjectDataSourceCheckValidCredCall), [*data sources get*](api::ProjectDataSourceGetCall), [*data sources list*](api::ProjectDataSourceListCall), [*enroll data sources*](api::ProjectEnrollDataSourceCall), [*locations data sources check valid creds*](api::ProjectLocationDataSourceCheckValidCredCall), [*locations data sources get*](api::ProjectLocationDataSourceGetCall), [*locations data sources list*](api::ProjectLocationDataSourceListCall), [*locations enroll data sources*](api::ProjectLocationEnrollDataSourceCall), [*locations get*](api::ProjectLocationGetCall), [*locations list*](api::ProjectLocationListCall), [*locations transfer configs create*](api::ProjectLocationTransferConfigCreateCall), [*locations transfer configs delete*](api::ProjectLocationTransferConfigDeleteCall), [*locations transfer configs get*](api::ProjectLocationTransferConfigGetCall), [*locations transfer configs list*](api::ProjectLocationTransferConfigListCall), [*locations transfer configs patch*](api::ProjectLocationTransferConfigPatchCall), [*locations transfer configs runs delete*](api::ProjectLocationTransferConfigRunDeleteCall), [*locations transfer configs runs get*](api::ProjectLocationTransferConfigRunGetCall), [*locations transfer configs runs list*](api::ProjectLocationTransferConfigRunListCall), [*locations transfer configs runs transfer logs list*](api::ProjectLocationTransferConfigRunTransferLogListCall), [*locations transfer configs schedule runs*](api::ProjectLocationTransferConfigScheduleRunCall), [*locations transfer configs start manual runs*](api::ProjectLocationTransferConfigStartManualRunCall), [*transfer configs create*](api::ProjectTransferConfigCreateCall), [*transfer configs delete*](api::ProjectTransferConfigDeleteCall), [*transfer configs get*](api::ProjectTransferConfigGetCall), [*transfer configs list*](api::ProjectTransferConfigListCall), [*transfer configs patch*](api::ProjectTransferConfigPatchCall), [*transfer configs runs delete*](api::ProjectTransferConfigRunDeleteCall), [*transfer configs runs get*](api::ProjectTransferConfigRunGetCall), [*transfer configs runs list*](api::ProjectTransferConfigRunListCall), [*transfer configs runs transfer logs list*](api::ProjectTransferConfigRunTransferLogListCall), [*transfer configs schedule runs*](api::ProjectTransferConfigScheduleRunCall) and [*transfer configs start manual runs*](api::ProjectTransferConfigStartManualRunCall) @@ -55,8 +55,8 @@ //! let r = hub.projects().transfer_configs_patch(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -85,12 +85,12 @@ //! use std::default::Default; //! use bigquerydatatransfer1::{BigQueryDataTransfer, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -135,10 +135,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -148,25 +148,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/bigqueryreservation1/README.md b/gen/bigqueryreservation1/README.md index b5974adaa3..7a9b2caea2 100644 --- a/gen/bigqueryreservation1/README.md +++ b/gen/bigqueryreservation1/README.md @@ -11,7 +11,7 @@ Everything else about the *BigQuery Reservation* *v1* API can be found at the [official documentation site](https://cloud.google.com/bigquery/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-bigqueryreservation1/5.0.3+20230117/google_bigqueryreservation1/BigQueryReservation) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-bigqueryreservation1/5.0.3+20230117/google_bigqueryreservation1/BigQueryReservation) ... * projects * [*locations capacity commitments create*](https://docs.rs/google-bigqueryreservation1/5.0.3+20230117/google_bigqueryreservation1/api::ProjectLocationCapacityCommitmentCreateCall), [*locations capacity commitments delete*](https://docs.rs/google-bigqueryreservation1/5.0.3+20230117/google_bigqueryreservation1/api::ProjectLocationCapacityCommitmentDeleteCall), [*locations capacity commitments get*](https://docs.rs/google-bigqueryreservation1/5.0.3+20230117/google_bigqueryreservation1/api::ProjectLocationCapacityCommitmentGetCall), [*locations capacity commitments list*](https://docs.rs/google-bigqueryreservation1/5.0.3+20230117/google_bigqueryreservation1/api::ProjectLocationCapacityCommitmentListCall), [*locations capacity commitments merge*](https://docs.rs/google-bigqueryreservation1/5.0.3+20230117/google_bigqueryreservation1/api::ProjectLocationCapacityCommitmentMergeCall), [*locations capacity commitments patch*](https://docs.rs/google-bigqueryreservation1/5.0.3+20230117/google_bigqueryreservation1/api::ProjectLocationCapacityCommitmentPatchCall), [*locations capacity commitments split*](https://docs.rs/google-bigqueryreservation1/5.0.3+20230117/google_bigqueryreservation1/api::ProjectLocationCapacityCommitmentSplitCall), [*locations get bi reservation*](https://docs.rs/google-bigqueryreservation1/5.0.3+20230117/google_bigqueryreservation1/api::ProjectLocationGetBiReservationCall), [*locations reservations assignments create*](https://docs.rs/google-bigqueryreservation1/5.0.3+20230117/google_bigqueryreservation1/api::ProjectLocationReservationAssignmentCreateCall), [*locations reservations assignments delete*](https://docs.rs/google-bigqueryreservation1/5.0.3+20230117/google_bigqueryreservation1/api::ProjectLocationReservationAssignmentDeleteCall), [*locations reservations assignments list*](https://docs.rs/google-bigqueryreservation1/5.0.3+20230117/google_bigqueryreservation1/api::ProjectLocationReservationAssignmentListCall), [*locations reservations assignments move*](https://docs.rs/google-bigqueryreservation1/5.0.3+20230117/google_bigqueryreservation1/api::ProjectLocationReservationAssignmentMoveCall), [*locations reservations assignments patch*](https://docs.rs/google-bigqueryreservation1/5.0.3+20230117/google_bigqueryreservation1/api::ProjectLocationReservationAssignmentPatchCall), [*locations reservations create*](https://docs.rs/google-bigqueryreservation1/5.0.3+20230117/google_bigqueryreservation1/api::ProjectLocationReservationCreateCall), [*locations reservations delete*](https://docs.rs/google-bigqueryreservation1/5.0.3+20230117/google_bigqueryreservation1/api::ProjectLocationReservationDeleteCall), [*locations reservations get*](https://docs.rs/google-bigqueryreservation1/5.0.3+20230117/google_bigqueryreservation1/api::ProjectLocationReservationGetCall), [*locations reservations list*](https://docs.rs/google-bigqueryreservation1/5.0.3+20230117/google_bigqueryreservation1/api::ProjectLocationReservationListCall), [*locations reservations patch*](https://docs.rs/google-bigqueryreservation1/5.0.3+20230117/google_bigqueryreservation1/api::ProjectLocationReservationPatchCall), [*locations search all assignments*](https://docs.rs/google-bigqueryreservation1/5.0.3+20230117/google_bigqueryreservation1/api::ProjectLocationSearchAllAssignmentCall), [*locations search assignments*](https://docs.rs/google-bigqueryreservation1/5.0.3+20230117/google_bigqueryreservation1/api::ProjectLocationSearchAssignmentCall) and [*locations update bi reservation*](https://docs.rs/google-bigqueryreservation1/5.0.3+20230117/google_bigqueryreservation1/api::ProjectLocationUpdateBiReservationCall) @@ -53,8 +53,8 @@ let r = hub.projects().locations_capacity_commitments_merge(...).doit().await let r = hub.projects().locations_capacity_commitments_patch(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -82,12 +82,12 @@ use bigqueryreservation1::{Result, Error}; use std::default::Default; use bigqueryreservation1::{BigQueryReservation, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -130,10 +130,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-bigqueryreservation1/5.0.3+20230117/google_bigqueryreservation1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-bigqueryreservation1/5.0.3+20230117/google_bigqueryreservation1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -143,25 +143,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-bigque You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-bigqueryreservation1/5.0.3+20230117/google_bigqueryreservation1/client::Delegate) to the -[Method Builder](https://docs.rs/google-bigqueryreservation1/5.0.3+20230117/google_bigqueryreservation1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-bigqueryreservation1/5.0.3+20230117/google_bigqueryreservation1/client::Delegate) to the +[Method Builder](https://docs.rs/google-bigqueryreservation1/5.0.3+20230117/google_bigqueryreservation1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-bigqueryreservation1/5.0.3+20230117/google_bigqueryreservation1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-bigqueryreservation1/5.0.3+20230117/google_bigqueryreservation1/client::RequestValue) and -[decodable](https://docs.rs/google-bigqueryreservation1/5.0.3+20230117/google_bigqueryreservation1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-bigqueryreservation1/5.0.3+20230117/google_bigqueryreservation1/client::RequestValue) and +[decodable](https://docs.rs/google-bigqueryreservation1/5.0.3+20230117/google_bigqueryreservation1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-bigqueryreservation1/5.0.3+20230117/google_bigqueryreservation1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-bigqueryreservation1/5.0.3+20230117/google_bigqueryreservation1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -180,7 +180,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **bigqueryreservation1** library was generated by Sebastian Thiel, and is placed +The **bigqueryreservation1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/bigqueryreservation1/src/api.rs b/gen/bigqueryreservation1/src/api.rs index acbe508d07..0a7ac87d87 100644 --- a/gen/bigqueryreservation1/src/api.rs +++ b/gen/bigqueryreservation1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your data in Google BigQuery and see the email address for your Google Account Bigquery, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use bigqueryreservation1::{BigQueryReservation, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/bigqueryreservation1/src/lib.rs b/gen/bigqueryreservation1/src/lib.rs index c7f55f29f5..ca94f1454b 100644 --- a/gen/bigqueryreservation1/src/lib.rs +++ b/gen/bigqueryreservation1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/bigqueryreservation1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](BigQueryReservation) ... +//! Handle the following *Resources* with ease from the central [hub](BigQueryReservation) ... //! //! * projects //! * [*locations capacity commitments create*](api::ProjectLocationCapacityCommitmentCreateCall), [*locations capacity commitments delete*](api::ProjectLocationCapacityCommitmentDeleteCall), [*locations capacity commitments get*](api::ProjectLocationCapacityCommitmentGetCall), [*locations capacity commitments list*](api::ProjectLocationCapacityCommitmentListCall), [*locations capacity commitments merge*](api::ProjectLocationCapacityCommitmentMergeCall), [*locations capacity commitments patch*](api::ProjectLocationCapacityCommitmentPatchCall), [*locations capacity commitments split*](api::ProjectLocationCapacityCommitmentSplitCall), [*locations get bi reservation*](api::ProjectLocationGetBiReservationCall), [*locations reservations assignments create*](api::ProjectLocationReservationAssignmentCreateCall), [*locations reservations assignments delete*](api::ProjectLocationReservationAssignmentDeleteCall), [*locations reservations assignments list*](api::ProjectLocationReservationAssignmentListCall), [*locations reservations assignments move*](api::ProjectLocationReservationAssignmentMoveCall), [*locations reservations assignments patch*](api::ProjectLocationReservationAssignmentPatchCall), [*locations reservations create*](api::ProjectLocationReservationCreateCall), [*locations reservations delete*](api::ProjectLocationReservationDeleteCall), [*locations reservations get*](api::ProjectLocationReservationGetCall), [*locations reservations list*](api::ProjectLocationReservationListCall), [*locations reservations patch*](api::ProjectLocationReservationPatchCall), [*locations search all assignments*](api::ProjectLocationSearchAllAssignmentCall), [*locations search assignments*](api::ProjectLocationSearchAssignmentCall) and [*locations update bi reservation*](api::ProjectLocationUpdateBiReservationCall) @@ -53,8 +53,8 @@ //! let r = hub.projects().locations_capacity_commitments_patch(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -83,12 +83,12 @@ //! use std::default::Default; //! use bigqueryreservation1::{BigQueryReservation, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -131,10 +131,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -144,25 +144,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/bigtableadmin2/README.md b/gen/bigtableadmin2/README.md index 2fb7f7f8e2..9ba266e1b4 100644 --- a/gen/bigtableadmin2/README.md +++ b/gen/bigtableadmin2/README.md @@ -11,7 +11,7 @@ Everything else about the *Bigtable Admin* *v2* API can be found at the [official documentation site](https://cloud.google.com/bigtable/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-bigtableadmin2/5.0.3+20230110/google_bigtableadmin2/BigtableAdmin) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-bigtableadmin2/5.0.3+20230110/google_bigtableadmin2/BigtableAdmin) ... * [operations](https://docs.rs/google-bigtableadmin2/5.0.3+20230110/google_bigtableadmin2/api::Operation) * [*cancel*](https://docs.rs/google-bigtableadmin2/5.0.3+20230110/google_bigtableadmin2/api::OperationCancelCall), [*delete*](https://docs.rs/google-bigtableadmin2/5.0.3+20230110/google_bigtableadmin2/api::OperationDeleteCall), [*get*](https://docs.rs/google-bigtableadmin2/5.0.3+20230110/google_bigtableadmin2/api::OperationGetCall) and [*projects operations list*](https://docs.rs/google-bigtableadmin2/5.0.3+20230110/google_bigtableadmin2/api::OperationProjectOperationListCall) @@ -66,8 +66,8 @@ let r = hub.projects().instances_create(...).doit().await let r = hub.projects().instances_partial_update_instance(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -94,12 +94,12 @@ use bigtableadmin2::{Result, Error}; use std::default::Default; use bigtableadmin2::{BigtableAdmin, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -138,10 +138,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-bigtableadmin2/5.0.3+20230110/google_bigtableadmin2/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-bigtableadmin2/5.0.3+20230110/google_bigtableadmin2/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -151,25 +151,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-bigtab You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-bigtableadmin2/5.0.3+20230110/google_bigtableadmin2/client::Delegate) to the -[Method Builder](https://docs.rs/google-bigtableadmin2/5.0.3+20230110/google_bigtableadmin2/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-bigtableadmin2/5.0.3+20230110/google_bigtableadmin2/client::Delegate) to the +[Method Builder](https://docs.rs/google-bigtableadmin2/5.0.3+20230110/google_bigtableadmin2/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-bigtableadmin2/5.0.3+20230110/google_bigtableadmin2/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-bigtableadmin2/5.0.3+20230110/google_bigtableadmin2/client::RequestValue) and -[decodable](https://docs.rs/google-bigtableadmin2/5.0.3+20230110/google_bigtableadmin2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-bigtableadmin2/5.0.3+20230110/google_bigtableadmin2/client::RequestValue) and +[decodable](https://docs.rs/google-bigtableadmin2/5.0.3+20230110/google_bigtableadmin2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-bigtableadmin2/5.0.3+20230110/google_bigtableadmin2/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-bigtableadmin2/5.0.3+20230110/google_bigtableadmin2/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -188,7 +188,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **bigtableadmin2** library was generated by Sebastian Thiel, and is placed +The **bigtableadmin2** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/bigtableadmin2/src/api.rs b/gen/bigtableadmin2/src/api.rs index 7a32e55f22..665aba1240 100644 --- a/gen/bigtableadmin2/src/api.rs +++ b/gen/bigtableadmin2/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// Administer your Cloud Bigtable tables and clusters BigtableAdmin, @@ -96,12 +96,12 @@ impl Default for Scope { /// use std::default::Default; /// use bigtableadmin2::{BigtableAdmin, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/bigtableadmin2/src/lib.rs b/gen/bigtableadmin2/src/lib.rs index 9905bc6cb9..1e801fce0a 100644 --- a/gen/bigtableadmin2/src/lib.rs +++ b/gen/bigtableadmin2/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/bigtableadmin2). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](BigtableAdmin) ... +//! Handle the following *Resources* with ease from the central [hub](BigtableAdmin) ... //! //! * [operations](api::Operation) //! * [*cancel*](api::OperationCancelCall), [*delete*](api::OperationDeleteCall), [*get*](api::OperationGetCall) and [*projects operations list*](api::OperationProjectOperationListCall) @@ -66,8 +66,8 @@ //! let r = hub.projects().instances_partial_update_instance(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -95,12 +95,12 @@ //! use std::default::Default; //! use bigtableadmin2::{BigtableAdmin, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -139,10 +139,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -152,25 +152,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/billingbudgets1/README.md b/gen/billingbudgets1/README.md index 65a7242627..3494847a6f 100644 --- a/gen/billingbudgets1/README.md +++ b/gen/billingbudgets1/README.md @@ -11,7 +11,7 @@ Everything else about the *CloudBillingBudget* *v1* API can be found at the [official documentation site](https://cloud.google.com/billing/docs/how-to/budget-api-overview). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-billingbudgets1/5.0.3+20230117/google_billingbudgets1/CloudBillingBudget) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-billingbudgets1/5.0.3+20230117/google_billingbudgets1/CloudBillingBudget) ... * billing accounts * [*budgets create*](https://docs.rs/google-billingbudgets1/5.0.3+20230117/google_billingbudgets1/api::BillingAccountBudgetCreateCall), [*budgets delete*](https://docs.rs/google-billingbudgets1/5.0.3+20230117/google_billingbudgets1/api::BillingAccountBudgetDeleteCall), [*budgets get*](https://docs.rs/google-billingbudgets1/5.0.3+20230117/google_billingbudgets1/api::BillingAccountBudgetGetCall), [*budgets list*](https://docs.rs/google-billingbudgets1/5.0.3+20230117/google_billingbudgets1/api::BillingAccountBudgetListCall) and [*budgets patch*](https://docs.rs/google-billingbudgets1/5.0.3+20230117/google_billingbudgets1/api::BillingAccountBudgetPatchCall) @@ -52,8 +52,8 @@ let r = hub.billing_accounts().budgets_get(...).doit().await let r = hub.billing_accounts().budgets_patch(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -81,12 +81,12 @@ use billingbudgets1::{Result, Error}; use std::default::Default; use billingbudgets1::{CloudBillingBudget, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -128,10 +128,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-billingbudgets1/5.0.3+20230117/google_billingbudgets1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-billingbudgets1/5.0.3+20230117/google_billingbudgets1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -141,25 +141,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-billin You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-billingbudgets1/5.0.3+20230117/google_billingbudgets1/client::Delegate) to the -[Method Builder](https://docs.rs/google-billingbudgets1/5.0.3+20230117/google_billingbudgets1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-billingbudgets1/5.0.3+20230117/google_billingbudgets1/client::Delegate) to the +[Method Builder](https://docs.rs/google-billingbudgets1/5.0.3+20230117/google_billingbudgets1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-billingbudgets1/5.0.3+20230117/google_billingbudgets1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-billingbudgets1/5.0.3+20230117/google_billingbudgets1/client::RequestValue) and -[decodable](https://docs.rs/google-billingbudgets1/5.0.3+20230117/google_billingbudgets1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-billingbudgets1/5.0.3+20230117/google_billingbudgets1/client::RequestValue) and +[decodable](https://docs.rs/google-billingbudgets1/5.0.3+20230117/google_billingbudgets1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-billingbudgets1/5.0.3+20230117/google_billingbudgets1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-billingbudgets1/5.0.3+20230117/google_billingbudgets1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -178,7 +178,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **billingbudgets1** library was generated by Sebastian Thiel, and is placed +The **billingbudgets1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/billingbudgets1/src/api.rs b/gen/billingbudgets1/src/api.rs index 22ca98f365..6cbf87c64e 100644 --- a/gen/billingbudgets1/src/api.rs +++ b/gen/billingbudgets1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your Google Cloud Platform billing accounts CloudBilling, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use billingbudgets1::{CloudBillingBudget, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/billingbudgets1/src/lib.rs b/gen/billingbudgets1/src/lib.rs index e1757e1685..f46270421c 100644 --- a/gen/billingbudgets1/src/lib.rs +++ b/gen/billingbudgets1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/billingbudgets1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudBillingBudget) ... +//! Handle the following *Resources* with ease from the central [hub](CloudBillingBudget) ... //! //! * billing accounts //! * [*budgets create*](api::BillingAccountBudgetCreateCall), [*budgets delete*](api::BillingAccountBudgetDeleteCall), [*budgets get*](api::BillingAccountBudgetGetCall), [*budgets list*](api::BillingAccountBudgetListCall) and [*budgets patch*](api::BillingAccountBudgetPatchCall) @@ -52,8 +52,8 @@ //! let r = hub.billing_accounts().budgets_patch(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -82,12 +82,12 @@ //! use std::default::Default; //! use billingbudgets1::{CloudBillingBudget, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -129,10 +129,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -142,25 +142,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/billingbudgets1_beta1/README.md b/gen/billingbudgets1_beta1/README.md index 2fb5b3166a..73daf8b929 100644 --- a/gen/billingbudgets1_beta1/README.md +++ b/gen/billingbudgets1_beta1/README.md @@ -11,7 +11,7 @@ Everything else about the *CloudBillingBudget* *v1_beta1* API can be found at th [official documentation site](https://cloud.google.com/billing/docs/how-to/budget-api-overview). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-billingbudgets1_beta1/5.0.3+20230117/google_billingbudgets1_beta1/CloudBillingBudget) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-billingbudgets1_beta1/5.0.3+20230117/google_billingbudgets1_beta1/CloudBillingBudget) ... * billing accounts * [*budgets create*](https://docs.rs/google-billingbudgets1_beta1/5.0.3+20230117/google_billingbudgets1_beta1/api::BillingAccountBudgetCreateCall), [*budgets delete*](https://docs.rs/google-billingbudgets1_beta1/5.0.3+20230117/google_billingbudgets1_beta1/api::BillingAccountBudgetDeleteCall), [*budgets get*](https://docs.rs/google-billingbudgets1_beta1/5.0.3+20230117/google_billingbudgets1_beta1/api::BillingAccountBudgetGetCall), [*budgets list*](https://docs.rs/google-billingbudgets1_beta1/5.0.3+20230117/google_billingbudgets1_beta1/api::BillingAccountBudgetListCall) and [*budgets patch*](https://docs.rs/google-billingbudgets1_beta1/5.0.3+20230117/google_billingbudgets1_beta1/api::BillingAccountBudgetPatchCall) @@ -52,8 +52,8 @@ let r = hub.billing_accounts().budgets_get(...).doit().await let r = hub.billing_accounts().budgets_patch(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -81,12 +81,12 @@ use billingbudgets1_beta1::{Result, Error}; use std::default::Default; use billingbudgets1_beta1::{CloudBillingBudget, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -127,10 +127,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-billingbudgets1_beta1/5.0.3+20230117/google_billingbudgets1_beta1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-billingbudgets1_beta1/5.0.3+20230117/google_billingbudgets1_beta1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -140,25 +140,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-billin You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-billingbudgets1_beta1/5.0.3+20230117/google_billingbudgets1_beta1/client::Delegate) to the -[Method Builder](https://docs.rs/google-billingbudgets1_beta1/5.0.3+20230117/google_billingbudgets1_beta1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-billingbudgets1_beta1/5.0.3+20230117/google_billingbudgets1_beta1/client::Delegate) to the +[Method Builder](https://docs.rs/google-billingbudgets1_beta1/5.0.3+20230117/google_billingbudgets1_beta1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-billingbudgets1_beta1/5.0.3+20230117/google_billingbudgets1_beta1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-billingbudgets1_beta1/5.0.3+20230117/google_billingbudgets1_beta1/client::RequestValue) and -[decodable](https://docs.rs/google-billingbudgets1_beta1/5.0.3+20230117/google_billingbudgets1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-billingbudgets1_beta1/5.0.3+20230117/google_billingbudgets1_beta1/client::RequestValue) and +[decodable](https://docs.rs/google-billingbudgets1_beta1/5.0.3+20230117/google_billingbudgets1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-billingbudgets1_beta1/5.0.3+20230117/google_billingbudgets1_beta1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-billingbudgets1_beta1/5.0.3+20230117/google_billingbudgets1_beta1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -177,7 +177,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **billingbudgets1_beta1** library was generated by Sebastian Thiel, and is placed +The **billingbudgets1_beta1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/billingbudgets1_beta1/src/api.rs b/gen/billingbudgets1_beta1/src/api.rs index 028b187ca9..2f08440d62 100644 --- a/gen/billingbudgets1_beta1/src/api.rs +++ b/gen/billingbudgets1_beta1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your Google Cloud Platform billing accounts CloudBilling, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use billingbudgets1_beta1::{CloudBillingBudget, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/billingbudgets1_beta1/src/lib.rs b/gen/billingbudgets1_beta1/src/lib.rs index 4d1761977e..5a1fd4b967 100644 --- a/gen/billingbudgets1_beta1/src/lib.rs +++ b/gen/billingbudgets1_beta1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/billingbudgets1_beta1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudBillingBudget) ... +//! Handle the following *Resources* with ease from the central [hub](CloudBillingBudget) ... //! //! * billing accounts //! * [*budgets create*](api::BillingAccountBudgetCreateCall), [*budgets delete*](api::BillingAccountBudgetDeleteCall), [*budgets get*](api::BillingAccountBudgetGetCall), [*budgets list*](api::BillingAccountBudgetListCall) and [*budgets patch*](api::BillingAccountBudgetPatchCall) @@ -52,8 +52,8 @@ //! let r = hub.billing_accounts().budgets_patch(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -82,12 +82,12 @@ //! use std::default::Default; //! use billingbudgets1_beta1::{CloudBillingBudget, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -128,10 +128,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -141,25 +141,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/binaryauthorization1/README.md b/gen/binaryauthorization1/README.md index 7c81f160be..d354db12cf 100644 --- a/gen/binaryauthorization1/README.md +++ b/gen/binaryauthorization1/README.md @@ -11,7 +11,7 @@ Everything else about the *Binary Authorization* *v1* API can be found at the [official documentation site](https://cloud.google.com/binary-authorization/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-binaryauthorization1/5.0.3+20230113/google_binaryauthorization1/BinaryAuthorization) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-binaryauthorization1/5.0.3+20230113/google_binaryauthorization1/BinaryAuthorization) ... * projects * [*attestors create*](https://docs.rs/google-binaryauthorization1/5.0.3+20230113/google_binaryauthorization1/api::ProjectAttestorCreateCall), [*attestors delete*](https://docs.rs/google-binaryauthorization1/5.0.3+20230113/google_binaryauthorization1/api::ProjectAttestorDeleteCall), [*attestors get*](https://docs.rs/google-binaryauthorization1/5.0.3+20230113/google_binaryauthorization1/api::ProjectAttestorGetCall), [*attestors get iam policy*](https://docs.rs/google-binaryauthorization1/5.0.3+20230113/google_binaryauthorization1/api::ProjectAttestorGetIamPolicyCall), [*attestors list*](https://docs.rs/google-binaryauthorization1/5.0.3+20230113/google_binaryauthorization1/api::ProjectAttestorListCall), [*attestors set iam policy*](https://docs.rs/google-binaryauthorization1/5.0.3+20230113/google_binaryauthorization1/api::ProjectAttestorSetIamPolicyCall), [*attestors test iam permissions*](https://docs.rs/google-binaryauthorization1/5.0.3+20230113/google_binaryauthorization1/api::ProjectAttestorTestIamPermissionCall), [*attestors update*](https://docs.rs/google-binaryauthorization1/5.0.3+20230113/google_binaryauthorization1/api::ProjectAttestorUpdateCall), [*attestors validate attestation occurrence*](https://docs.rs/google-binaryauthorization1/5.0.3+20230113/google_binaryauthorization1/api::ProjectAttestorValidateAttestationOccurrenceCall), [*get policy*](https://docs.rs/google-binaryauthorization1/5.0.3+20230113/google_binaryauthorization1/api::ProjectGetPolicyCall), [*policy get iam policy*](https://docs.rs/google-binaryauthorization1/5.0.3+20230113/google_binaryauthorization1/api::ProjectPolicyGetIamPolicyCall), [*policy set iam policy*](https://docs.rs/google-binaryauthorization1/5.0.3+20230113/google_binaryauthorization1/api::ProjectPolicySetIamPolicyCall), [*policy test iam permissions*](https://docs.rs/google-binaryauthorization1/5.0.3+20230113/google_binaryauthorization1/api::ProjectPolicyTestIamPermissionCall) and [*update policy*](https://docs.rs/google-binaryauthorization1/5.0.3+20230113/google_binaryauthorization1/api::ProjectUpdatePolicyCall) @@ -55,8 +55,8 @@ let r = hub.projects().policy_get_iam_policy(...).doit().await let r = hub.projects().policy_set_iam_policy(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -83,12 +83,12 @@ use binaryauthorization1::{Result, Error}; use std::default::Default; use binaryauthorization1::{BinaryAuthorization, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -125,10 +125,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-binaryauthorization1/5.0.3+20230113/google_binaryauthorization1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-binaryauthorization1/5.0.3+20230113/google_binaryauthorization1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -138,25 +138,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-binary You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-binaryauthorization1/5.0.3+20230113/google_binaryauthorization1/client::Delegate) to the -[Method Builder](https://docs.rs/google-binaryauthorization1/5.0.3+20230113/google_binaryauthorization1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-binaryauthorization1/5.0.3+20230113/google_binaryauthorization1/client::Delegate) to the +[Method Builder](https://docs.rs/google-binaryauthorization1/5.0.3+20230113/google_binaryauthorization1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-binaryauthorization1/5.0.3+20230113/google_binaryauthorization1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-binaryauthorization1/5.0.3+20230113/google_binaryauthorization1/client::RequestValue) and -[decodable](https://docs.rs/google-binaryauthorization1/5.0.3+20230113/google_binaryauthorization1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-binaryauthorization1/5.0.3+20230113/google_binaryauthorization1/client::RequestValue) and +[decodable](https://docs.rs/google-binaryauthorization1/5.0.3+20230113/google_binaryauthorization1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-binaryauthorization1/5.0.3+20230113/google_binaryauthorization1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-binaryauthorization1/5.0.3+20230113/google_binaryauthorization1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -175,7 +175,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **binaryauthorization1** library was generated by Sebastian Thiel, and is placed +The **binaryauthorization1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/binaryauthorization1/src/api.rs b/gen/binaryauthorization1/src/api.rs index cfb91192fc..c87f71b669 100644 --- a/gen/binaryauthorization1/src/api.rs +++ b/gen/binaryauthorization1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use binaryauthorization1::{BinaryAuthorization, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/binaryauthorization1/src/lib.rs b/gen/binaryauthorization1/src/lib.rs index be346f4381..c082ab054a 100644 --- a/gen/binaryauthorization1/src/lib.rs +++ b/gen/binaryauthorization1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/binaryauthorization1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](BinaryAuthorization) ... +//! Handle the following *Resources* with ease from the central [hub](BinaryAuthorization) ... //! //! * projects //! * [*attestors create*](api::ProjectAttestorCreateCall), [*attestors delete*](api::ProjectAttestorDeleteCall), [*attestors get*](api::ProjectAttestorGetCall), [*attestors get iam policy*](api::ProjectAttestorGetIamPolicyCall), [*attestors list*](api::ProjectAttestorListCall), [*attestors set iam policy*](api::ProjectAttestorSetIamPolicyCall), [*attestors test iam permissions*](api::ProjectAttestorTestIamPermissionCall), [*attestors update*](api::ProjectAttestorUpdateCall), [*attestors validate attestation occurrence*](api::ProjectAttestorValidateAttestationOccurrenceCall), [*get policy*](api::ProjectGetPolicyCall), [*policy get iam policy*](api::ProjectPolicyGetIamPolicyCall), [*policy set iam policy*](api::ProjectPolicySetIamPolicyCall), [*policy test iam permissions*](api::ProjectPolicyTestIamPermissionCall) and [*update policy*](api::ProjectUpdatePolicyCall) @@ -55,8 +55,8 @@ //! let r = hub.projects().policy_set_iam_policy(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -84,12 +84,12 @@ //! use std::default::Default; //! use binaryauthorization1::{BinaryAuthorization, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -126,10 +126,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -139,25 +139,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/binaryauthorization1_beta1/README.md b/gen/binaryauthorization1_beta1/README.md index 5428a5a626..7dd5f16dba 100644 --- a/gen/binaryauthorization1_beta1/README.md +++ b/gen/binaryauthorization1_beta1/README.md @@ -11,7 +11,7 @@ Everything else about the *Binary Authorization* *v1_beta1* API can be found at [official documentation site](https://cloud.google.com/binary-authorization/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-binaryauthorization1_beta1/5.0.3+20230113/google_binaryauthorization1_beta1/BinaryAuthorization) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-binaryauthorization1_beta1/5.0.3+20230113/google_binaryauthorization1_beta1/BinaryAuthorization) ... * projects * [*attestors create*](https://docs.rs/google-binaryauthorization1_beta1/5.0.3+20230113/google_binaryauthorization1_beta1/api::ProjectAttestorCreateCall), [*attestors delete*](https://docs.rs/google-binaryauthorization1_beta1/5.0.3+20230113/google_binaryauthorization1_beta1/api::ProjectAttestorDeleteCall), [*attestors get*](https://docs.rs/google-binaryauthorization1_beta1/5.0.3+20230113/google_binaryauthorization1_beta1/api::ProjectAttestorGetCall), [*attestors get iam policy*](https://docs.rs/google-binaryauthorization1_beta1/5.0.3+20230113/google_binaryauthorization1_beta1/api::ProjectAttestorGetIamPolicyCall), [*attestors list*](https://docs.rs/google-binaryauthorization1_beta1/5.0.3+20230113/google_binaryauthorization1_beta1/api::ProjectAttestorListCall), [*attestors set iam policy*](https://docs.rs/google-binaryauthorization1_beta1/5.0.3+20230113/google_binaryauthorization1_beta1/api::ProjectAttestorSetIamPolicyCall), [*attestors test iam permissions*](https://docs.rs/google-binaryauthorization1_beta1/5.0.3+20230113/google_binaryauthorization1_beta1/api::ProjectAttestorTestIamPermissionCall), [*attestors update*](https://docs.rs/google-binaryauthorization1_beta1/5.0.3+20230113/google_binaryauthorization1_beta1/api::ProjectAttestorUpdateCall), [*attestors validate attestation occurrence*](https://docs.rs/google-binaryauthorization1_beta1/5.0.3+20230113/google_binaryauthorization1_beta1/api::ProjectAttestorValidateAttestationOccurrenceCall), [*get policy*](https://docs.rs/google-binaryauthorization1_beta1/5.0.3+20230113/google_binaryauthorization1_beta1/api::ProjectGetPolicyCall), [*policy get iam policy*](https://docs.rs/google-binaryauthorization1_beta1/5.0.3+20230113/google_binaryauthorization1_beta1/api::ProjectPolicyGetIamPolicyCall), [*policy set iam policy*](https://docs.rs/google-binaryauthorization1_beta1/5.0.3+20230113/google_binaryauthorization1_beta1/api::ProjectPolicySetIamPolicyCall), [*policy test iam permissions*](https://docs.rs/google-binaryauthorization1_beta1/5.0.3+20230113/google_binaryauthorization1_beta1/api::ProjectPolicyTestIamPermissionCall) and [*update policy*](https://docs.rs/google-binaryauthorization1_beta1/5.0.3+20230113/google_binaryauthorization1_beta1/api::ProjectUpdatePolicyCall) @@ -55,8 +55,8 @@ let r = hub.projects().policy_get_iam_policy(...).doit().await let r = hub.projects().policy_set_iam_policy(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -83,12 +83,12 @@ use binaryauthorization1_beta1::{Result, Error}; use std::default::Default; use binaryauthorization1_beta1::{BinaryAuthorization, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -125,10 +125,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-binaryauthorization1_beta1/5.0.3+20230113/google_binaryauthorization1_beta1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-binaryauthorization1_beta1/5.0.3+20230113/google_binaryauthorization1_beta1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -138,25 +138,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-binary You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-binaryauthorization1_beta1/5.0.3+20230113/google_binaryauthorization1_beta1/client::Delegate) to the -[Method Builder](https://docs.rs/google-binaryauthorization1_beta1/5.0.3+20230113/google_binaryauthorization1_beta1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-binaryauthorization1_beta1/5.0.3+20230113/google_binaryauthorization1_beta1/client::Delegate) to the +[Method Builder](https://docs.rs/google-binaryauthorization1_beta1/5.0.3+20230113/google_binaryauthorization1_beta1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-binaryauthorization1_beta1/5.0.3+20230113/google_binaryauthorization1_beta1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-binaryauthorization1_beta1/5.0.3+20230113/google_binaryauthorization1_beta1/client::RequestValue) and -[decodable](https://docs.rs/google-binaryauthorization1_beta1/5.0.3+20230113/google_binaryauthorization1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-binaryauthorization1_beta1/5.0.3+20230113/google_binaryauthorization1_beta1/client::RequestValue) and +[decodable](https://docs.rs/google-binaryauthorization1_beta1/5.0.3+20230113/google_binaryauthorization1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-binaryauthorization1_beta1/5.0.3+20230113/google_binaryauthorization1_beta1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-binaryauthorization1_beta1/5.0.3+20230113/google_binaryauthorization1_beta1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -175,7 +175,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **binaryauthorization1_beta1** library was generated by Sebastian Thiel, and is placed +The **binaryauthorization1_beta1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/binaryauthorization1_beta1/src/api.rs b/gen/binaryauthorization1_beta1/src/api.rs index 33a7c4017a..1cae5b8780 100644 --- a/gen/binaryauthorization1_beta1/src/api.rs +++ b/gen/binaryauthorization1_beta1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use binaryauthorization1_beta1::{BinaryAuthorization, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/binaryauthorization1_beta1/src/lib.rs b/gen/binaryauthorization1_beta1/src/lib.rs index 6bd75533c2..844504ff2e 100644 --- a/gen/binaryauthorization1_beta1/src/lib.rs +++ b/gen/binaryauthorization1_beta1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/binaryauthorization1_beta1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](BinaryAuthorization) ... +//! Handle the following *Resources* with ease from the central [hub](BinaryAuthorization) ... //! //! * projects //! * [*attestors create*](api::ProjectAttestorCreateCall), [*attestors delete*](api::ProjectAttestorDeleteCall), [*attestors get*](api::ProjectAttestorGetCall), [*attestors get iam policy*](api::ProjectAttestorGetIamPolicyCall), [*attestors list*](api::ProjectAttestorListCall), [*attestors set iam policy*](api::ProjectAttestorSetIamPolicyCall), [*attestors test iam permissions*](api::ProjectAttestorTestIamPermissionCall), [*attestors update*](api::ProjectAttestorUpdateCall), [*attestors validate attestation occurrence*](api::ProjectAttestorValidateAttestationOccurrenceCall), [*get policy*](api::ProjectGetPolicyCall), [*policy get iam policy*](api::ProjectPolicyGetIamPolicyCall), [*policy set iam policy*](api::ProjectPolicySetIamPolicyCall), [*policy test iam permissions*](api::ProjectPolicyTestIamPermissionCall) and [*update policy*](api::ProjectUpdatePolicyCall) @@ -55,8 +55,8 @@ //! let r = hub.projects().policy_set_iam_policy(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -84,12 +84,12 @@ //! use std::default::Default; //! use binaryauthorization1_beta1::{BinaryAuthorization, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -126,10 +126,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -139,25 +139,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/blogger3/README.md b/gen/blogger3/README.md index 042005974e..36cfbb3e54 100644 --- a/gen/blogger3/README.md +++ b/gen/blogger3/README.md @@ -11,7 +11,7 @@ Everything else about the *Blogger* *v3* API can be found at the [official documentation site](https://developers.google.com/blogger/docs/3.0/getting_started). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-blogger3/5.0.3+20230124/google_blogger3/Blogger) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-blogger3/5.0.3+20230124/google_blogger3/Blogger) ... * [blog user infos](https://docs.rs/google-blogger3/5.0.3+20230124/google_blogger3/api::BlogUserInfo) * [*get*](https://docs.rs/google-blogger3/5.0.3+20230124/google_blogger3/api::BlogUserInfoGetCall) @@ -73,8 +73,8 @@ let r = hub.posts().search(...).doit().await let r = hub.posts().update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -101,12 +101,12 @@ use blogger3::{Result, Error}; use std::default::Default; use blogger3::{Blogger, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -153,10 +153,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-blogger3/5.0.3+20230124/google_blogger3/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-blogger3/5.0.3+20230124/google_blogger3/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -166,25 +166,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-blogge You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-blogger3/5.0.3+20230124/google_blogger3/client::Delegate) to the -[Method Builder](https://docs.rs/google-blogger3/5.0.3+20230124/google_blogger3/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-blogger3/5.0.3+20230124/google_blogger3/client::Delegate) to the +[Method Builder](https://docs.rs/google-blogger3/5.0.3+20230124/google_blogger3/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-blogger3/5.0.3+20230124/google_blogger3/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-blogger3/5.0.3+20230124/google_blogger3/client::RequestValue) and -[decodable](https://docs.rs/google-blogger3/5.0.3+20230124/google_blogger3/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-blogger3/5.0.3+20230124/google_blogger3/client::RequestValue) and +[decodable](https://docs.rs/google-blogger3/5.0.3+20230124/google_blogger3/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-blogger3/5.0.3+20230124/google_blogger3/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-blogger3/5.0.3+20230124/google_blogger3/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -203,7 +203,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **blogger3** library was generated by Sebastian Thiel, and is placed +The **blogger3** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/blogger3/src/api.rs b/gen/blogger3/src/api.rs index bc3d1ec90f..5ef574584a 100644 --- a/gen/blogger3/src/api.rs +++ b/gen/blogger3/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// Manage your Blogger account Full, @@ -68,12 +68,12 @@ impl Default for Scope { /// use std::default::Default; /// use blogger3::{Blogger, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/blogger3/src/lib.rs b/gen/blogger3/src/lib.rs index 058f7d8832..0f4d37bbad 100644 --- a/gen/blogger3/src/lib.rs +++ b/gen/blogger3/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/blogger3). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Blogger) ... +//! Handle the following *Resources* with ease from the central [hub](Blogger) ... //! //! * [blog user infos](api::BlogUserInfo) //! * [*get*](api::BlogUserInfoGetCall) @@ -73,8 +73,8 @@ //! let r = hub.posts().update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -102,12 +102,12 @@ //! use std::default::Default; //! use blogger3::{Blogger, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -154,10 +154,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -167,25 +167,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/books1/README.md b/gen/books1/README.md index 7d0134c6e0..abfa8c1100 100644 --- a/gen/books1/README.md +++ b/gen/books1/README.md @@ -11,7 +11,7 @@ Everything else about the *books* *v1* API can be found at the [official documentation site](https://code.google.com/apis/books/docs/v1/getting_started.html). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-books1/5.0.3+20230117/google_books1/Books) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-books1/5.0.3+20230117/google_books1/Books) ... * [bookshelves](https://docs.rs/google-books1/5.0.3+20230117/google_books1/api::Bookshelf) * [*get*](https://docs.rs/google-books1/5.0.3+20230117/google_books1/api::BookshelfGetCall), [*list*](https://docs.rs/google-books1/5.0.3+20230117/google_books1/api::BookshelfListCall) and [*volumes list*](https://docs.rs/google-books1/5.0.3+20230117/google_books1/api::BookshelfVolumeListCall) @@ -84,8 +84,8 @@ let r = hub.promooffer().accept(...).doit().await let r = hub.promooffer().dismiss(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -112,12 +112,12 @@ use books1::{Result, Error}; use std::default::Default; use books1::{Books, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -161,10 +161,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-books1/5.0.3+20230117/google_books1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-books1/5.0.3+20230117/google_books1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -174,25 +174,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-books1 You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-books1/5.0.3+20230117/google_books1/client::Delegate) to the -[Method Builder](https://docs.rs/google-books1/5.0.3+20230117/google_books1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-books1/5.0.3+20230117/google_books1/client::Delegate) to the +[Method Builder](https://docs.rs/google-books1/5.0.3+20230117/google_books1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-books1/5.0.3+20230117/google_books1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-books1/5.0.3+20230117/google_books1/client::RequestValue) and -[decodable](https://docs.rs/google-books1/5.0.3+20230117/google_books1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-books1/5.0.3+20230117/google_books1/client::RequestValue) and +[decodable](https://docs.rs/google-books1/5.0.3+20230117/google_books1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-books1/5.0.3+20230117/google_books1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-books1/5.0.3+20230117/google_books1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -211,7 +211,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **books1** library was generated by Sebastian Thiel, and is placed +The **books1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/books1/src/api.rs b/gen/books1/src/api.rs index c439caa807..f82955ed9c 100644 --- a/gen/books1/src/api.rs +++ b/gen/books1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// Manage your books Full, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use books1::{Books, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/books1/src/lib.rs b/gen/books1/src/lib.rs index e214a4ae10..f8f4ea9a80 100644 --- a/gen/books1/src/lib.rs +++ b/gen/books1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/books1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Books) ... +//! Handle the following *Resources* with ease from the central [hub](Books) ... //! //! * [bookshelves](api::Bookshelf) //! * [*get*](api::BookshelfGetCall), [*list*](api::BookshelfListCall) and [*volumes list*](api::BookshelfVolumeListCall) @@ -84,8 +84,8 @@ //! let r = hub.promooffer().dismiss(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -113,12 +113,12 @@ //! use std::default::Default; //! use books1::{Books, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -162,10 +162,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -175,25 +175,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/calendar3/README.md b/gen/calendar3/README.md index a29f2b3de1..9384d92b87 100644 --- a/gen/calendar3/README.md +++ b/gen/calendar3/README.md @@ -11,7 +11,7 @@ Everything else about the *calendar* *v3* API can be found at the [official documentation site](https://developers.google.com/google-apps/calendar/firstapp). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-calendar3/5.0.3+20221229/google_calendar3/CalendarHub) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-calendar3/5.0.3+20221229/google_calendar3/CalendarHub) ... * [acl](https://docs.rs/google-calendar3/5.0.3+20221229/google_calendar3/api::Acl) * [*delete*](https://docs.rs/google-calendar3/5.0.3+20221229/google_calendar3/api::AclDeleteCall), [*get*](https://docs.rs/google-calendar3/5.0.3+20221229/google_calendar3/api::AclGetCall), [*insert*](https://docs.rs/google-calendar3/5.0.3+20221229/google_calendar3/api::AclInsertCall), [*list*](https://docs.rs/google-calendar3/5.0.3+20221229/google_calendar3/api::AclListCall), [*patch*](https://docs.rs/google-calendar3/5.0.3+20221229/google_calendar3/api::AclPatchCall), [*update*](https://docs.rs/google-calendar3/5.0.3+20221229/google_calendar3/api::AclUpdateCall) and [*watch*](https://docs.rs/google-calendar3/5.0.3+20221229/google_calendar3/api::AclWatchCall) @@ -86,8 +86,8 @@ let r = hub.events().update(...).doit().await let r = hub.events().watch(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -115,12 +115,12 @@ use calendar3::{Result, Error}; use std::default::Default; use calendar3::{CalendarHub, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -178,10 +178,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-calendar3/5.0.3+20221229/google_calendar3/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-calendar3/5.0.3+20221229/google_calendar3/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -191,25 +191,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-calend You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-calendar3/5.0.3+20221229/google_calendar3/client::Delegate) to the -[Method Builder](https://docs.rs/google-calendar3/5.0.3+20221229/google_calendar3/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-calendar3/5.0.3+20221229/google_calendar3/client::Delegate) to the +[Method Builder](https://docs.rs/google-calendar3/5.0.3+20221229/google_calendar3/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-calendar3/5.0.3+20221229/google_calendar3/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-calendar3/5.0.3+20221229/google_calendar3/client::RequestValue) and -[decodable](https://docs.rs/google-calendar3/5.0.3+20221229/google_calendar3/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-calendar3/5.0.3+20221229/google_calendar3/client::RequestValue) and +[decodable](https://docs.rs/google-calendar3/5.0.3+20221229/google_calendar3/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-calendar3/5.0.3+20221229/google_calendar3/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-calendar3/5.0.3+20221229/google_calendar3/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -228,7 +228,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **calendar3** library was generated by Sebastian Thiel, and is placed +The **calendar3** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/calendar3/src/api.rs b/gen/calendar3/src/api.rs index aa0afb10fd..5bfae0b22e 100644 --- a/gen/calendar3/src/api.rs +++ b/gen/calendar3/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, share, and permanently delete all the calendars you can access using Google Calendar Full, @@ -81,12 +81,12 @@ impl Default for Scope { /// use std::default::Default; /// use calendar3::{CalendarHub, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/calendar3/src/lib.rs b/gen/calendar3/src/lib.rs index e51289a3b0..acfcbc0907 100644 --- a/gen/calendar3/src/lib.rs +++ b/gen/calendar3/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/calendar3). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CalendarHub) ... +//! Handle the following *Resources* with ease from the central [hub](CalendarHub) ... //! //! * [acl](api::Acl) //! * [*delete*](api::AclDeleteCall), [*get*](api::AclGetCall), [*insert*](api::AclInsertCall), [*list*](api::AclListCall), [*patch*](api::AclPatchCall), [*update*](api::AclUpdateCall) and [*watch*](api::AclWatchCall) @@ -86,8 +86,8 @@ //! let r = hub.events().watch(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -116,12 +116,12 @@ //! use std::default::Default; //! use calendar3::{CalendarHub, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -179,10 +179,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -192,25 +192,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/certificatemanager1/README.md b/gen/certificatemanager1/README.md index 690eaf10d8..19d618459a 100644 --- a/gen/certificatemanager1/README.md +++ b/gen/certificatemanager1/README.md @@ -11,7 +11,7 @@ Everything else about the *Certificate Manager* *v1* API can be found at the [official documentation site](https://cloud.google.com/certificate-manager). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-certificatemanager1/5.0.3+20230104/google_certificatemanager1/CertificateManager) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-certificatemanager1/5.0.3+20230104/google_certificatemanager1/CertificateManager) ... * projects * [*locations certificate issuance configs create*](https://docs.rs/google-certificatemanager1/5.0.3+20230104/google_certificatemanager1/api::ProjectLocationCertificateIssuanceConfigCreateCall), [*locations certificate issuance configs delete*](https://docs.rs/google-certificatemanager1/5.0.3+20230104/google_certificatemanager1/api::ProjectLocationCertificateIssuanceConfigDeleteCall), [*locations certificate issuance configs get*](https://docs.rs/google-certificatemanager1/5.0.3+20230104/google_certificatemanager1/api::ProjectLocationCertificateIssuanceConfigGetCall), [*locations certificate issuance configs list*](https://docs.rs/google-certificatemanager1/5.0.3+20230104/google_certificatemanager1/api::ProjectLocationCertificateIssuanceConfigListCall), [*locations certificate maps certificate map entries create*](https://docs.rs/google-certificatemanager1/5.0.3+20230104/google_certificatemanager1/api::ProjectLocationCertificateMapCertificateMapEntryCreateCall), [*locations certificate maps certificate map entries delete*](https://docs.rs/google-certificatemanager1/5.0.3+20230104/google_certificatemanager1/api::ProjectLocationCertificateMapCertificateMapEntryDeleteCall), [*locations certificate maps certificate map entries get*](https://docs.rs/google-certificatemanager1/5.0.3+20230104/google_certificatemanager1/api::ProjectLocationCertificateMapCertificateMapEntryGetCall), [*locations certificate maps certificate map entries list*](https://docs.rs/google-certificatemanager1/5.0.3+20230104/google_certificatemanager1/api::ProjectLocationCertificateMapCertificateMapEntryListCall), [*locations certificate maps certificate map entries patch*](https://docs.rs/google-certificatemanager1/5.0.3+20230104/google_certificatemanager1/api::ProjectLocationCertificateMapCertificateMapEntryPatchCall), [*locations certificate maps create*](https://docs.rs/google-certificatemanager1/5.0.3+20230104/google_certificatemanager1/api::ProjectLocationCertificateMapCreateCall), [*locations certificate maps delete*](https://docs.rs/google-certificatemanager1/5.0.3+20230104/google_certificatemanager1/api::ProjectLocationCertificateMapDeleteCall), [*locations certificate maps get*](https://docs.rs/google-certificatemanager1/5.0.3+20230104/google_certificatemanager1/api::ProjectLocationCertificateMapGetCall), [*locations certificate maps list*](https://docs.rs/google-certificatemanager1/5.0.3+20230104/google_certificatemanager1/api::ProjectLocationCertificateMapListCall), [*locations certificate maps patch*](https://docs.rs/google-certificatemanager1/5.0.3+20230104/google_certificatemanager1/api::ProjectLocationCertificateMapPatchCall), [*locations certificates create*](https://docs.rs/google-certificatemanager1/5.0.3+20230104/google_certificatemanager1/api::ProjectLocationCertificateCreateCall), [*locations certificates delete*](https://docs.rs/google-certificatemanager1/5.0.3+20230104/google_certificatemanager1/api::ProjectLocationCertificateDeleteCall), [*locations certificates get*](https://docs.rs/google-certificatemanager1/5.0.3+20230104/google_certificatemanager1/api::ProjectLocationCertificateGetCall), [*locations certificates list*](https://docs.rs/google-certificatemanager1/5.0.3+20230104/google_certificatemanager1/api::ProjectLocationCertificateListCall), [*locations certificates patch*](https://docs.rs/google-certificatemanager1/5.0.3+20230104/google_certificatemanager1/api::ProjectLocationCertificatePatchCall), [*locations dns authorizations create*](https://docs.rs/google-certificatemanager1/5.0.3+20230104/google_certificatemanager1/api::ProjectLocationDnsAuthorizationCreateCall), [*locations dns authorizations delete*](https://docs.rs/google-certificatemanager1/5.0.3+20230104/google_certificatemanager1/api::ProjectLocationDnsAuthorizationDeleteCall), [*locations dns authorizations get*](https://docs.rs/google-certificatemanager1/5.0.3+20230104/google_certificatemanager1/api::ProjectLocationDnsAuthorizationGetCall), [*locations dns authorizations list*](https://docs.rs/google-certificatemanager1/5.0.3+20230104/google_certificatemanager1/api::ProjectLocationDnsAuthorizationListCall), [*locations dns authorizations patch*](https://docs.rs/google-certificatemanager1/5.0.3+20230104/google_certificatemanager1/api::ProjectLocationDnsAuthorizationPatchCall), [*locations get*](https://docs.rs/google-certificatemanager1/5.0.3+20230104/google_certificatemanager1/api::ProjectLocationGetCall), [*locations list*](https://docs.rs/google-certificatemanager1/5.0.3+20230104/google_certificatemanager1/api::ProjectLocationListCall), [*locations operations cancel*](https://docs.rs/google-certificatemanager1/5.0.3+20230104/google_certificatemanager1/api::ProjectLocationOperationCancelCall), [*locations operations delete*](https://docs.rs/google-certificatemanager1/5.0.3+20230104/google_certificatemanager1/api::ProjectLocationOperationDeleteCall), [*locations operations get*](https://docs.rs/google-certificatemanager1/5.0.3+20230104/google_certificatemanager1/api::ProjectLocationOperationGetCall) and [*locations operations list*](https://docs.rs/google-certificatemanager1/5.0.3+20230104/google_certificatemanager1/api::ProjectLocationOperationListCall) @@ -64,8 +64,8 @@ let r = hub.projects().locations_dns_authorizations_patch(...).doit().await let r = hub.projects().locations_operations_get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -93,12 +93,12 @@ use certificatemanager1::{Result, Error}; use std::default::Default; use certificatemanager1::{CertificateManager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -140,10 +140,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-certificatemanager1/5.0.3+20230104/google_certificatemanager1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-certificatemanager1/5.0.3+20230104/google_certificatemanager1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -153,25 +153,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-certif You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-certificatemanager1/5.0.3+20230104/google_certificatemanager1/client::Delegate) to the -[Method Builder](https://docs.rs/google-certificatemanager1/5.0.3+20230104/google_certificatemanager1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-certificatemanager1/5.0.3+20230104/google_certificatemanager1/client::Delegate) to the +[Method Builder](https://docs.rs/google-certificatemanager1/5.0.3+20230104/google_certificatemanager1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-certificatemanager1/5.0.3+20230104/google_certificatemanager1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-certificatemanager1/5.0.3+20230104/google_certificatemanager1/client::RequestValue) and -[decodable](https://docs.rs/google-certificatemanager1/5.0.3+20230104/google_certificatemanager1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-certificatemanager1/5.0.3+20230104/google_certificatemanager1/client::RequestValue) and +[decodable](https://docs.rs/google-certificatemanager1/5.0.3+20230104/google_certificatemanager1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-certificatemanager1/5.0.3+20230104/google_certificatemanager1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-certificatemanager1/5.0.3+20230104/google_certificatemanager1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -190,7 +190,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **certificatemanager1** library was generated by Sebastian Thiel, and is placed +The **certificatemanager1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/certificatemanager1/src/api.rs b/gen/certificatemanager1/src/api.rs index ff3dfad8e4..2f5b4c1c0c 100644 --- a/gen/certificatemanager1/src/api.rs +++ b/gen/certificatemanager1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use certificatemanager1::{CertificateManager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/certificatemanager1/src/lib.rs b/gen/certificatemanager1/src/lib.rs index ba03c7203d..94881a61d6 100644 --- a/gen/certificatemanager1/src/lib.rs +++ b/gen/certificatemanager1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/certificatemanager1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CertificateManager) ... +//! Handle the following *Resources* with ease from the central [hub](CertificateManager) ... //! //! * projects //! * [*locations certificate issuance configs create*](api::ProjectLocationCertificateIssuanceConfigCreateCall), [*locations certificate issuance configs delete*](api::ProjectLocationCertificateIssuanceConfigDeleteCall), [*locations certificate issuance configs get*](api::ProjectLocationCertificateIssuanceConfigGetCall), [*locations certificate issuance configs list*](api::ProjectLocationCertificateIssuanceConfigListCall), [*locations certificate maps certificate map entries create*](api::ProjectLocationCertificateMapCertificateMapEntryCreateCall), [*locations certificate maps certificate map entries delete*](api::ProjectLocationCertificateMapCertificateMapEntryDeleteCall), [*locations certificate maps certificate map entries get*](api::ProjectLocationCertificateMapCertificateMapEntryGetCall), [*locations certificate maps certificate map entries list*](api::ProjectLocationCertificateMapCertificateMapEntryListCall), [*locations certificate maps certificate map entries patch*](api::ProjectLocationCertificateMapCertificateMapEntryPatchCall), [*locations certificate maps create*](api::ProjectLocationCertificateMapCreateCall), [*locations certificate maps delete*](api::ProjectLocationCertificateMapDeleteCall), [*locations certificate maps get*](api::ProjectLocationCertificateMapGetCall), [*locations certificate maps list*](api::ProjectLocationCertificateMapListCall), [*locations certificate maps patch*](api::ProjectLocationCertificateMapPatchCall), [*locations certificates create*](api::ProjectLocationCertificateCreateCall), [*locations certificates delete*](api::ProjectLocationCertificateDeleteCall), [*locations certificates get*](api::ProjectLocationCertificateGetCall), [*locations certificates list*](api::ProjectLocationCertificateListCall), [*locations certificates patch*](api::ProjectLocationCertificatePatchCall), [*locations dns authorizations create*](api::ProjectLocationDnsAuthorizationCreateCall), [*locations dns authorizations delete*](api::ProjectLocationDnsAuthorizationDeleteCall), [*locations dns authorizations get*](api::ProjectLocationDnsAuthorizationGetCall), [*locations dns authorizations list*](api::ProjectLocationDnsAuthorizationListCall), [*locations dns authorizations patch*](api::ProjectLocationDnsAuthorizationPatchCall), [*locations get*](api::ProjectLocationGetCall), [*locations list*](api::ProjectLocationListCall), [*locations operations cancel*](api::ProjectLocationOperationCancelCall), [*locations operations delete*](api::ProjectLocationOperationDeleteCall), [*locations operations get*](api::ProjectLocationOperationGetCall) and [*locations operations list*](api::ProjectLocationOperationListCall) @@ -64,8 +64,8 @@ //! let r = hub.projects().locations_operations_get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -94,12 +94,12 @@ //! use std::default::Default; //! use certificatemanager1::{CertificateManager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -141,10 +141,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -154,25 +154,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/chromemanagement1/README.md b/gen/chromemanagement1/README.md index 5a629961b4..674645d039 100644 --- a/gen/chromemanagement1/README.md +++ b/gen/chromemanagement1/README.md @@ -11,7 +11,7 @@ Everything else about the *Chrome Management* *v1* API can be found at the [official documentation site](http://developers.google.com/chrome/management/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-chromemanagement1/5.0.3+20230123/google_chromemanagement1/ChromeManagement) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-chromemanagement1/5.0.3+20230123/google_chromemanagement1/ChromeManagement) ... * customers * [*apps android get*](https://docs.rs/google-chromemanagement1/5.0.3+20230123/google_chromemanagement1/api::CustomerAppAndroidGetCall), [*apps chrome get*](https://docs.rs/google-chromemanagement1/5.0.3+20230123/google_chromemanagement1/api::CustomerAppChromeGetCall), [*apps count chrome app requests*](https://docs.rs/google-chromemanagement1/5.0.3+20230123/google_chromemanagement1/api::CustomerAppCountChromeAppRequestCall), [*apps web get*](https://docs.rs/google-chromemanagement1/5.0.3+20230123/google_chromemanagement1/api::CustomerAppWebGetCall), [*reports count chrome devices reaching auto expiration date*](https://docs.rs/google-chromemanagement1/5.0.3+20230123/google_chromemanagement1/api::CustomerReportCountChromeDevicesReachingAutoExpirationDateCall), [*reports count chrome devices that need attention*](https://docs.rs/google-chromemanagement1/5.0.3+20230123/google_chromemanagement1/api::CustomerReportCountChromeDevicesThatNeedAttentionCall), [*reports count chrome hardware fleet devices*](https://docs.rs/google-chromemanagement1/5.0.3+20230123/google_chromemanagement1/api::CustomerReportCountChromeHardwareFleetDeviceCall), [*reports count chrome versions*](https://docs.rs/google-chromemanagement1/5.0.3+20230123/google_chromemanagement1/api::CustomerReportCountChromeVersionCall), [*reports count installed apps*](https://docs.rs/google-chromemanagement1/5.0.3+20230123/google_chromemanagement1/api::CustomerReportCountInstalledAppCall), [*reports find installed app devices*](https://docs.rs/google-chromemanagement1/5.0.3+20230123/google_chromemanagement1/api::CustomerReportFindInstalledAppDeviceCall), [*telemetry devices get*](https://docs.rs/google-chromemanagement1/5.0.3+20230123/google_chromemanagement1/api::CustomerTelemetryDeviceGetCall), [*telemetry devices list*](https://docs.rs/google-chromemanagement1/5.0.3+20230123/google_chromemanagement1/api::CustomerTelemetryDeviceListCall) and [*telemetry events list*](https://docs.rs/google-chromemanagement1/5.0.3+20230123/google_chromemanagement1/api::CustomerTelemetryEventListCall) @@ -52,8 +52,8 @@ let r = hub.customers().apps_chrome_get(...).doit().await let r = hub.customers().apps_web_get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -80,12 +80,12 @@ use chromemanagement1::{Result, Error}; use std::default::Default; use chromemanagement1::{ChromeManagement, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -121,10 +121,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-chromemanagement1/5.0.3+20230123/google_chromemanagement1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-chromemanagement1/5.0.3+20230123/google_chromemanagement1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -134,25 +134,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-chrome You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-chromemanagement1/5.0.3+20230123/google_chromemanagement1/client::Delegate) to the -[Method Builder](https://docs.rs/google-chromemanagement1/5.0.3+20230123/google_chromemanagement1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-chromemanagement1/5.0.3+20230123/google_chromemanagement1/client::Delegate) to the +[Method Builder](https://docs.rs/google-chromemanagement1/5.0.3+20230123/google_chromemanagement1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-chromemanagement1/5.0.3+20230123/google_chromemanagement1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-chromemanagement1/5.0.3+20230123/google_chromemanagement1/client::RequestValue) and -[decodable](https://docs.rs/google-chromemanagement1/5.0.3+20230123/google_chromemanagement1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-chromemanagement1/5.0.3+20230123/google_chromemanagement1/client::RequestValue) and +[decodable](https://docs.rs/google-chromemanagement1/5.0.3+20230123/google_chromemanagement1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-chromemanagement1/5.0.3+20230123/google_chromemanagement1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-chromemanagement1/5.0.3+20230123/google_chromemanagement1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -171,7 +171,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **chromemanagement1** library was generated by Sebastian Thiel, and is placed +The **chromemanagement1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/chromemanagement1/src/api.rs b/gen/chromemanagement1/src/api.rs index c6cfa3f23a..fab3943a48 100644 --- a/gen/chromemanagement1/src/api.rs +++ b/gen/chromemanagement1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See detailed information about apps installed on Chrome browsers and devices managed by your organization ChromeManagementAppdetailReadonly, @@ -72,12 +72,12 @@ impl Default for Scope { /// use std::default::Default; /// use chromemanagement1::{ChromeManagement, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/chromemanagement1/src/lib.rs b/gen/chromemanagement1/src/lib.rs index a98115f89a..4fc69a0f39 100644 --- a/gen/chromemanagement1/src/lib.rs +++ b/gen/chromemanagement1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/chromemanagement1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](ChromeManagement) ... +//! Handle the following *Resources* with ease from the central [hub](ChromeManagement) ... //! //! * customers //! * [*apps android get*](api::CustomerAppAndroidGetCall), [*apps chrome get*](api::CustomerAppChromeGetCall), [*apps count chrome app requests*](api::CustomerAppCountChromeAppRequestCall), [*apps web get*](api::CustomerAppWebGetCall), [*reports count chrome devices reaching auto expiration date*](api::CustomerReportCountChromeDevicesReachingAutoExpirationDateCall), [*reports count chrome devices that need attention*](api::CustomerReportCountChromeDevicesThatNeedAttentionCall), [*reports count chrome hardware fleet devices*](api::CustomerReportCountChromeHardwareFleetDeviceCall), [*reports count chrome versions*](api::CustomerReportCountChromeVersionCall), [*reports count installed apps*](api::CustomerReportCountInstalledAppCall), [*reports find installed app devices*](api::CustomerReportFindInstalledAppDeviceCall), [*telemetry devices get*](api::CustomerTelemetryDeviceGetCall), [*telemetry devices list*](api::CustomerTelemetryDeviceListCall) and [*telemetry events list*](api::CustomerTelemetryEventListCall) @@ -52,8 +52,8 @@ //! let r = hub.customers().apps_web_get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -81,12 +81,12 @@ //! use std::default::Default; //! use chromemanagement1::{ChromeManagement, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -122,10 +122,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -135,25 +135,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/chromepolicy1/README.md b/gen/chromepolicy1/README.md index d6605926cc..89e4270d61 100644 --- a/gen/chromepolicy1/README.md +++ b/gen/chromepolicy1/README.md @@ -11,7 +11,7 @@ Everything else about the *Chrome Policy* *v1* API can be found at the [official documentation site](http://developers.google.com/chrome/policy). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-chromepolicy1/5.0.3+20230123/google_chromepolicy1/ChromePolicy) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-chromepolicy1/5.0.3+20230123/google_chromepolicy1/ChromePolicy) ... * customers * [*policies groups batch delete*](https://docs.rs/google-chromepolicy1/5.0.3+20230123/google_chromepolicy1/api::CustomerPolicyGroupBatchDeleteCall), [*policies groups batch modify*](https://docs.rs/google-chromepolicy1/5.0.3+20230123/google_chromepolicy1/api::CustomerPolicyGroupBatchModifyCall), [*policies groups list group priority ordering*](https://docs.rs/google-chromepolicy1/5.0.3+20230123/google_chromepolicy1/api::CustomerPolicyGroupListGroupPriorityOrderingCall), [*policies groups update group priority ordering*](https://docs.rs/google-chromepolicy1/5.0.3+20230123/google_chromepolicy1/api::CustomerPolicyGroupUpdateGroupPriorityOrderingCall), [*policies networks define certificate*](https://docs.rs/google-chromepolicy1/5.0.3+20230123/google_chromepolicy1/api::CustomerPolicyNetworkDefineCertificateCall), [*policies networks define network*](https://docs.rs/google-chromepolicy1/5.0.3+20230123/google_chromepolicy1/api::CustomerPolicyNetworkDefineNetworkCall), [*policies networks remove certificate*](https://docs.rs/google-chromepolicy1/5.0.3+20230123/google_chromepolicy1/api::CustomerPolicyNetworkRemoveCertificateCall), [*policies networks remove network*](https://docs.rs/google-chromepolicy1/5.0.3+20230123/google_chromepolicy1/api::CustomerPolicyNetworkRemoveNetworkCall), [*policies orgunits batch inherit*](https://docs.rs/google-chromepolicy1/5.0.3+20230123/google_chromepolicy1/api::CustomerPolicyOrgunitBatchInheritCall), [*policies orgunits batch modify*](https://docs.rs/google-chromepolicy1/5.0.3+20230123/google_chromepolicy1/api::CustomerPolicyOrgunitBatchModifyCall), [*policies resolve*](https://docs.rs/google-chromepolicy1/5.0.3+20230123/google_chromepolicy1/api::CustomerPolicyResolveCall), [*policy schemas get*](https://docs.rs/google-chromepolicy1/5.0.3+20230123/google_chromepolicy1/api::CustomerPolicySchemaGetCall) and [*policy schemas list*](https://docs.rs/google-chromepolicy1/5.0.3+20230123/google_chromepolicy1/api::CustomerPolicySchemaListCall) @@ -60,8 +60,8 @@ let r = hub.customers().policies_orgunits_batch_inherit(...).doit().await let r = hub.customers().policies_orgunits_batch_modify(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -89,12 +89,12 @@ use chromepolicy1::{Result, Error}; use std::default::Default; use chromepolicy1::{ChromePolicy, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -135,10 +135,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-chromepolicy1/5.0.3+20230123/google_chromepolicy1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-chromepolicy1/5.0.3+20230123/google_chromepolicy1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -148,25 +148,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-chrome You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-chromepolicy1/5.0.3+20230123/google_chromepolicy1/client::Delegate) to the -[Method Builder](https://docs.rs/google-chromepolicy1/5.0.3+20230123/google_chromepolicy1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-chromepolicy1/5.0.3+20230123/google_chromepolicy1/client::Delegate) to the +[Method Builder](https://docs.rs/google-chromepolicy1/5.0.3+20230123/google_chromepolicy1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-chromepolicy1/5.0.3+20230123/google_chromepolicy1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-chromepolicy1/5.0.3+20230123/google_chromepolicy1/client::RequestValue) and -[decodable](https://docs.rs/google-chromepolicy1/5.0.3+20230123/google_chromepolicy1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-chromepolicy1/5.0.3+20230123/google_chromepolicy1/client::RequestValue) and +[decodable](https://docs.rs/google-chromepolicy1/5.0.3+20230123/google_chromepolicy1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-chromepolicy1/5.0.3+20230123/google_chromepolicy1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-chromepolicy1/5.0.3+20230123/google_chromepolicy1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -185,7 +185,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **chromepolicy1** library was generated by Sebastian Thiel, and is placed +The **chromepolicy1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/chromepolicy1/src/api.rs b/gen/chromepolicy1/src/api.rs index e2e4bc8f3b..742ce4bfd1 100644 --- a/gen/chromepolicy1/src/api.rs +++ b/gen/chromepolicy1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, create or delete policies applied to Chrome OS and Chrome Browsers managed within your organization ChromeManagementPolicy, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use chromepolicy1::{ChromePolicy, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/chromepolicy1/src/lib.rs b/gen/chromepolicy1/src/lib.rs index 06a16746c9..c6b8fbef88 100644 --- a/gen/chromepolicy1/src/lib.rs +++ b/gen/chromepolicy1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/chromepolicy1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](ChromePolicy) ... +//! Handle the following *Resources* with ease from the central [hub](ChromePolicy) ... //! //! * customers //! * [*policies groups batch delete*](api::CustomerPolicyGroupBatchDeleteCall), [*policies groups batch modify*](api::CustomerPolicyGroupBatchModifyCall), [*policies groups list group priority ordering*](api::CustomerPolicyGroupListGroupPriorityOrderingCall), [*policies groups update group priority ordering*](api::CustomerPolicyGroupUpdateGroupPriorityOrderingCall), [*policies networks define certificate*](api::CustomerPolicyNetworkDefineCertificateCall), [*policies networks define network*](api::CustomerPolicyNetworkDefineNetworkCall), [*policies networks remove certificate*](api::CustomerPolicyNetworkRemoveCertificateCall), [*policies networks remove network*](api::CustomerPolicyNetworkRemoveNetworkCall), [*policies orgunits batch inherit*](api::CustomerPolicyOrgunitBatchInheritCall), [*policies orgunits batch modify*](api::CustomerPolicyOrgunitBatchModifyCall), [*policies resolve*](api::CustomerPolicyResolveCall), [*policy schemas get*](api::CustomerPolicySchemaGetCall) and [*policy schemas list*](api::CustomerPolicySchemaListCall) @@ -60,8 +60,8 @@ //! let r = hub.customers().policies_orgunits_batch_modify(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -90,12 +90,12 @@ //! use std::default::Default; //! use chromepolicy1::{ChromePolicy, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -136,10 +136,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -149,25 +149,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/chromeuxreport1/README.md b/gen/chromeuxreport1/README.md index ea3892b6d0..293bba22dc 100644 --- a/gen/chromeuxreport1/README.md +++ b/gen/chromeuxreport1/README.md @@ -11,7 +11,7 @@ Everything else about the *Chrome UX Report* *v1* API can be found at the [official documentation site](https://developers.google.com/web/tools/chrome-user-experience-report/api/reference). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-chromeuxreport1/5.0.3+20230117/google_chromeuxreport1/ChromeUXReport) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-chromeuxreport1/5.0.3+20230117/google_chromeuxreport1/ChromeUXReport) ... * [records](https://docs.rs/google-chromeuxreport1/5.0.3+20230117/google_chromeuxreport1/api::Record) * [*query record*](https://docs.rs/google-chromeuxreport1/5.0.3+20230117/google_chromeuxreport1/api::RecordQueryRecordCall) @@ -50,8 +50,8 @@ Or specifically ... let r = hub.records().query_record(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -79,12 +79,12 @@ use chromeuxreport1::{Result, Error}; use std::default::Default; use chromeuxreport1::{ChromeUXReport, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -125,10 +125,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-chromeuxreport1/5.0.3+20230117/google_chromeuxreport1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-chromeuxreport1/5.0.3+20230117/google_chromeuxreport1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -138,25 +138,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-chrome You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-chromeuxreport1/5.0.3+20230117/google_chromeuxreport1/client::Delegate) to the -[Method Builder](https://docs.rs/google-chromeuxreport1/5.0.3+20230117/google_chromeuxreport1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-chromeuxreport1/5.0.3+20230117/google_chromeuxreport1/client::Delegate) to the +[Method Builder](https://docs.rs/google-chromeuxreport1/5.0.3+20230117/google_chromeuxreport1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-chromeuxreport1/5.0.3+20230117/google_chromeuxreport1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-chromeuxreport1/5.0.3+20230117/google_chromeuxreport1/client::RequestValue) and -[decodable](https://docs.rs/google-chromeuxreport1/5.0.3+20230117/google_chromeuxreport1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-chromeuxreport1/5.0.3+20230117/google_chromeuxreport1/client::RequestValue) and +[decodable](https://docs.rs/google-chromeuxreport1/5.0.3+20230117/google_chromeuxreport1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-chromeuxreport1/5.0.3+20230117/google_chromeuxreport1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-chromeuxreport1/5.0.3+20230117/google_chromeuxreport1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -175,7 +175,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **chromeuxreport1** library was generated by Sebastian Thiel, and is placed +The **chromeuxreport1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/chromeuxreport1/src/api.rs b/gen/chromeuxreport1/src/api.rs index f9e399f3d9..999bcc59e6 100644 --- a/gen/chromeuxreport1/src/api.rs +++ b/gen/chromeuxreport1/src/api.rs @@ -43,12 +43,12 @@ use crate::{client, client::GetToken, client::serde_with}; /// use std::default::Default; /// use chromeuxreport1::{ChromeUXReport, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/chromeuxreport1/src/lib.rs b/gen/chromeuxreport1/src/lib.rs index b5d286600b..a9af867c50 100644 --- a/gen/chromeuxreport1/src/lib.rs +++ b/gen/chromeuxreport1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/chromeuxreport1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](ChromeUXReport) ... +//! Handle the following *Resources* with ease from the central [hub](ChromeUXReport) ... //! //! * [records](api::Record) //! * [*query record*](api::RecordQueryRecordCall) @@ -50,8 +50,8 @@ //! let r = hub.records().query_record(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -80,12 +80,12 @@ //! use std::default::Default; //! use chromeuxreport1::{ChromeUXReport, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -126,10 +126,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -139,25 +139,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/classroom1/README.md b/gen/classroom1/README.md index 83e150806d..a80dd301c0 100644 --- a/gen/classroom1/README.md +++ b/gen/classroom1/README.md @@ -11,7 +11,7 @@ Everything else about the *classroom* *v1* API can be found at the [official documentation site](https://developers.google.com/classroom/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/Classroom) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/Classroom) ... * [courses](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/api::Course) * [*aliases create*](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/api::CourseAliasCreateCall), [*aliases delete*](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/api::CourseAliasDeleteCall), [*aliases list*](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/api::CourseAliasListCall), [*announcements create*](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/api::CourseAnnouncementCreateCall), [*announcements delete*](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/api::CourseAnnouncementDeleteCall), [*announcements get*](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/api::CourseAnnouncementGetCall), [*announcements list*](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/api::CourseAnnouncementListCall), [*announcements modify assignees*](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/api::CourseAnnouncementModifyAssigneeCall), [*announcements patch*](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/api::CourseAnnouncementPatchCall), [*course work create*](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/api::CourseCourseWorkCreateCall), [*course work delete*](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/api::CourseCourseWorkDeleteCall), [*course work get*](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/api::CourseCourseWorkGetCall), [*course work list*](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/api::CourseCourseWorkListCall), [*course work modify assignees*](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/api::CourseCourseWorkModifyAssigneeCall), [*course work patch*](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/api::CourseCourseWorkPatchCall), [*course work student submissions get*](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/api::CourseCourseWorkStudentSubmissionGetCall), [*course work student submissions list*](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/api::CourseCourseWorkStudentSubmissionListCall), [*course work student submissions modify attachments*](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/api::CourseCourseWorkStudentSubmissionModifyAttachmentCall), [*course work student submissions patch*](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/api::CourseCourseWorkStudentSubmissionPatchCall), [*course work student submissions reclaim*](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/api::CourseCourseWorkStudentSubmissionReclaimCall), [*course work student submissions return*](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/api::CourseCourseWorkStudentSubmissionReturnCall), [*course work student submissions turn in*](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/api::CourseCourseWorkStudentSubmissionTurnInCall), [*course work materials create*](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/api::CourseCourseWorkMaterialCreateCall), [*course work materials delete*](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/api::CourseCourseWorkMaterialDeleteCall), [*course work materials get*](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/api::CourseCourseWorkMaterialGetCall), [*course work materials list*](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/api::CourseCourseWorkMaterialListCall), [*course work materials patch*](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/api::CourseCourseWorkMaterialPatchCall), [*create*](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/api::CourseCreateCall), [*delete*](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/api::CourseDeleteCall), [*get*](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/api::CourseGetCall), [*list*](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/api::CourseListCall), [*patch*](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/api::CoursePatchCall), [*students create*](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/api::CourseStudentCreateCall), [*students delete*](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/api::CourseStudentDeleteCall), [*students get*](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/api::CourseStudentGetCall), [*students list*](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/api::CourseStudentListCall), [*teachers create*](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/api::CourseTeacherCreateCall), [*teachers delete*](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/api::CourseTeacherDeleteCall), [*teachers get*](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/api::CourseTeacherGetCall), [*teachers list*](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/api::CourseTeacherListCall), [*topics create*](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/api::CourseTopicCreateCall), [*topics delete*](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/api::CourseTopicDeleteCall), [*topics get*](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/api::CourseTopicGetCall), [*topics list*](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/api::CourseTopicListCall), [*topics patch*](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/api::CourseTopicPatchCall) and [*update*](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/api::CourseUpdateCall) @@ -101,8 +101,8 @@ let r = hub.courses().patch(...).doit().await let r = hub.courses().update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -129,12 +129,12 @@ use classroom1::{Result, Error}; use std::default::Default; use classroom1::{Classroom, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -175,10 +175,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -188,25 +188,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-classr You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/client::Delegate) to the -[Method Builder](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/client::Delegate) to the +[Method Builder](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/client::RequestValue) and -[decodable](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/client::RequestValue) and +[decodable](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-classroom1/5.0.3+20230119/google_classroom1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -225,7 +225,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **classroom1** library was generated by Sebastian Thiel, and is placed +The **classroom1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/classroom1/src/api.rs b/gen/classroom1/src/api.rs index 85c2b766b9..9f2449ca7d 100644 --- a/gen/classroom1/src/api.rs +++ b/gen/classroom1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage announcements in Google Classroom Announcement, @@ -148,12 +148,12 @@ impl Default for Scope { /// use std::default::Default; /// use classroom1::{Classroom, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/classroom1/src/lib.rs b/gen/classroom1/src/lib.rs index c4de58aabc..7758879466 100644 --- a/gen/classroom1/src/lib.rs +++ b/gen/classroom1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/classroom1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Classroom) ... +//! Handle the following *Resources* with ease from the central [hub](Classroom) ... //! //! * [courses](api::Course) //! * [*aliases create*](api::CourseAliasCreateCall), [*aliases delete*](api::CourseAliasDeleteCall), [*aliases list*](api::CourseAliasListCall), [*announcements create*](api::CourseAnnouncementCreateCall), [*announcements delete*](api::CourseAnnouncementDeleteCall), [*announcements get*](api::CourseAnnouncementGetCall), [*announcements list*](api::CourseAnnouncementListCall), [*announcements modify assignees*](api::CourseAnnouncementModifyAssigneeCall), [*announcements patch*](api::CourseAnnouncementPatchCall), [*course work create*](api::CourseCourseWorkCreateCall), [*course work delete*](api::CourseCourseWorkDeleteCall), [*course work get*](api::CourseCourseWorkGetCall), [*course work list*](api::CourseCourseWorkListCall), [*course work modify assignees*](api::CourseCourseWorkModifyAssigneeCall), [*course work patch*](api::CourseCourseWorkPatchCall), [*course work student submissions get*](api::CourseCourseWorkStudentSubmissionGetCall), [*course work student submissions list*](api::CourseCourseWorkStudentSubmissionListCall), [*course work student submissions modify attachments*](api::CourseCourseWorkStudentSubmissionModifyAttachmentCall), [*course work student submissions patch*](api::CourseCourseWorkStudentSubmissionPatchCall), [*course work student submissions reclaim*](api::CourseCourseWorkStudentSubmissionReclaimCall), [*course work student submissions return*](api::CourseCourseWorkStudentSubmissionReturnCall), [*course work student submissions turn in*](api::CourseCourseWorkStudentSubmissionTurnInCall), [*course work materials create*](api::CourseCourseWorkMaterialCreateCall), [*course work materials delete*](api::CourseCourseWorkMaterialDeleteCall), [*course work materials get*](api::CourseCourseWorkMaterialGetCall), [*course work materials list*](api::CourseCourseWorkMaterialListCall), [*course work materials patch*](api::CourseCourseWorkMaterialPatchCall), [*create*](api::CourseCreateCall), [*delete*](api::CourseDeleteCall), [*get*](api::CourseGetCall), [*list*](api::CourseListCall), [*patch*](api::CoursePatchCall), [*students create*](api::CourseStudentCreateCall), [*students delete*](api::CourseStudentDeleteCall), [*students get*](api::CourseStudentGetCall), [*students list*](api::CourseStudentListCall), [*teachers create*](api::CourseTeacherCreateCall), [*teachers delete*](api::CourseTeacherDeleteCall), [*teachers get*](api::CourseTeacherGetCall), [*teachers list*](api::CourseTeacherListCall), [*topics create*](api::CourseTopicCreateCall), [*topics delete*](api::CourseTopicDeleteCall), [*topics get*](api::CourseTopicGetCall), [*topics list*](api::CourseTopicListCall), [*topics patch*](api::CourseTopicPatchCall) and [*update*](api::CourseUpdateCall) @@ -101,8 +101,8 @@ //! let r = hub.courses().update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -130,12 +130,12 @@ //! use std::default::Default; //! use classroom1::{Classroom, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -176,10 +176,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -189,25 +189,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/cloudasset1/README.md b/gen/cloudasset1/README.md index 1dc28c3097..74f2a534a1 100644 --- a/gen/cloudasset1/README.md +++ b/gen/cloudasset1/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Asset* *v1* API can be found at the [official documentation site](https://cloud.google.com/asset-inventory/docs/quickstart). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudasset1/5.0.3+20230121/google_cloudasset1/CloudAsset) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudasset1/5.0.3+20230121/google_cloudasset1/CloudAsset) ... * [assets](https://docs.rs/google-cloudasset1/5.0.3+20230121/google_cloudasset1/api::Asset) * [*list*](https://docs.rs/google-cloudasset1/5.0.3+20230121/google_cloudasset1/api::AssetListCall) @@ -75,8 +75,8 @@ let r = hub.feeds().list(...).doit().await let r = hub.feeds().patch(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -104,12 +104,12 @@ use cloudasset1::{Result, Error}; use std::default::Default; use cloudasset1::{CloudAsset, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -150,10 +150,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-cloudasset1/5.0.3+20230121/google_cloudasset1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-cloudasset1/5.0.3+20230121/google_cloudasset1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -163,25 +163,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-clouda You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudasset1/5.0.3+20230121/google_cloudasset1/client::Delegate) to the -[Method Builder](https://docs.rs/google-cloudasset1/5.0.3+20230121/google_cloudasset1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudasset1/5.0.3+20230121/google_cloudasset1/client::Delegate) to the +[Method Builder](https://docs.rs/google-cloudasset1/5.0.3+20230121/google_cloudasset1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-cloudasset1/5.0.3+20230121/google_cloudasset1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudasset1/5.0.3+20230121/google_cloudasset1/client::RequestValue) and -[decodable](https://docs.rs/google-cloudasset1/5.0.3+20230121/google_cloudasset1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudasset1/5.0.3+20230121/google_cloudasset1/client::RequestValue) and +[decodable](https://docs.rs/google-cloudasset1/5.0.3+20230121/google_cloudasset1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-cloudasset1/5.0.3+20230121/google_cloudasset1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-cloudasset1/5.0.3+20230121/google_cloudasset1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -200,7 +200,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **cloudasset1** library was generated by Sebastian Thiel, and is placed +The **cloudasset1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/cloudasset1/src/api.rs b/gen/cloudasset1/src/api.rs index 5339e89261..3ba4f5149d 100644 --- a/gen/cloudasset1/src/api.rs +++ b/gen/cloudasset1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use cloudasset1::{CloudAsset, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/cloudasset1/src/lib.rs b/gen/cloudasset1/src/lib.rs index 15d3fddd99..883d961448 100644 --- a/gen/cloudasset1/src/lib.rs +++ b/gen/cloudasset1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/cloudasset1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudAsset) ... +//! Handle the following *Resources* with ease from the central [hub](CloudAsset) ... //! //! * [assets](api::Asset) //! * [*list*](api::AssetListCall) @@ -75,8 +75,8 @@ //! let r = hub.feeds().patch(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -105,12 +105,12 @@ //! use std::default::Default; //! use cloudasset1::{CloudAsset, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -151,10 +151,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -164,25 +164,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/cloudasset1_beta1/README.md b/gen/cloudasset1_beta1/README.md index feaa4c572d..f46e5e644c 100644 --- a/gen/cloudasset1_beta1/README.md +++ b/gen/cloudasset1_beta1/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Asset* *v1_beta1* API can be found at the [official documentation site](https://cloud.google.com/asset-inventory/docs/quickstart). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudasset1_beta1/5.0.3+20230121/google_cloudasset1_beta1/CloudAsset) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudasset1_beta1/5.0.3+20230121/google_cloudasset1_beta1/CloudAsset) ... * folders * [*export assets*](https://docs.rs/google-cloudasset1_beta1/5.0.3+20230121/google_cloudasset1_beta1/api::FolderExportAssetCall) and [*operations get*](https://docs.rs/google-cloudasset1_beta1/5.0.3+20230121/google_cloudasset1_beta1/api::FolderOperationGetCall) @@ -59,8 +59,8 @@ let r = hub.projects().operations_get(...).doit().await let r = hub.projects().export_assets(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -88,12 +88,12 @@ use cloudasset1_beta1::{Result, Error}; use std::default::Default; use cloudasset1_beta1::{CloudAsset, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -134,10 +134,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-cloudasset1_beta1/5.0.3+20230121/google_cloudasset1_beta1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-cloudasset1_beta1/5.0.3+20230121/google_cloudasset1_beta1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -147,25 +147,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-clouda You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudasset1_beta1/5.0.3+20230121/google_cloudasset1_beta1/client::Delegate) to the -[Method Builder](https://docs.rs/google-cloudasset1_beta1/5.0.3+20230121/google_cloudasset1_beta1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudasset1_beta1/5.0.3+20230121/google_cloudasset1_beta1/client::Delegate) to the +[Method Builder](https://docs.rs/google-cloudasset1_beta1/5.0.3+20230121/google_cloudasset1_beta1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-cloudasset1_beta1/5.0.3+20230121/google_cloudasset1_beta1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudasset1_beta1/5.0.3+20230121/google_cloudasset1_beta1/client::RequestValue) and -[decodable](https://docs.rs/google-cloudasset1_beta1/5.0.3+20230121/google_cloudasset1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudasset1_beta1/5.0.3+20230121/google_cloudasset1_beta1/client::RequestValue) and +[decodable](https://docs.rs/google-cloudasset1_beta1/5.0.3+20230121/google_cloudasset1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-cloudasset1_beta1/5.0.3+20230121/google_cloudasset1_beta1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-cloudasset1_beta1/5.0.3+20230121/google_cloudasset1_beta1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -184,7 +184,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **cloudasset1_beta1** library was generated by Sebastian Thiel, and is placed +The **cloudasset1_beta1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/cloudasset1_beta1/src/api.rs b/gen/cloudasset1_beta1/src/api.rs index e7bcc4e0f9..81eaca5e5b 100644 --- a/gen/cloudasset1_beta1/src/api.rs +++ b/gen/cloudasset1_beta1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use cloudasset1_beta1::{CloudAsset, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/cloudasset1_beta1/src/lib.rs b/gen/cloudasset1_beta1/src/lib.rs index 1ec67da818..2accb5a8c0 100644 --- a/gen/cloudasset1_beta1/src/lib.rs +++ b/gen/cloudasset1_beta1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/cloudasset1_beta1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudAsset) ... +//! Handle the following *Resources* with ease from the central [hub](CloudAsset) ... //! //! * folders //! * [*export assets*](api::FolderExportAssetCall) and [*operations get*](api::FolderOperationGetCall) @@ -59,8 +59,8 @@ //! let r = hub.projects().export_assets(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -89,12 +89,12 @@ //! use std::default::Default; //! use cloudasset1_beta1::{CloudAsset, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -135,10 +135,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -148,25 +148,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/cloudbilling1/README.md b/gen/cloudbilling1/README.md index a6546638de..91246479b2 100644 --- a/gen/cloudbilling1/README.md +++ b/gen/cloudbilling1/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloudbilling* *v1* API can be found at the [official documentation site](https://cloud.google.com/billing/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudbilling1/5.0.3+20221206/google_cloudbilling1/Cloudbilling) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudbilling1/5.0.3+20221206/google_cloudbilling1/Cloudbilling) ... * [billing accounts](https://docs.rs/google-cloudbilling1/5.0.3+20221206/google_cloudbilling1/api::BillingAccount) * [*create*](https://docs.rs/google-cloudbilling1/5.0.3+20221206/google_cloudbilling1/api::BillingAccountCreateCall), [*get*](https://docs.rs/google-cloudbilling1/5.0.3+20221206/google_cloudbilling1/api::BillingAccountGetCall), [*get iam policy*](https://docs.rs/google-cloudbilling1/5.0.3+20221206/google_cloudbilling1/api::BillingAccountGetIamPolicyCall), [*list*](https://docs.rs/google-cloudbilling1/5.0.3+20221206/google_cloudbilling1/api::BillingAccountListCall), [*patch*](https://docs.rs/google-cloudbilling1/5.0.3+20221206/google_cloudbilling1/api::BillingAccountPatchCall), [*projects list*](https://docs.rs/google-cloudbilling1/5.0.3+20221206/google_cloudbilling1/api::BillingAccountProjectListCall), [*set iam policy*](https://docs.rs/google-cloudbilling1/5.0.3+20221206/google_cloudbilling1/api::BillingAccountSetIamPolicyCall) and [*test iam permissions*](https://docs.rs/google-cloudbilling1/5.0.3+20221206/google_cloudbilling1/api::BillingAccountTestIamPermissionCall) @@ -61,8 +61,8 @@ let r = hub.billing_accounts().set_iam_policy(...).doit().await let r = hub.billing_accounts().test_iam_permissions(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -89,12 +89,12 @@ use cloudbilling1::{Result, Error}; use std::default::Default; use cloudbilling1::{Cloudbilling, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -132,10 +132,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-cloudbilling1/5.0.3+20221206/google_cloudbilling1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-cloudbilling1/5.0.3+20221206/google_cloudbilling1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -145,25 +145,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-cloudb You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudbilling1/5.0.3+20221206/google_cloudbilling1/client::Delegate) to the -[Method Builder](https://docs.rs/google-cloudbilling1/5.0.3+20221206/google_cloudbilling1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudbilling1/5.0.3+20221206/google_cloudbilling1/client::Delegate) to the +[Method Builder](https://docs.rs/google-cloudbilling1/5.0.3+20221206/google_cloudbilling1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-cloudbilling1/5.0.3+20221206/google_cloudbilling1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudbilling1/5.0.3+20221206/google_cloudbilling1/client::RequestValue) and -[decodable](https://docs.rs/google-cloudbilling1/5.0.3+20221206/google_cloudbilling1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudbilling1/5.0.3+20221206/google_cloudbilling1/client::RequestValue) and +[decodable](https://docs.rs/google-cloudbilling1/5.0.3+20221206/google_cloudbilling1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-cloudbilling1/5.0.3+20221206/google_cloudbilling1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-cloudbilling1/5.0.3+20221206/google_cloudbilling1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -182,7 +182,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **cloudbilling1** library was generated by Sebastian Thiel, and is placed +The **cloudbilling1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/cloudbilling1/src/api.rs b/gen/cloudbilling1/src/api.rs index 55f827c89a..3c6972a872 100644 --- a/gen/cloudbilling1/src/api.rs +++ b/gen/cloudbilling1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your Google Cloud Platform billing accounts CloudBilling, @@ -72,12 +72,12 @@ impl Default for Scope { /// use std::default::Default; /// use cloudbilling1::{Cloudbilling, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/cloudbilling1/src/lib.rs b/gen/cloudbilling1/src/lib.rs index 8ad8bddb9d..1c966da8b5 100644 --- a/gen/cloudbilling1/src/lib.rs +++ b/gen/cloudbilling1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/cloudbilling1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Cloudbilling) ... +//! Handle the following *Resources* with ease from the central [hub](Cloudbilling) ... //! //! * [billing accounts](api::BillingAccount) //! * [*create*](api::BillingAccountCreateCall), [*get*](api::BillingAccountGetCall), [*get iam policy*](api::BillingAccountGetIamPolicyCall), [*list*](api::BillingAccountListCall), [*patch*](api::BillingAccountPatchCall), [*projects list*](api::BillingAccountProjectListCall), [*set iam policy*](api::BillingAccountSetIamPolicyCall) and [*test iam permissions*](api::BillingAccountTestIamPermissionCall) @@ -61,8 +61,8 @@ //! let r = hub.billing_accounts().test_iam_permissions(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -90,12 +90,12 @@ //! use std::default::Default; //! use cloudbilling1::{Cloudbilling, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -133,10 +133,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -146,25 +146,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/cloudbuild1/README.md b/gen/cloudbuild1/README.md index aee3fed6a2..54da8189a7 100644 --- a/gen/cloudbuild1/README.md +++ b/gen/cloudbuild1/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Build* *v1* API can be found at the [official documentation site](https://cloud.google.com/cloud-build/docs/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudbuild1/5.0.3+20230120/google_cloudbuild1/CloudBuild) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudbuild1/5.0.3+20230120/google_cloudbuild1/CloudBuild) ... * github dot com webhook * [*receive*](https://docs.rs/google-cloudbuild1/5.0.3+20230120/google_cloudbuild1/api::GithubDotComWebhookReceiveCall) @@ -86,8 +86,8 @@ let r = hub.projects().locations_worker_pools_patch(...).doit().await let r = hub.projects().triggers_run(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -115,12 +115,12 @@ use cloudbuild1::{Result, Error}; use std::default::Default; use cloudbuild1::{CloudBuild, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -163,10 +163,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-cloudbuild1/5.0.3+20230120/google_cloudbuild1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-cloudbuild1/5.0.3+20230120/google_cloudbuild1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -176,25 +176,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-cloudb You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudbuild1/5.0.3+20230120/google_cloudbuild1/client::Delegate) to the -[Method Builder](https://docs.rs/google-cloudbuild1/5.0.3+20230120/google_cloudbuild1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudbuild1/5.0.3+20230120/google_cloudbuild1/client::Delegate) to the +[Method Builder](https://docs.rs/google-cloudbuild1/5.0.3+20230120/google_cloudbuild1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-cloudbuild1/5.0.3+20230120/google_cloudbuild1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudbuild1/5.0.3+20230120/google_cloudbuild1/client::RequestValue) and -[decodable](https://docs.rs/google-cloudbuild1/5.0.3+20230120/google_cloudbuild1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudbuild1/5.0.3+20230120/google_cloudbuild1/client::RequestValue) and +[decodable](https://docs.rs/google-cloudbuild1/5.0.3+20230120/google_cloudbuild1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-cloudbuild1/5.0.3+20230120/google_cloudbuild1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-cloudbuild1/5.0.3+20230120/google_cloudbuild1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -213,7 +213,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **cloudbuild1** library was generated by Sebastian Thiel, and is placed +The **cloudbuild1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/cloudbuild1/src/api.rs b/gen/cloudbuild1/src/api.rs index 8605dddda5..c80a3eb85b 100644 --- a/gen/cloudbuild1/src/api.rs +++ b/gen/cloudbuild1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use cloudbuild1::{CloudBuild, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/cloudbuild1/src/lib.rs b/gen/cloudbuild1/src/lib.rs index 9a07319084..8bdcb949eb 100644 --- a/gen/cloudbuild1/src/lib.rs +++ b/gen/cloudbuild1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/cloudbuild1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudBuild) ... +//! Handle the following *Resources* with ease from the central [hub](CloudBuild) ... //! //! * github dot com webhook //! * [*receive*](api::GithubDotComWebhookReceiveCall) @@ -86,8 +86,8 @@ //! let r = hub.projects().triggers_run(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -116,12 +116,12 @@ //! use std::default::Default; //! use cloudbuild1::{CloudBuild, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -164,10 +164,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -177,25 +177,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/cloudchannel1/README.md b/gen/cloudchannel1/README.md index f01cd156b7..278c0ab9af 100644 --- a/gen/cloudchannel1/README.md +++ b/gen/cloudchannel1/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloudchannel* *v1* API can be found at the [official documentation site](https://cloud.google.com/channel). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/Cloudchannel) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/Cloudchannel) ... * accounts * [*channel partner links channel partner repricing configs create*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountChannelPartnerLinkChannelPartnerRepricingConfigCreateCall), [*channel partner links channel partner repricing configs delete*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountChannelPartnerLinkChannelPartnerRepricingConfigDeleteCall), [*channel partner links channel partner repricing configs get*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountChannelPartnerLinkChannelPartnerRepricingConfigGetCall), [*channel partner links channel partner repricing configs list*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountChannelPartnerLinkChannelPartnerRepricingConfigListCall), [*channel partner links channel partner repricing configs patch*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountChannelPartnerLinkChannelPartnerRepricingConfigPatchCall), [*channel partner links create*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountChannelPartnerLinkCreateCall), [*channel partner links customers create*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountChannelPartnerLinkCustomerCreateCall), [*channel partner links customers delete*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountChannelPartnerLinkCustomerDeleteCall), [*channel partner links customers get*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountChannelPartnerLinkCustomerGetCall), [*channel partner links customers import*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountChannelPartnerLinkCustomerImportCall), [*channel partner links customers list*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountChannelPartnerLinkCustomerListCall), [*channel partner links customers patch*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountChannelPartnerLinkCustomerPatchCall), [*channel partner links get*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountChannelPartnerLinkGetCall), [*channel partner links list*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountChannelPartnerLinkListCall), [*channel partner links patch*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountChannelPartnerLinkPatchCall), [*check cloud identity accounts exist*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountCheckCloudIdentityAccountsExistCall), [*customers create*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountCustomerCreateCall), [*customers customer repricing configs create*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountCustomerCustomerRepricingConfigCreateCall), [*customers customer repricing configs delete*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountCustomerCustomerRepricingConfigDeleteCall), [*customers customer repricing configs get*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountCustomerCustomerRepricingConfigGetCall), [*customers customer repricing configs list*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountCustomerCustomerRepricingConfigListCall), [*customers customer repricing configs patch*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountCustomerCustomerRepricingConfigPatchCall), [*customers delete*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountCustomerDeleteCall), [*customers entitlements activate*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountCustomerEntitlementActivateCall), [*customers entitlements cancel*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountCustomerEntitlementCancelCall), [*customers entitlements change offer*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountCustomerEntitlementChangeOfferCall), [*customers entitlements change parameters*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountCustomerEntitlementChangeParameterCall), [*customers entitlements change renewal settings*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountCustomerEntitlementChangeRenewalSettingCall), [*customers entitlements create*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountCustomerEntitlementCreateCall), [*customers entitlements get*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountCustomerEntitlementGetCall), [*customers entitlements list*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountCustomerEntitlementListCall), [*customers entitlements lookup offer*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountCustomerEntitlementLookupOfferCall), [*customers entitlements start paid service*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountCustomerEntitlementStartPaidServiceCall), [*customers entitlements suspend*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountCustomerEntitlementSuspendCall), [*customers get*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountCustomerGetCall), [*customers import*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountCustomerImportCall), [*customers list*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountCustomerListCall), [*customers list purchasable offers*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountCustomerListPurchasableOfferCall), [*customers list purchasable skus*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountCustomerListPurchasableSkuCall), [*customers patch*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountCustomerPatchCall), [*customers provision cloud identity*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountCustomerProvisionCloudIdentityCall), [*customers transfer entitlements*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountCustomerTransferEntitlementCall), [*customers transfer entitlements to google*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountCustomerTransferEntitlementsToGoogleCall), [*list subscribers*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountListSubscriberCall), [*list transferable offers*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountListTransferableOfferCall), [*list transferable skus*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountListTransferableSkuCall), [*offers list*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountOfferListCall), [*register*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountRegisterCall), [*report jobs fetch report results*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountReportJobFetchReportResultCall), [*reports list*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountReportListCall), [*reports run*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountReportRunCall) and [*unregister*](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/api::AccountUnregisterCall) @@ -66,8 +66,8 @@ let r = hub.accounts().reports_run(...).doit().await let r = hub.operations().get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -95,12 +95,12 @@ use cloudchannel1::{Result, Error}; use std::default::Default; use cloudchannel1::{Cloudchannel, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -141,10 +141,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -154,25 +154,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-cloudc You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/client::Delegate) to the -[Method Builder](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/client::Delegate) to the +[Method Builder](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/client::RequestValue) and -[decodable](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/client::RequestValue) and +[decodable](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-cloudchannel1/5.0.3+20230123/google_cloudchannel1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -191,7 +191,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **cloudchannel1** library was generated by Sebastian Thiel, and is placed +The **cloudchannel1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/cloudchannel1/src/api.rs b/gen/cloudchannel1/src/api.rs index 10bbf91b02..55554792fa 100644 --- a/gen/cloudchannel1/src/api.rs +++ b/gen/cloudchannel1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// Manage users on your domain AppOrder, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use cloudchannel1::{Cloudchannel, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/cloudchannel1/src/lib.rs b/gen/cloudchannel1/src/lib.rs index 7aed36d34b..6038f48b65 100644 --- a/gen/cloudchannel1/src/lib.rs +++ b/gen/cloudchannel1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/cloudchannel1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Cloudchannel) ... +//! Handle the following *Resources* with ease from the central [hub](Cloudchannel) ... //! //! * accounts //! * [*channel partner links channel partner repricing configs create*](api::AccountChannelPartnerLinkChannelPartnerRepricingConfigCreateCall), [*channel partner links channel partner repricing configs delete*](api::AccountChannelPartnerLinkChannelPartnerRepricingConfigDeleteCall), [*channel partner links channel partner repricing configs get*](api::AccountChannelPartnerLinkChannelPartnerRepricingConfigGetCall), [*channel partner links channel partner repricing configs list*](api::AccountChannelPartnerLinkChannelPartnerRepricingConfigListCall), [*channel partner links channel partner repricing configs patch*](api::AccountChannelPartnerLinkChannelPartnerRepricingConfigPatchCall), [*channel partner links create*](api::AccountChannelPartnerLinkCreateCall), [*channel partner links customers create*](api::AccountChannelPartnerLinkCustomerCreateCall), [*channel partner links customers delete*](api::AccountChannelPartnerLinkCustomerDeleteCall), [*channel partner links customers get*](api::AccountChannelPartnerLinkCustomerGetCall), [*channel partner links customers import*](api::AccountChannelPartnerLinkCustomerImportCall), [*channel partner links customers list*](api::AccountChannelPartnerLinkCustomerListCall), [*channel partner links customers patch*](api::AccountChannelPartnerLinkCustomerPatchCall), [*channel partner links get*](api::AccountChannelPartnerLinkGetCall), [*channel partner links list*](api::AccountChannelPartnerLinkListCall), [*channel partner links patch*](api::AccountChannelPartnerLinkPatchCall), [*check cloud identity accounts exist*](api::AccountCheckCloudIdentityAccountsExistCall), [*customers create*](api::AccountCustomerCreateCall), [*customers customer repricing configs create*](api::AccountCustomerCustomerRepricingConfigCreateCall), [*customers customer repricing configs delete*](api::AccountCustomerCustomerRepricingConfigDeleteCall), [*customers customer repricing configs get*](api::AccountCustomerCustomerRepricingConfigGetCall), [*customers customer repricing configs list*](api::AccountCustomerCustomerRepricingConfigListCall), [*customers customer repricing configs patch*](api::AccountCustomerCustomerRepricingConfigPatchCall), [*customers delete*](api::AccountCustomerDeleteCall), [*customers entitlements activate*](api::AccountCustomerEntitlementActivateCall), [*customers entitlements cancel*](api::AccountCustomerEntitlementCancelCall), [*customers entitlements change offer*](api::AccountCustomerEntitlementChangeOfferCall), [*customers entitlements change parameters*](api::AccountCustomerEntitlementChangeParameterCall), [*customers entitlements change renewal settings*](api::AccountCustomerEntitlementChangeRenewalSettingCall), [*customers entitlements create*](api::AccountCustomerEntitlementCreateCall), [*customers entitlements get*](api::AccountCustomerEntitlementGetCall), [*customers entitlements list*](api::AccountCustomerEntitlementListCall), [*customers entitlements lookup offer*](api::AccountCustomerEntitlementLookupOfferCall), [*customers entitlements start paid service*](api::AccountCustomerEntitlementStartPaidServiceCall), [*customers entitlements suspend*](api::AccountCustomerEntitlementSuspendCall), [*customers get*](api::AccountCustomerGetCall), [*customers import*](api::AccountCustomerImportCall), [*customers list*](api::AccountCustomerListCall), [*customers list purchasable offers*](api::AccountCustomerListPurchasableOfferCall), [*customers list purchasable skus*](api::AccountCustomerListPurchasableSkuCall), [*customers patch*](api::AccountCustomerPatchCall), [*customers provision cloud identity*](api::AccountCustomerProvisionCloudIdentityCall), [*customers transfer entitlements*](api::AccountCustomerTransferEntitlementCall), [*customers transfer entitlements to google*](api::AccountCustomerTransferEntitlementsToGoogleCall), [*list subscribers*](api::AccountListSubscriberCall), [*list transferable offers*](api::AccountListTransferableOfferCall), [*list transferable skus*](api::AccountListTransferableSkuCall), [*offers list*](api::AccountOfferListCall), [*register*](api::AccountRegisterCall), [*report jobs fetch report results*](api::AccountReportJobFetchReportResultCall), [*reports list*](api::AccountReportListCall), [*reports run*](api::AccountReportRunCall) and [*unregister*](api::AccountUnregisterCall) @@ -66,8 +66,8 @@ //! let r = hub.operations().get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -96,12 +96,12 @@ //! use std::default::Default; //! use cloudchannel1::{Cloudchannel, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -142,10 +142,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -155,25 +155,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/clouddebugger2/README.md b/gen/clouddebugger2/README.md index 4ee671e8ba..e2b67f036a 100644 --- a/gen/clouddebugger2/README.md +++ b/gen/clouddebugger2/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Debugger* *v2* API can be found at the [official documentation site](https://cloud.google.com/debugger). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-clouddebugger2/5.0.3+20230113/google_clouddebugger2/CloudDebugger) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-clouddebugger2/5.0.3+20230113/google_clouddebugger2/CloudDebugger) ... * controller * [*debuggees breakpoints list*](https://docs.rs/google-clouddebugger2/5.0.3+20230113/google_clouddebugger2/api::ControllerDebuggeeBreakpointListCall), [*debuggees breakpoints update*](https://docs.rs/google-clouddebugger2/5.0.3+20230113/google_clouddebugger2/api::ControllerDebuggeeBreakpointUpdateCall) and [*debuggees register*](https://docs.rs/google-clouddebugger2/5.0.3+20230113/google_clouddebugger2/api::ControllerDebuggeeRegisterCall) @@ -52,8 +52,8 @@ Or specifically ... let r = hub.debugger().debuggees_breakpoints_set(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -81,12 +81,12 @@ use clouddebugger2::{Result, Error}; use std::default::Default; use clouddebugger2::{CloudDebugger, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -129,10 +129,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-clouddebugger2/5.0.3+20230113/google_clouddebugger2/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-clouddebugger2/5.0.3+20230113/google_clouddebugger2/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -142,25 +142,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-cloudd You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-clouddebugger2/5.0.3+20230113/google_clouddebugger2/client::Delegate) to the -[Method Builder](https://docs.rs/google-clouddebugger2/5.0.3+20230113/google_clouddebugger2/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-clouddebugger2/5.0.3+20230113/google_clouddebugger2/client::Delegate) to the +[Method Builder](https://docs.rs/google-clouddebugger2/5.0.3+20230113/google_clouddebugger2/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-clouddebugger2/5.0.3+20230113/google_clouddebugger2/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-clouddebugger2/5.0.3+20230113/google_clouddebugger2/client::RequestValue) and -[decodable](https://docs.rs/google-clouddebugger2/5.0.3+20230113/google_clouddebugger2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-clouddebugger2/5.0.3+20230113/google_clouddebugger2/client::RequestValue) and +[decodable](https://docs.rs/google-clouddebugger2/5.0.3+20230113/google_clouddebugger2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-clouddebugger2/5.0.3+20230113/google_clouddebugger2/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-clouddebugger2/5.0.3+20230113/google_clouddebugger2/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -179,7 +179,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **clouddebugger2** library was generated by Sebastian Thiel, and is placed +The **clouddebugger2** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/clouddebugger2/src/api.rs b/gen/clouddebugger2/src/api.rs index 01322ec381..b0ea2d00c2 100644 --- a/gen/clouddebugger2/src/api.rs +++ b/gen/clouddebugger2/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use clouddebugger2::{CloudDebugger, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/clouddebugger2/src/lib.rs b/gen/clouddebugger2/src/lib.rs index 32673c6617..3819392716 100644 --- a/gen/clouddebugger2/src/lib.rs +++ b/gen/clouddebugger2/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/clouddebugger2). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudDebugger) ... +//! Handle the following *Resources* with ease from the central [hub](CloudDebugger) ... //! //! * controller //! * [*debuggees breakpoints list*](api::ControllerDebuggeeBreakpointListCall), [*debuggees breakpoints update*](api::ControllerDebuggeeBreakpointUpdateCall) and [*debuggees register*](api::ControllerDebuggeeRegisterCall) @@ -52,8 +52,8 @@ //! let r = hub.debugger().debuggees_breakpoints_set(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -82,12 +82,12 @@ //! use std::default::Default; //! use clouddebugger2::{CloudDebugger, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -130,10 +130,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -143,25 +143,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/clouddeploy1/README.md b/gen/clouddeploy1/README.md index dc199335ac..cd4488bd1b 100644 --- a/gen/clouddeploy1/README.md +++ b/gen/clouddeploy1/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Deploy* *v1* API can be found at the [official documentation site](https://cloud.google.com/deploy/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/CloudDeploy) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/CloudDeploy) ... * projects * [*locations delivery pipelines create*](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/api::ProjectLocationDeliveryPipelineCreateCall), [*locations delivery pipelines delete*](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/api::ProjectLocationDeliveryPipelineDeleteCall), [*locations delivery pipelines get*](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/api::ProjectLocationDeliveryPipelineGetCall), [*locations delivery pipelines get iam policy*](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/api::ProjectLocationDeliveryPipelineGetIamPolicyCall), [*locations delivery pipelines list*](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/api::ProjectLocationDeliveryPipelineListCall), [*locations delivery pipelines patch*](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/api::ProjectLocationDeliveryPipelinePatchCall), [*locations delivery pipelines releases abandon*](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/api::ProjectLocationDeliveryPipelineReleaseAbandonCall), [*locations delivery pipelines releases create*](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/api::ProjectLocationDeliveryPipelineReleaseCreateCall), [*locations delivery pipelines releases get*](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/api::ProjectLocationDeliveryPipelineReleaseGetCall), [*locations delivery pipelines releases list*](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/api::ProjectLocationDeliveryPipelineReleaseListCall), [*locations delivery pipelines releases rollouts approve*](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/api::ProjectLocationDeliveryPipelineReleaseRolloutApproveCall), [*locations delivery pipelines releases rollouts create*](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/api::ProjectLocationDeliveryPipelineReleaseRolloutCreateCall), [*locations delivery pipelines releases rollouts get*](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/api::ProjectLocationDeliveryPipelineReleaseRolloutGetCall), [*locations delivery pipelines releases rollouts job runs get*](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/api::ProjectLocationDeliveryPipelineReleaseRolloutJobRunGetCall), [*locations delivery pipelines releases rollouts job runs list*](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/api::ProjectLocationDeliveryPipelineReleaseRolloutJobRunListCall), [*locations delivery pipelines releases rollouts list*](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/api::ProjectLocationDeliveryPipelineReleaseRolloutListCall), [*locations delivery pipelines releases rollouts retry job*](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/api::ProjectLocationDeliveryPipelineReleaseRolloutRetryJobCall), [*locations delivery pipelines set iam policy*](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/api::ProjectLocationDeliveryPipelineSetIamPolicyCall), [*locations delivery pipelines test iam permissions*](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/api::ProjectLocationDeliveryPipelineTestIamPermissionCall), [*locations get*](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/api::ProjectLocationGetCall), [*locations get config*](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/api::ProjectLocationGetConfigCall), [*locations list*](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/api::ProjectLocationListCall), [*locations operations cancel*](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/api::ProjectLocationOperationCancelCall), [*locations operations delete*](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/api::ProjectLocationOperationDeleteCall), [*locations operations get*](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/api::ProjectLocationOperationGetCall), [*locations operations list*](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/api::ProjectLocationOperationListCall), [*locations targets create*](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/api::ProjectLocationTargetCreateCall), [*locations targets delete*](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/api::ProjectLocationTargetDeleteCall), [*locations targets get*](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/api::ProjectLocationTargetGetCall), [*locations targets get iam policy*](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/api::ProjectLocationTargetGetIamPolicyCall), [*locations targets list*](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/api::ProjectLocationTargetListCall), [*locations targets patch*](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/api::ProjectLocationTargetPatchCall), [*locations targets set iam policy*](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/api::ProjectLocationTargetSetIamPolicyCall) and [*locations targets test iam permissions*](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/api::ProjectLocationTargetTestIamPermissionCall) @@ -58,8 +58,8 @@ let r = hub.projects().locations_targets_delete(...).doit().await let r = hub.projects().locations_targets_patch(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -86,12 +86,12 @@ use clouddeploy1::{Result, Error}; use std::default::Default; use clouddeploy1::{CloudDeploy, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -132,10 +132,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -145,25 +145,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-cloudd You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/client::Delegate) to the -[Method Builder](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/client::Delegate) to the +[Method Builder](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/client::RequestValue) and -[decodable](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/client::RequestValue) and +[decodable](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-clouddeploy1/5.0.3+20230105/google_clouddeploy1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -182,7 +182,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **clouddeploy1** library was generated by Sebastian Thiel, and is placed +The **clouddeploy1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/clouddeploy1/src/api.rs b/gen/clouddeploy1/src/api.rs index 77b71438b9..fc2ea09c19 100644 --- a/gen/clouddeploy1/src/api.rs +++ b/gen/clouddeploy1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use clouddeploy1::{CloudDeploy, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/clouddeploy1/src/lib.rs b/gen/clouddeploy1/src/lib.rs index c276272423..9f19df8044 100644 --- a/gen/clouddeploy1/src/lib.rs +++ b/gen/clouddeploy1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/clouddeploy1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudDeploy) ... +//! Handle the following *Resources* with ease from the central [hub](CloudDeploy) ... //! //! * projects //! * [*locations delivery pipelines create*](api::ProjectLocationDeliveryPipelineCreateCall), [*locations delivery pipelines delete*](api::ProjectLocationDeliveryPipelineDeleteCall), [*locations delivery pipelines get*](api::ProjectLocationDeliveryPipelineGetCall), [*locations delivery pipelines get iam policy*](api::ProjectLocationDeliveryPipelineGetIamPolicyCall), [*locations delivery pipelines list*](api::ProjectLocationDeliveryPipelineListCall), [*locations delivery pipelines patch*](api::ProjectLocationDeliveryPipelinePatchCall), [*locations delivery pipelines releases abandon*](api::ProjectLocationDeliveryPipelineReleaseAbandonCall), [*locations delivery pipelines releases create*](api::ProjectLocationDeliveryPipelineReleaseCreateCall), [*locations delivery pipelines releases get*](api::ProjectLocationDeliveryPipelineReleaseGetCall), [*locations delivery pipelines releases list*](api::ProjectLocationDeliveryPipelineReleaseListCall), [*locations delivery pipelines releases rollouts approve*](api::ProjectLocationDeliveryPipelineReleaseRolloutApproveCall), [*locations delivery pipelines releases rollouts create*](api::ProjectLocationDeliveryPipelineReleaseRolloutCreateCall), [*locations delivery pipelines releases rollouts get*](api::ProjectLocationDeliveryPipelineReleaseRolloutGetCall), [*locations delivery pipelines releases rollouts job runs get*](api::ProjectLocationDeliveryPipelineReleaseRolloutJobRunGetCall), [*locations delivery pipelines releases rollouts job runs list*](api::ProjectLocationDeliveryPipelineReleaseRolloutJobRunListCall), [*locations delivery pipelines releases rollouts list*](api::ProjectLocationDeliveryPipelineReleaseRolloutListCall), [*locations delivery pipelines releases rollouts retry job*](api::ProjectLocationDeliveryPipelineReleaseRolloutRetryJobCall), [*locations delivery pipelines set iam policy*](api::ProjectLocationDeliveryPipelineSetIamPolicyCall), [*locations delivery pipelines test iam permissions*](api::ProjectLocationDeliveryPipelineTestIamPermissionCall), [*locations get*](api::ProjectLocationGetCall), [*locations get config*](api::ProjectLocationGetConfigCall), [*locations list*](api::ProjectLocationListCall), [*locations operations cancel*](api::ProjectLocationOperationCancelCall), [*locations operations delete*](api::ProjectLocationOperationDeleteCall), [*locations operations get*](api::ProjectLocationOperationGetCall), [*locations operations list*](api::ProjectLocationOperationListCall), [*locations targets create*](api::ProjectLocationTargetCreateCall), [*locations targets delete*](api::ProjectLocationTargetDeleteCall), [*locations targets get*](api::ProjectLocationTargetGetCall), [*locations targets get iam policy*](api::ProjectLocationTargetGetIamPolicyCall), [*locations targets list*](api::ProjectLocationTargetListCall), [*locations targets patch*](api::ProjectLocationTargetPatchCall), [*locations targets set iam policy*](api::ProjectLocationTargetSetIamPolicyCall) and [*locations targets test iam permissions*](api::ProjectLocationTargetTestIamPermissionCall) @@ -58,8 +58,8 @@ //! let r = hub.projects().locations_targets_patch(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -87,12 +87,12 @@ //! use std::default::Default; //! use clouddeploy1::{CloudDeploy, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -133,10 +133,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -146,25 +146,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/clouderrorreporting1_beta1/README.md b/gen/clouderrorreporting1_beta1/README.md index 49217de9f5..24d41f46ce 100644 --- a/gen/clouderrorreporting1_beta1/README.md +++ b/gen/clouderrorreporting1_beta1/README.md @@ -11,7 +11,7 @@ Everything else about the *Clouderrorreporting* *v1_beta1* API can be found at t [official documentation site](https://cloud.google.com/error-reporting/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-clouderrorreporting1_beta1/5.0.3+20230112/google_clouderrorreporting1_beta1/Clouderrorreporting) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-clouderrorreporting1_beta1/5.0.3+20230112/google_clouderrorreporting1_beta1/Clouderrorreporting) ... * projects * [*delete events*](https://docs.rs/google-clouderrorreporting1_beta1/5.0.3+20230112/google_clouderrorreporting1_beta1/api::ProjectDeleteEventCall), [*events list*](https://docs.rs/google-clouderrorreporting1_beta1/5.0.3+20230112/google_clouderrorreporting1_beta1/api::ProjectEventListCall), [*events report*](https://docs.rs/google-clouderrorreporting1_beta1/5.0.3+20230112/google_clouderrorreporting1_beta1/api::ProjectEventReportCall), [*group stats list*](https://docs.rs/google-clouderrorreporting1_beta1/5.0.3+20230112/google_clouderrorreporting1_beta1/api::ProjectGroupStatListCall), [*groups get*](https://docs.rs/google-clouderrorreporting1_beta1/5.0.3+20230112/google_clouderrorreporting1_beta1/api::ProjectGroupGetCall) and [*groups update*](https://docs.rs/google-clouderrorreporting1_beta1/5.0.3+20230112/google_clouderrorreporting1_beta1/api::ProjectGroupUpdateCall) @@ -51,8 +51,8 @@ let r = hub.projects().groups_get(...).doit().await let r = hub.projects().groups_update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -80,12 +80,12 @@ use clouderrorreporting1_beta1::{Result, Error}; use std::default::Default; use clouderrorreporting1_beta1::{Clouderrorreporting, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -126,10 +126,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-clouderrorreporting1_beta1/5.0.3+20230112/google_clouderrorreporting1_beta1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-clouderrorreporting1_beta1/5.0.3+20230112/google_clouderrorreporting1_beta1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -139,25 +139,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-cloude You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-clouderrorreporting1_beta1/5.0.3+20230112/google_clouderrorreporting1_beta1/client::Delegate) to the -[Method Builder](https://docs.rs/google-clouderrorreporting1_beta1/5.0.3+20230112/google_clouderrorreporting1_beta1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-clouderrorreporting1_beta1/5.0.3+20230112/google_clouderrorreporting1_beta1/client::Delegate) to the +[Method Builder](https://docs.rs/google-clouderrorreporting1_beta1/5.0.3+20230112/google_clouderrorreporting1_beta1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-clouderrorreporting1_beta1/5.0.3+20230112/google_clouderrorreporting1_beta1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-clouderrorreporting1_beta1/5.0.3+20230112/google_clouderrorreporting1_beta1/client::RequestValue) and -[decodable](https://docs.rs/google-clouderrorreporting1_beta1/5.0.3+20230112/google_clouderrorreporting1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-clouderrorreporting1_beta1/5.0.3+20230112/google_clouderrorreporting1_beta1/client::RequestValue) and +[decodable](https://docs.rs/google-clouderrorreporting1_beta1/5.0.3+20230112/google_clouderrorreporting1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-clouderrorreporting1_beta1/5.0.3+20230112/google_clouderrorreporting1_beta1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-clouderrorreporting1_beta1/5.0.3+20230112/google_clouderrorreporting1_beta1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -176,7 +176,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **clouderrorreporting1_beta1** library was generated by Sebastian Thiel, and is placed +The **clouderrorreporting1_beta1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/clouderrorreporting1_beta1/src/api.rs b/gen/clouderrorreporting1_beta1/src/api.rs index 0a7adc6fe8..5d15c7d8dc 100644 --- a/gen/clouderrorreporting1_beta1/src/api.rs +++ b/gen/clouderrorreporting1_beta1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use clouderrorreporting1_beta1::{Clouderrorreporting, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/clouderrorreporting1_beta1/src/lib.rs b/gen/clouderrorreporting1_beta1/src/lib.rs index 4b4556f96a..13bca3d821 100644 --- a/gen/clouderrorreporting1_beta1/src/lib.rs +++ b/gen/clouderrorreporting1_beta1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/clouderrorreporting1_beta1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Clouderrorreporting) ... +//! Handle the following *Resources* with ease from the central [hub](Clouderrorreporting) ... //! //! * projects //! * [*delete events*](api::ProjectDeleteEventCall), [*events list*](api::ProjectEventListCall), [*events report*](api::ProjectEventReportCall), [*group stats list*](api::ProjectGroupStatListCall), [*groups get*](api::ProjectGroupGetCall) and [*groups update*](api::ProjectGroupUpdateCall) @@ -51,8 +51,8 @@ //! let r = hub.projects().groups_update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -81,12 +81,12 @@ //! use std::default::Default; //! use clouderrorreporting1_beta1::{Clouderrorreporting, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -127,10 +127,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -140,25 +140,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/cloudfunctions1/README.md b/gen/cloudfunctions1/README.md index cd878f5661..95694cfe5b 100644 --- a/gen/cloudfunctions1/README.md +++ b/gen/cloudfunctions1/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Functions* *v1* API can be found at the [official documentation site](https://cloud.google.com/functions). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudfunctions1/5.0.3+20230119/google_cloudfunctions1/CloudFunctions) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudfunctions1/5.0.3+20230119/google_cloudfunctions1/CloudFunctions) ... * [operations](https://docs.rs/google-cloudfunctions1/5.0.3+20230119/google_cloudfunctions1/api::Operation) * [*get*](https://docs.rs/google-cloudfunctions1/5.0.3+20230119/google_cloudfunctions1/api::OperationGetCall) and [*list*](https://docs.rs/google-cloudfunctions1/5.0.3+20230119/google_cloudfunctions1/api::OperationListCall) @@ -56,8 +56,8 @@ let r = hub.projects().locations_functions_delete(...).doit().await let r = hub.projects().locations_functions_patch(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -84,12 +84,12 @@ use cloudfunctions1::{Result, Error}; use std::default::Default; use cloudfunctions1::{CloudFunctions, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -129,10 +129,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-cloudfunctions1/5.0.3+20230119/google_cloudfunctions1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-cloudfunctions1/5.0.3+20230119/google_cloudfunctions1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -142,25 +142,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-cloudf You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudfunctions1/5.0.3+20230119/google_cloudfunctions1/client::Delegate) to the -[Method Builder](https://docs.rs/google-cloudfunctions1/5.0.3+20230119/google_cloudfunctions1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudfunctions1/5.0.3+20230119/google_cloudfunctions1/client::Delegate) to the +[Method Builder](https://docs.rs/google-cloudfunctions1/5.0.3+20230119/google_cloudfunctions1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-cloudfunctions1/5.0.3+20230119/google_cloudfunctions1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudfunctions1/5.0.3+20230119/google_cloudfunctions1/client::RequestValue) and -[decodable](https://docs.rs/google-cloudfunctions1/5.0.3+20230119/google_cloudfunctions1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudfunctions1/5.0.3+20230119/google_cloudfunctions1/client::RequestValue) and +[decodable](https://docs.rs/google-cloudfunctions1/5.0.3+20230119/google_cloudfunctions1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-cloudfunctions1/5.0.3+20230119/google_cloudfunctions1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-cloudfunctions1/5.0.3+20230119/google_cloudfunctions1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -179,7 +179,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **cloudfunctions1** library was generated by Sebastian Thiel, and is placed +The **cloudfunctions1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/cloudfunctions1/src/api.rs b/gen/cloudfunctions1/src/api.rs index a40f1f8062..392854a78f 100644 --- a/gen/cloudfunctions1/src/api.rs +++ b/gen/cloudfunctions1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use cloudfunctions1::{CloudFunctions, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/cloudfunctions1/src/lib.rs b/gen/cloudfunctions1/src/lib.rs index f92e71485a..98023a1728 100644 --- a/gen/cloudfunctions1/src/lib.rs +++ b/gen/cloudfunctions1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/cloudfunctions1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudFunctions) ... +//! Handle the following *Resources* with ease from the central [hub](CloudFunctions) ... //! //! * [operations](api::Operation) //! * [*get*](api::OperationGetCall) and [*list*](api::OperationListCall) @@ -56,8 +56,8 @@ //! let r = hub.projects().locations_functions_patch(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -85,12 +85,12 @@ //! use std::default::Default; //! use cloudfunctions1::{CloudFunctions, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -130,10 +130,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -143,25 +143,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/cloudidentity1/README.md b/gen/cloudidentity1/README.md index 523468f356..9c0037d688 100644 --- a/gen/cloudidentity1/README.md +++ b/gen/cloudidentity1/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Identity* *v1* API can be found at the [official documentation site](https://cloud.google.com/identity/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudidentity1/5.0.3+20230117/google_cloudidentity1/CloudIdentity) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudidentity1/5.0.3+20230117/google_cloudidentity1/CloudIdentity) ... * customers * [*userinvitations cancel*](https://docs.rs/google-cloudidentity1/5.0.3+20230117/google_cloudidentity1/api::CustomerUserinvitationCancelCall), [*userinvitations get*](https://docs.rs/google-cloudidentity1/5.0.3+20230117/google_cloudidentity1/api::CustomerUserinvitationGetCall), [*userinvitations is invitable user*](https://docs.rs/google-cloudidentity1/5.0.3+20230117/google_cloudidentity1/api::CustomerUserinvitationIsInvitableUserCall), [*userinvitations list*](https://docs.rs/google-cloudidentity1/5.0.3+20230117/google_cloudidentity1/api::CustomerUserinvitationListCall) and [*userinvitations send*](https://docs.rs/google-cloudidentity1/5.0.3+20230117/google_cloudidentity1/api::CustomerUserinvitationSendCall) @@ -84,8 +84,8 @@ let r = hub.inbound_sso_assignments().delete(...).doit().await let r = hub.inbound_sso_assignments().patch(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -113,12 +113,12 @@ use cloudidentity1::{Result, Error}; use std::default::Default; use cloudidentity1::{CloudIdentity, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -161,10 +161,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-cloudidentity1/5.0.3+20230117/google_cloudidentity1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-cloudidentity1/5.0.3+20230117/google_cloudidentity1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -174,25 +174,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-cloudi You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudidentity1/5.0.3+20230117/google_cloudidentity1/client::Delegate) to the -[Method Builder](https://docs.rs/google-cloudidentity1/5.0.3+20230117/google_cloudidentity1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudidentity1/5.0.3+20230117/google_cloudidentity1/client::Delegate) to the +[Method Builder](https://docs.rs/google-cloudidentity1/5.0.3+20230117/google_cloudidentity1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-cloudidentity1/5.0.3+20230117/google_cloudidentity1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudidentity1/5.0.3+20230117/google_cloudidentity1/client::RequestValue) and -[decodable](https://docs.rs/google-cloudidentity1/5.0.3+20230117/google_cloudidentity1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudidentity1/5.0.3+20230117/google_cloudidentity1/client::RequestValue) and +[decodable](https://docs.rs/google-cloudidentity1/5.0.3+20230117/google_cloudidentity1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-cloudidentity1/5.0.3+20230117/google_cloudidentity1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-cloudidentity1/5.0.3+20230117/google_cloudidentity1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -211,7 +211,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **cloudidentity1** library was generated by Sebastian Thiel, and is placed +The **cloudidentity1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/cloudidentity1/src/api.rs b/gen/cloudidentity1/src/api.rs index b217b98a74..dea3a30dad 100644 --- a/gen/cloudidentity1/src/api.rs +++ b/gen/cloudidentity1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// Private Service: https://www.googleapis.com/auth/cloud-identity.devices CloudIdentityDevice, @@ -85,12 +85,12 @@ impl Default for Scope { /// use std::default::Default; /// use cloudidentity1::{CloudIdentity, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/cloudidentity1/src/lib.rs b/gen/cloudidentity1/src/lib.rs index f6b4ccce94..a6d855f3ea 100644 --- a/gen/cloudidentity1/src/lib.rs +++ b/gen/cloudidentity1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/cloudidentity1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudIdentity) ... +//! Handle the following *Resources* with ease from the central [hub](CloudIdentity) ... //! //! * customers //! * [*userinvitations cancel*](api::CustomerUserinvitationCancelCall), [*userinvitations get*](api::CustomerUserinvitationGetCall), [*userinvitations is invitable user*](api::CustomerUserinvitationIsInvitableUserCall), [*userinvitations list*](api::CustomerUserinvitationListCall) and [*userinvitations send*](api::CustomerUserinvitationSendCall) @@ -84,8 +84,8 @@ //! let r = hub.inbound_sso_assignments().patch(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -114,12 +114,12 @@ //! use std::default::Default; //! use cloudidentity1::{CloudIdentity, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -162,10 +162,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -175,25 +175,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/cloudiot1/README.md b/gen/cloudiot1/README.md index 237070c1e7..18b065b165 100644 --- a/gen/cloudiot1/README.md +++ b/gen/cloudiot1/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Iot* *v1* API can be found at the [official documentation site](https://cloud.google.com/iot). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudiot1/5.0.3+20230102/google_cloudiot1/CloudIot) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudiot1/5.0.3+20230102/google_cloudiot1/CloudIot) ... * projects * [*locations registries bind device to gateway*](https://docs.rs/google-cloudiot1/5.0.3+20230102/google_cloudiot1/api::ProjectLocationRegistryBindDeviceToGatewayCall), [*locations registries create*](https://docs.rs/google-cloudiot1/5.0.3+20230102/google_cloudiot1/api::ProjectLocationRegistryCreateCall), [*locations registries delete*](https://docs.rs/google-cloudiot1/5.0.3+20230102/google_cloudiot1/api::ProjectLocationRegistryDeleteCall), [*locations registries devices config versions list*](https://docs.rs/google-cloudiot1/5.0.3+20230102/google_cloudiot1/api::ProjectLocationRegistryDeviceConfigVersionListCall), [*locations registries devices create*](https://docs.rs/google-cloudiot1/5.0.3+20230102/google_cloudiot1/api::ProjectLocationRegistryDeviceCreateCall), [*locations registries devices delete*](https://docs.rs/google-cloudiot1/5.0.3+20230102/google_cloudiot1/api::ProjectLocationRegistryDeviceDeleteCall), [*locations registries devices get*](https://docs.rs/google-cloudiot1/5.0.3+20230102/google_cloudiot1/api::ProjectLocationRegistryDeviceGetCall), [*locations registries devices list*](https://docs.rs/google-cloudiot1/5.0.3+20230102/google_cloudiot1/api::ProjectLocationRegistryDeviceListCall), [*locations registries devices modify cloud to device config*](https://docs.rs/google-cloudiot1/5.0.3+20230102/google_cloudiot1/api::ProjectLocationRegistryDeviceModifyCloudToDeviceConfigCall), [*locations registries devices patch*](https://docs.rs/google-cloudiot1/5.0.3+20230102/google_cloudiot1/api::ProjectLocationRegistryDevicePatchCall), [*locations registries devices send command to device*](https://docs.rs/google-cloudiot1/5.0.3+20230102/google_cloudiot1/api::ProjectLocationRegistryDeviceSendCommandToDeviceCall), [*locations registries devices states list*](https://docs.rs/google-cloudiot1/5.0.3+20230102/google_cloudiot1/api::ProjectLocationRegistryDeviceStateListCall), [*locations registries get*](https://docs.rs/google-cloudiot1/5.0.3+20230102/google_cloudiot1/api::ProjectLocationRegistryGetCall), [*locations registries get iam policy*](https://docs.rs/google-cloudiot1/5.0.3+20230102/google_cloudiot1/api::ProjectLocationRegistryGetIamPolicyCall), [*locations registries groups devices list*](https://docs.rs/google-cloudiot1/5.0.3+20230102/google_cloudiot1/api::ProjectLocationRegistryGroupDeviceListCall), [*locations registries groups get iam policy*](https://docs.rs/google-cloudiot1/5.0.3+20230102/google_cloudiot1/api::ProjectLocationRegistryGroupGetIamPolicyCall), [*locations registries groups set iam policy*](https://docs.rs/google-cloudiot1/5.0.3+20230102/google_cloudiot1/api::ProjectLocationRegistryGroupSetIamPolicyCall), [*locations registries groups test iam permissions*](https://docs.rs/google-cloudiot1/5.0.3+20230102/google_cloudiot1/api::ProjectLocationRegistryGroupTestIamPermissionCall), [*locations registries list*](https://docs.rs/google-cloudiot1/5.0.3+20230102/google_cloudiot1/api::ProjectLocationRegistryListCall), [*locations registries patch*](https://docs.rs/google-cloudiot1/5.0.3+20230102/google_cloudiot1/api::ProjectLocationRegistryPatchCall), [*locations registries set iam policy*](https://docs.rs/google-cloudiot1/5.0.3+20230102/google_cloudiot1/api::ProjectLocationRegistrySetIamPolicyCall), [*locations registries test iam permissions*](https://docs.rs/google-cloudiot1/5.0.3+20230102/google_cloudiot1/api::ProjectLocationRegistryTestIamPermissionCall) and [*locations registries unbind device from gateway*](https://docs.rs/google-cloudiot1/5.0.3+20230102/google_cloudiot1/api::ProjectLocationRegistryUnbindDeviceFromGatewayCall) @@ -53,8 +53,8 @@ let r = hub.projects().locations_registries_get_iam_policy(...).doit().await let r = hub.projects().locations_registries_set_iam_policy(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -82,12 +82,12 @@ use cloudiot1::{Result, Error}; use std::default::Default; use cloudiot1::{CloudIot, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -128,10 +128,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-cloudiot1/5.0.3+20230102/google_cloudiot1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-cloudiot1/5.0.3+20230102/google_cloudiot1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -141,25 +141,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-cloudi You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudiot1/5.0.3+20230102/google_cloudiot1/client::Delegate) to the -[Method Builder](https://docs.rs/google-cloudiot1/5.0.3+20230102/google_cloudiot1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudiot1/5.0.3+20230102/google_cloudiot1/client::Delegate) to the +[Method Builder](https://docs.rs/google-cloudiot1/5.0.3+20230102/google_cloudiot1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-cloudiot1/5.0.3+20230102/google_cloudiot1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudiot1/5.0.3+20230102/google_cloudiot1/client::RequestValue) and -[decodable](https://docs.rs/google-cloudiot1/5.0.3+20230102/google_cloudiot1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudiot1/5.0.3+20230102/google_cloudiot1/client::RequestValue) and +[decodable](https://docs.rs/google-cloudiot1/5.0.3+20230102/google_cloudiot1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-cloudiot1/5.0.3+20230102/google_cloudiot1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-cloudiot1/5.0.3+20230102/google_cloudiot1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -178,7 +178,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **cloudiot1** library was generated by Sebastian Thiel, and is placed +The **cloudiot1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/cloudiot1/src/api.rs b/gen/cloudiot1/src/api.rs index 7231d58dda..134fba90ce 100644 --- a/gen/cloudiot1/src/api.rs +++ b/gen/cloudiot1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use cloudiot1::{CloudIot, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/cloudiot1/src/lib.rs b/gen/cloudiot1/src/lib.rs index e19cdb1b4d..5134fd3d31 100644 --- a/gen/cloudiot1/src/lib.rs +++ b/gen/cloudiot1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/cloudiot1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudIot) ... +//! Handle the following *Resources* with ease from the central [hub](CloudIot) ... //! //! * projects //! * [*locations registries bind device to gateway*](api::ProjectLocationRegistryBindDeviceToGatewayCall), [*locations registries create*](api::ProjectLocationRegistryCreateCall), [*locations registries delete*](api::ProjectLocationRegistryDeleteCall), [*locations registries devices config versions list*](api::ProjectLocationRegistryDeviceConfigVersionListCall), [*locations registries devices create*](api::ProjectLocationRegistryDeviceCreateCall), [*locations registries devices delete*](api::ProjectLocationRegistryDeviceDeleteCall), [*locations registries devices get*](api::ProjectLocationRegistryDeviceGetCall), [*locations registries devices list*](api::ProjectLocationRegistryDeviceListCall), [*locations registries devices modify cloud to device config*](api::ProjectLocationRegistryDeviceModifyCloudToDeviceConfigCall), [*locations registries devices patch*](api::ProjectLocationRegistryDevicePatchCall), [*locations registries devices send command to device*](api::ProjectLocationRegistryDeviceSendCommandToDeviceCall), [*locations registries devices states list*](api::ProjectLocationRegistryDeviceStateListCall), [*locations registries get*](api::ProjectLocationRegistryGetCall), [*locations registries get iam policy*](api::ProjectLocationRegistryGetIamPolicyCall), [*locations registries groups devices list*](api::ProjectLocationRegistryGroupDeviceListCall), [*locations registries groups get iam policy*](api::ProjectLocationRegistryGroupGetIamPolicyCall), [*locations registries groups set iam policy*](api::ProjectLocationRegistryGroupSetIamPolicyCall), [*locations registries groups test iam permissions*](api::ProjectLocationRegistryGroupTestIamPermissionCall), [*locations registries list*](api::ProjectLocationRegistryListCall), [*locations registries patch*](api::ProjectLocationRegistryPatchCall), [*locations registries set iam policy*](api::ProjectLocationRegistrySetIamPolicyCall), [*locations registries test iam permissions*](api::ProjectLocationRegistryTestIamPermissionCall) and [*locations registries unbind device from gateway*](api::ProjectLocationRegistryUnbindDeviceFromGatewayCall) @@ -53,8 +53,8 @@ //! let r = hub.projects().locations_registries_set_iam_policy(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -83,12 +83,12 @@ //! use std::default::Default; //! use cloudiot1::{CloudIot, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -129,10 +129,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -142,25 +142,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/cloudkms1/README.md b/gen/cloudkms1/README.md index 1875f25221..af516d7222 100644 --- a/gen/cloudkms1/README.md +++ b/gen/cloudkms1/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud KMS* *v1* API can be found at the [official documentation site](https://cloud.google.com/kms/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/CloudKMS) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/CloudKMS) ... * projects * [*locations ekm config get iam policy*](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/api::ProjectLocationEkmConfigGetIamPolicyCall), [*locations ekm config set iam policy*](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/api::ProjectLocationEkmConfigSetIamPolicyCall), [*locations ekm config test iam permissions*](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/api::ProjectLocationEkmConfigTestIamPermissionCall), [*locations ekm connections create*](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/api::ProjectLocationEkmConnectionCreateCall), [*locations ekm connections get*](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/api::ProjectLocationEkmConnectionGetCall), [*locations ekm connections get iam policy*](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/api::ProjectLocationEkmConnectionGetIamPolicyCall), [*locations ekm connections list*](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/api::ProjectLocationEkmConnectionListCall), [*locations ekm connections patch*](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/api::ProjectLocationEkmConnectionPatchCall), [*locations ekm connections set iam policy*](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/api::ProjectLocationEkmConnectionSetIamPolicyCall), [*locations ekm connections test iam permissions*](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/api::ProjectLocationEkmConnectionTestIamPermissionCall), [*locations generate random bytes*](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/api::ProjectLocationGenerateRandomByteCall), [*locations get*](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/api::ProjectLocationGetCall), [*locations key rings create*](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/api::ProjectLocationKeyRingCreateCall), [*locations key rings crypto keys create*](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/api::ProjectLocationKeyRingCryptoKeyCreateCall), [*locations key rings crypto keys crypto key versions asymmetric decrypt*](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/api::ProjectLocationKeyRingCryptoKeyCryptoKeyVersionAsymmetricDecryptCall), [*locations key rings crypto keys crypto key versions asymmetric sign*](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/api::ProjectLocationKeyRingCryptoKeyCryptoKeyVersionAsymmetricSignCall), [*locations key rings crypto keys crypto key versions create*](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/api::ProjectLocationKeyRingCryptoKeyCryptoKeyVersionCreateCall), [*locations key rings crypto keys crypto key versions destroy*](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/api::ProjectLocationKeyRingCryptoKeyCryptoKeyVersionDestroyCall), [*locations key rings crypto keys crypto key versions get*](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/api::ProjectLocationKeyRingCryptoKeyCryptoKeyVersionGetCall), [*locations key rings crypto keys crypto key versions get public key*](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/api::ProjectLocationKeyRingCryptoKeyCryptoKeyVersionGetPublicKeyCall), [*locations key rings crypto keys crypto key versions import*](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/api::ProjectLocationKeyRingCryptoKeyCryptoKeyVersionImportCall), [*locations key rings crypto keys crypto key versions list*](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/api::ProjectLocationKeyRingCryptoKeyCryptoKeyVersionListCall), [*locations key rings crypto keys crypto key versions mac sign*](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/api::ProjectLocationKeyRingCryptoKeyCryptoKeyVersionMacSignCall), [*locations key rings crypto keys crypto key versions mac verify*](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/api::ProjectLocationKeyRingCryptoKeyCryptoKeyVersionMacVerifyCall), [*locations key rings crypto keys crypto key versions patch*](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/api::ProjectLocationKeyRingCryptoKeyCryptoKeyVersionPatchCall), [*locations key rings crypto keys crypto key versions restore*](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/api::ProjectLocationKeyRingCryptoKeyCryptoKeyVersionRestoreCall), [*locations key rings crypto keys decrypt*](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/api::ProjectLocationKeyRingCryptoKeyDecryptCall), [*locations key rings crypto keys encrypt*](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/api::ProjectLocationKeyRingCryptoKeyEncryptCall), [*locations key rings crypto keys get*](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/api::ProjectLocationKeyRingCryptoKeyGetCall), [*locations key rings crypto keys get iam policy*](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/api::ProjectLocationKeyRingCryptoKeyGetIamPolicyCall), [*locations key rings crypto keys list*](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/api::ProjectLocationKeyRingCryptoKeyListCall), [*locations key rings crypto keys patch*](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/api::ProjectLocationKeyRingCryptoKeyPatchCall), [*locations key rings crypto keys set iam policy*](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/api::ProjectLocationKeyRingCryptoKeySetIamPolicyCall), [*locations key rings crypto keys test iam permissions*](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/api::ProjectLocationKeyRingCryptoKeyTestIamPermissionCall), [*locations key rings crypto keys update primary version*](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/api::ProjectLocationKeyRingCryptoKeyUpdatePrimaryVersionCall), [*locations key rings get*](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/api::ProjectLocationKeyRingGetCall), [*locations key rings get iam policy*](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/api::ProjectLocationKeyRingGetIamPolicyCall), [*locations key rings import jobs create*](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/api::ProjectLocationKeyRingImportJobCreateCall), [*locations key rings import jobs get*](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/api::ProjectLocationKeyRingImportJobGetCall), [*locations key rings import jobs get iam policy*](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/api::ProjectLocationKeyRingImportJobGetIamPolicyCall), [*locations key rings import jobs list*](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/api::ProjectLocationKeyRingImportJobListCall), [*locations key rings import jobs set iam policy*](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/api::ProjectLocationKeyRingImportJobSetIamPolicyCall), [*locations key rings import jobs test iam permissions*](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/api::ProjectLocationKeyRingImportJobTestIamPermissionCall), [*locations key rings list*](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/api::ProjectLocationKeyRingListCall), [*locations key rings set iam policy*](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/api::ProjectLocationKeyRingSetIamPolicyCall), [*locations key rings test iam permissions*](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/api::ProjectLocationKeyRingTestIamPermissionCall) and [*locations list*](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/api::ProjectLocationListCall) @@ -59,8 +59,8 @@ let r = hub.projects().locations_key_rings_get_iam_policy(...).doit().await let r = hub.projects().locations_key_rings_set_iam_policy(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -87,12 +87,12 @@ use cloudkms1::{Result, Error}; use std::default::Default; use cloudkms1::{CloudKMS, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -129,10 +129,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -142,25 +142,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-cloudk You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/client::Delegate) to the -[Method Builder](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/client::Delegate) to the +[Method Builder](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/client::RequestValue) and -[decodable](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/client::RequestValue) and +[decodable](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-cloudkms1/5.0.3+20230106/google_cloudkms1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -179,7 +179,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **cloudkms1** library was generated by Sebastian Thiel, and is placed +The **cloudkms1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/cloudkms1/src/api.rs b/gen/cloudkms1/src/api.rs index 5c594b3356..6752f5f6a3 100644 --- a/gen/cloudkms1/src/api.rs +++ b/gen/cloudkms1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -68,12 +68,12 @@ impl Default for Scope { /// use std::default::Default; /// use cloudkms1::{CloudKMS, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/cloudkms1/src/lib.rs b/gen/cloudkms1/src/lib.rs index b70e097a4d..00832ccca3 100644 --- a/gen/cloudkms1/src/lib.rs +++ b/gen/cloudkms1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/cloudkms1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudKMS) ... +//! Handle the following *Resources* with ease from the central [hub](CloudKMS) ... //! //! * projects //! * [*locations ekm config get iam policy*](api::ProjectLocationEkmConfigGetIamPolicyCall), [*locations ekm config set iam policy*](api::ProjectLocationEkmConfigSetIamPolicyCall), [*locations ekm config test iam permissions*](api::ProjectLocationEkmConfigTestIamPermissionCall), [*locations ekm connections create*](api::ProjectLocationEkmConnectionCreateCall), [*locations ekm connections get*](api::ProjectLocationEkmConnectionGetCall), [*locations ekm connections get iam policy*](api::ProjectLocationEkmConnectionGetIamPolicyCall), [*locations ekm connections list*](api::ProjectLocationEkmConnectionListCall), [*locations ekm connections patch*](api::ProjectLocationEkmConnectionPatchCall), [*locations ekm connections set iam policy*](api::ProjectLocationEkmConnectionSetIamPolicyCall), [*locations ekm connections test iam permissions*](api::ProjectLocationEkmConnectionTestIamPermissionCall), [*locations generate random bytes*](api::ProjectLocationGenerateRandomByteCall), [*locations get*](api::ProjectLocationGetCall), [*locations key rings create*](api::ProjectLocationKeyRingCreateCall), [*locations key rings crypto keys create*](api::ProjectLocationKeyRingCryptoKeyCreateCall), [*locations key rings crypto keys crypto key versions asymmetric decrypt*](api::ProjectLocationKeyRingCryptoKeyCryptoKeyVersionAsymmetricDecryptCall), [*locations key rings crypto keys crypto key versions asymmetric sign*](api::ProjectLocationKeyRingCryptoKeyCryptoKeyVersionAsymmetricSignCall), [*locations key rings crypto keys crypto key versions create*](api::ProjectLocationKeyRingCryptoKeyCryptoKeyVersionCreateCall), [*locations key rings crypto keys crypto key versions destroy*](api::ProjectLocationKeyRingCryptoKeyCryptoKeyVersionDestroyCall), [*locations key rings crypto keys crypto key versions get*](api::ProjectLocationKeyRingCryptoKeyCryptoKeyVersionGetCall), [*locations key rings crypto keys crypto key versions get public key*](api::ProjectLocationKeyRingCryptoKeyCryptoKeyVersionGetPublicKeyCall), [*locations key rings crypto keys crypto key versions import*](api::ProjectLocationKeyRingCryptoKeyCryptoKeyVersionImportCall), [*locations key rings crypto keys crypto key versions list*](api::ProjectLocationKeyRingCryptoKeyCryptoKeyVersionListCall), [*locations key rings crypto keys crypto key versions mac sign*](api::ProjectLocationKeyRingCryptoKeyCryptoKeyVersionMacSignCall), [*locations key rings crypto keys crypto key versions mac verify*](api::ProjectLocationKeyRingCryptoKeyCryptoKeyVersionMacVerifyCall), [*locations key rings crypto keys crypto key versions patch*](api::ProjectLocationKeyRingCryptoKeyCryptoKeyVersionPatchCall), [*locations key rings crypto keys crypto key versions restore*](api::ProjectLocationKeyRingCryptoKeyCryptoKeyVersionRestoreCall), [*locations key rings crypto keys decrypt*](api::ProjectLocationKeyRingCryptoKeyDecryptCall), [*locations key rings crypto keys encrypt*](api::ProjectLocationKeyRingCryptoKeyEncryptCall), [*locations key rings crypto keys get*](api::ProjectLocationKeyRingCryptoKeyGetCall), [*locations key rings crypto keys get iam policy*](api::ProjectLocationKeyRingCryptoKeyGetIamPolicyCall), [*locations key rings crypto keys list*](api::ProjectLocationKeyRingCryptoKeyListCall), [*locations key rings crypto keys patch*](api::ProjectLocationKeyRingCryptoKeyPatchCall), [*locations key rings crypto keys set iam policy*](api::ProjectLocationKeyRingCryptoKeySetIamPolicyCall), [*locations key rings crypto keys test iam permissions*](api::ProjectLocationKeyRingCryptoKeyTestIamPermissionCall), [*locations key rings crypto keys update primary version*](api::ProjectLocationKeyRingCryptoKeyUpdatePrimaryVersionCall), [*locations key rings get*](api::ProjectLocationKeyRingGetCall), [*locations key rings get iam policy*](api::ProjectLocationKeyRingGetIamPolicyCall), [*locations key rings import jobs create*](api::ProjectLocationKeyRingImportJobCreateCall), [*locations key rings import jobs get*](api::ProjectLocationKeyRingImportJobGetCall), [*locations key rings import jobs get iam policy*](api::ProjectLocationKeyRingImportJobGetIamPolicyCall), [*locations key rings import jobs list*](api::ProjectLocationKeyRingImportJobListCall), [*locations key rings import jobs set iam policy*](api::ProjectLocationKeyRingImportJobSetIamPolicyCall), [*locations key rings import jobs test iam permissions*](api::ProjectLocationKeyRingImportJobTestIamPermissionCall), [*locations key rings list*](api::ProjectLocationKeyRingListCall), [*locations key rings set iam policy*](api::ProjectLocationKeyRingSetIamPolicyCall), [*locations key rings test iam permissions*](api::ProjectLocationKeyRingTestIamPermissionCall) and [*locations list*](api::ProjectLocationListCall) @@ -59,8 +59,8 @@ //! let r = hub.projects().locations_key_rings_set_iam_policy(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -88,12 +88,12 @@ //! use std::default::Default; //! use cloudkms1::{CloudKMS, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -130,10 +130,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -143,25 +143,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/cloudkms1_beta1/README.md b/gen/cloudkms1_beta1/README.md index bd719b19f6..7fc4f4ac9b 100644 --- a/gen/cloudkms1_beta1/README.md +++ b/gen/cloudkms1_beta1/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud KMS* *v1_beta1* API can be found at the [official documentation site](https://cloud.google.com/kms/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudkms1_beta1/5.0.3+20170515/google_cloudkms1_beta1/CloudKMS) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudkms1_beta1/5.0.3+20170515/google_cloudkms1_beta1/CloudKMS) ... * projects * [*locations get*](https://docs.rs/google-cloudkms1_beta1/5.0.3+20170515/google_cloudkms1_beta1/api::ProjectLocationGetCall), [*locations key rings create*](https://docs.rs/google-cloudkms1_beta1/5.0.3+20170515/google_cloudkms1_beta1/api::ProjectLocationKeyRingCreateCall), [*locations key rings crypto keys create*](https://docs.rs/google-cloudkms1_beta1/5.0.3+20170515/google_cloudkms1_beta1/api::ProjectLocationKeyRingCryptoKeyCreateCall), [*locations key rings crypto keys crypto key versions create*](https://docs.rs/google-cloudkms1_beta1/5.0.3+20170515/google_cloudkms1_beta1/api::ProjectLocationKeyRingCryptoKeyCryptoKeyVersionCreateCall), [*locations key rings crypto keys crypto key versions destroy*](https://docs.rs/google-cloudkms1_beta1/5.0.3+20170515/google_cloudkms1_beta1/api::ProjectLocationKeyRingCryptoKeyCryptoKeyVersionDestroyCall), [*locations key rings crypto keys crypto key versions get*](https://docs.rs/google-cloudkms1_beta1/5.0.3+20170515/google_cloudkms1_beta1/api::ProjectLocationKeyRingCryptoKeyCryptoKeyVersionGetCall), [*locations key rings crypto keys crypto key versions list*](https://docs.rs/google-cloudkms1_beta1/5.0.3+20170515/google_cloudkms1_beta1/api::ProjectLocationKeyRingCryptoKeyCryptoKeyVersionListCall), [*locations key rings crypto keys crypto key versions patch*](https://docs.rs/google-cloudkms1_beta1/5.0.3+20170515/google_cloudkms1_beta1/api::ProjectLocationKeyRingCryptoKeyCryptoKeyVersionPatchCall), [*locations key rings crypto keys crypto key versions restore*](https://docs.rs/google-cloudkms1_beta1/5.0.3+20170515/google_cloudkms1_beta1/api::ProjectLocationKeyRingCryptoKeyCryptoKeyVersionRestoreCall), [*locations key rings crypto keys decrypt*](https://docs.rs/google-cloudkms1_beta1/5.0.3+20170515/google_cloudkms1_beta1/api::ProjectLocationKeyRingCryptoKeyDecryptCall), [*locations key rings crypto keys encrypt*](https://docs.rs/google-cloudkms1_beta1/5.0.3+20170515/google_cloudkms1_beta1/api::ProjectLocationKeyRingCryptoKeyEncryptCall), [*locations key rings crypto keys get*](https://docs.rs/google-cloudkms1_beta1/5.0.3+20170515/google_cloudkms1_beta1/api::ProjectLocationKeyRingCryptoKeyGetCall), [*locations key rings crypto keys get iam policy*](https://docs.rs/google-cloudkms1_beta1/5.0.3+20170515/google_cloudkms1_beta1/api::ProjectLocationKeyRingCryptoKeyGetIamPolicyCall), [*locations key rings crypto keys list*](https://docs.rs/google-cloudkms1_beta1/5.0.3+20170515/google_cloudkms1_beta1/api::ProjectLocationKeyRingCryptoKeyListCall), [*locations key rings crypto keys patch*](https://docs.rs/google-cloudkms1_beta1/5.0.3+20170515/google_cloudkms1_beta1/api::ProjectLocationKeyRingCryptoKeyPatchCall), [*locations key rings crypto keys set iam policy*](https://docs.rs/google-cloudkms1_beta1/5.0.3+20170515/google_cloudkms1_beta1/api::ProjectLocationKeyRingCryptoKeySetIamPolicyCall), [*locations key rings crypto keys test iam permissions*](https://docs.rs/google-cloudkms1_beta1/5.0.3+20170515/google_cloudkms1_beta1/api::ProjectLocationKeyRingCryptoKeyTestIamPermissionCall), [*locations key rings crypto keys update primary version*](https://docs.rs/google-cloudkms1_beta1/5.0.3+20170515/google_cloudkms1_beta1/api::ProjectLocationKeyRingCryptoKeyUpdatePrimaryVersionCall), [*locations key rings get*](https://docs.rs/google-cloudkms1_beta1/5.0.3+20170515/google_cloudkms1_beta1/api::ProjectLocationKeyRingGetCall), [*locations key rings get iam policy*](https://docs.rs/google-cloudkms1_beta1/5.0.3+20170515/google_cloudkms1_beta1/api::ProjectLocationKeyRingGetIamPolicyCall), [*locations key rings list*](https://docs.rs/google-cloudkms1_beta1/5.0.3+20170515/google_cloudkms1_beta1/api::ProjectLocationKeyRingListCall), [*locations key rings set iam policy*](https://docs.rs/google-cloudkms1_beta1/5.0.3+20170515/google_cloudkms1_beta1/api::ProjectLocationKeyRingSetIamPolicyCall), [*locations key rings test iam permissions*](https://docs.rs/google-cloudkms1_beta1/5.0.3+20170515/google_cloudkms1_beta1/api::ProjectLocationKeyRingTestIamPermissionCall) and [*locations list*](https://docs.rs/google-cloudkms1_beta1/5.0.3+20170515/google_cloudkms1_beta1/api::ProjectLocationListCall) @@ -54,8 +54,8 @@ let r = hub.projects().locations_key_rings_crypto_keys_crypto_key_versions_patch let r = hub.projects().locations_key_rings_crypto_keys_crypto_key_versions_get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -83,12 +83,12 @@ use cloudkms1_beta1::{Result, Error}; use std::default::Default; use cloudkms1_beta1::{CloudKMS, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -130,10 +130,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-cloudkms1_beta1/5.0.3+20170515/google_cloudkms1_beta1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-cloudkms1_beta1/5.0.3+20170515/google_cloudkms1_beta1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -143,25 +143,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-cloudk You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudkms1_beta1/5.0.3+20170515/google_cloudkms1_beta1/client::Delegate) to the -[Method Builder](https://docs.rs/google-cloudkms1_beta1/5.0.3+20170515/google_cloudkms1_beta1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudkms1_beta1/5.0.3+20170515/google_cloudkms1_beta1/client::Delegate) to the +[Method Builder](https://docs.rs/google-cloudkms1_beta1/5.0.3+20170515/google_cloudkms1_beta1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-cloudkms1_beta1/5.0.3+20170515/google_cloudkms1_beta1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudkms1_beta1/5.0.3+20170515/google_cloudkms1_beta1/client::RequestValue) and -[decodable](https://docs.rs/google-cloudkms1_beta1/5.0.3+20170515/google_cloudkms1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudkms1_beta1/5.0.3+20170515/google_cloudkms1_beta1/client::RequestValue) and +[decodable](https://docs.rs/google-cloudkms1_beta1/5.0.3+20170515/google_cloudkms1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-cloudkms1_beta1/5.0.3+20170515/google_cloudkms1_beta1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-cloudkms1_beta1/5.0.3+20170515/google_cloudkms1_beta1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -180,7 +180,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **cloudkms1_beta1** library was generated by Sebastian Thiel, and is placed +The **cloudkms1_beta1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/cloudkms1_beta1/src/api.rs b/gen/cloudkms1_beta1/src/api.rs index df7b3cb2b1..30cc637a91 100644 --- a/gen/cloudkms1_beta1/src/api.rs +++ b/gen/cloudkms1_beta1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your data across Google Cloud Platform services CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use cloudkms1_beta1::{CloudKMS, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/cloudkms1_beta1/src/lib.rs b/gen/cloudkms1_beta1/src/lib.rs index 16e7b5fa00..6716d9c859 100644 --- a/gen/cloudkms1_beta1/src/lib.rs +++ b/gen/cloudkms1_beta1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/cloudkms1_beta1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudKMS) ... +//! Handle the following *Resources* with ease from the central [hub](CloudKMS) ... //! //! * projects //! * [*locations get*](api::ProjectLocationGetCall), [*locations key rings create*](api::ProjectLocationKeyRingCreateCall), [*locations key rings crypto keys create*](api::ProjectLocationKeyRingCryptoKeyCreateCall), [*locations key rings crypto keys crypto key versions create*](api::ProjectLocationKeyRingCryptoKeyCryptoKeyVersionCreateCall), [*locations key rings crypto keys crypto key versions destroy*](api::ProjectLocationKeyRingCryptoKeyCryptoKeyVersionDestroyCall), [*locations key rings crypto keys crypto key versions get*](api::ProjectLocationKeyRingCryptoKeyCryptoKeyVersionGetCall), [*locations key rings crypto keys crypto key versions list*](api::ProjectLocationKeyRingCryptoKeyCryptoKeyVersionListCall), [*locations key rings crypto keys crypto key versions patch*](api::ProjectLocationKeyRingCryptoKeyCryptoKeyVersionPatchCall), [*locations key rings crypto keys crypto key versions restore*](api::ProjectLocationKeyRingCryptoKeyCryptoKeyVersionRestoreCall), [*locations key rings crypto keys decrypt*](api::ProjectLocationKeyRingCryptoKeyDecryptCall), [*locations key rings crypto keys encrypt*](api::ProjectLocationKeyRingCryptoKeyEncryptCall), [*locations key rings crypto keys get*](api::ProjectLocationKeyRingCryptoKeyGetCall), [*locations key rings crypto keys get iam policy*](api::ProjectLocationKeyRingCryptoKeyGetIamPolicyCall), [*locations key rings crypto keys list*](api::ProjectLocationKeyRingCryptoKeyListCall), [*locations key rings crypto keys patch*](api::ProjectLocationKeyRingCryptoKeyPatchCall), [*locations key rings crypto keys set iam policy*](api::ProjectLocationKeyRingCryptoKeySetIamPolicyCall), [*locations key rings crypto keys test iam permissions*](api::ProjectLocationKeyRingCryptoKeyTestIamPermissionCall), [*locations key rings crypto keys update primary version*](api::ProjectLocationKeyRingCryptoKeyUpdatePrimaryVersionCall), [*locations key rings get*](api::ProjectLocationKeyRingGetCall), [*locations key rings get iam policy*](api::ProjectLocationKeyRingGetIamPolicyCall), [*locations key rings list*](api::ProjectLocationKeyRingListCall), [*locations key rings set iam policy*](api::ProjectLocationKeyRingSetIamPolicyCall), [*locations key rings test iam permissions*](api::ProjectLocationKeyRingTestIamPermissionCall) and [*locations list*](api::ProjectLocationListCall) @@ -54,8 +54,8 @@ //! let r = hub.projects().locations_key_rings_crypto_keys_crypto_key_versions_get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -84,12 +84,12 @@ //! use std::default::Default; //! use cloudkms1_beta1::{CloudKMS, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -131,10 +131,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -144,25 +144,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/cloudlatencytest2/README.md b/gen/cloudlatencytest2/README.md index afc322be50..1343cc72ef 100644 --- a/gen/cloudlatencytest2/README.md +++ b/gen/cloudlatencytest2/README.md @@ -8,7 +8,7 @@ The `google-cloudlatencytest2` library allows access to all features of the *Goo This documentation was generated from *cloudlatencytest* crate version *5.0.3+20160309*, where *20160309* is the exact revision of the *cloudlatencytest:v2* schema built by the [mako](http://www.makotemplates.org/) code generator *v5.0.3*. # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudlatencytest2/5.0.3+20160309/google_cloudlatencytest2/Cloudlatencytest) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudlatencytest2/5.0.3+20160309/google_cloudlatencytest2/Cloudlatencytest) ... * statscollection * [*updateaggregatedstats*](https://docs.rs/google-cloudlatencytest2/5.0.3+20160309/google_cloudlatencytest2/api::StatscollectionUpdateaggregatedstatCall) and [*updatestats*](https://docs.rs/google-cloudlatencytest2/5.0.3+20160309/google_cloudlatencytest2/api::StatscollectionUpdatestatCall) @@ -47,8 +47,8 @@ Or specifically ... let r = hub.statscollection().updatestats(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -76,12 +76,12 @@ use cloudlatencytest2::{Result, Error}; use std::default::Default; use cloudlatencytest2::{Cloudlatencytest, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -122,10 +122,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-cloudlatencytest2/5.0.3+20160309/google_cloudlatencytest2/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-cloudlatencytest2/5.0.3+20160309/google_cloudlatencytest2/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -135,25 +135,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-cloudl You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudlatencytest2/5.0.3+20160309/google_cloudlatencytest2/client::Delegate) to the -[Method Builder](https://docs.rs/google-cloudlatencytest2/5.0.3+20160309/google_cloudlatencytest2/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudlatencytest2/5.0.3+20160309/google_cloudlatencytest2/client::Delegate) to the +[Method Builder](https://docs.rs/google-cloudlatencytest2/5.0.3+20160309/google_cloudlatencytest2/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-cloudlatencytest2/5.0.3+20160309/google_cloudlatencytest2/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudlatencytest2/5.0.3+20160309/google_cloudlatencytest2/client::RequestValue) and -[decodable](https://docs.rs/google-cloudlatencytest2/5.0.3+20160309/google_cloudlatencytest2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudlatencytest2/5.0.3+20160309/google_cloudlatencytest2/client::RequestValue) and +[decodable](https://docs.rs/google-cloudlatencytest2/5.0.3+20160309/google_cloudlatencytest2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-cloudlatencytest2/5.0.3+20160309/google_cloudlatencytest2/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-cloudlatencytest2/5.0.3+20160309/google_cloudlatencytest2/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -172,7 +172,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **cloudlatencytest2** library was generated by Sebastian Thiel, and is placed +The **cloudlatencytest2** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/cloudlatencytest2/src/api.rs b/gen/cloudlatencytest2/src/api.rs index 2afa07e0bb..14f27e44bf 100644 --- a/gen/cloudlatencytest2/src/api.rs +++ b/gen/cloudlatencytest2/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View monitoring data for all of your Google Cloud and API projects MonitoringReadonly, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use cloudlatencytest2::{Cloudlatencytest, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/cloudlatencytest2/src/lib.rs b/gen/cloudlatencytest2/src/lib.rs index 0c72a4a024..067b1e15d2 100644 --- a/gen/cloudlatencytest2/src/lib.rs +++ b/gen/cloudlatencytest2/src/lib.rs @@ -6,7 +6,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/cloudlatencytest2). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Cloudlatencytest) ... +//! Handle the following *Resources* with ease from the central [hub](Cloudlatencytest) ... //! //! * statscollection //! * [*updateaggregatedstats*](api::StatscollectionUpdateaggregatedstatCall) and [*updatestats*](api::StatscollectionUpdatestatCall) @@ -47,8 +47,8 @@ //! let r = hub.statscollection().updatestats(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -77,12 +77,12 @@ //! use std::default::Default; //! use cloudlatencytest2::{Cloudlatencytest, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -123,10 +123,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -136,25 +136,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/cloudmonitoring2_beta2/README.md b/gen/cloudmonitoring2_beta2/README.md index 360b9e49ba..a94bf4c681 100644 --- a/gen/cloudmonitoring2_beta2/README.md +++ b/gen/cloudmonitoring2_beta2/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Monitoring* *v2_beta2* API can be found at the [official documentation site](https://cloud.google.com/monitoring/v2beta2/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudmonitoring2_beta2/5.0.3+20170501/google_cloudmonitoring2_beta2/CloudMonitoring) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudmonitoring2_beta2/5.0.3+20170501/google_cloudmonitoring2_beta2/CloudMonitoring) ... * [metric descriptors](https://docs.rs/google-cloudmonitoring2_beta2/5.0.3+20170501/google_cloudmonitoring2_beta2/api::MetricDescriptor) * [*create*](https://docs.rs/google-cloudmonitoring2_beta2/5.0.3+20170501/google_cloudmonitoring2_beta2/api::MetricDescriptorCreateCall), [*delete*](https://docs.rs/google-cloudmonitoring2_beta2/5.0.3+20170501/google_cloudmonitoring2_beta2/api::MetricDescriptorDeleteCall) and [*list*](https://docs.rs/google-cloudmonitoring2_beta2/5.0.3+20170501/google_cloudmonitoring2_beta2/api::MetricDescriptorListCall) @@ -56,8 +56,8 @@ let r = hub.metric_descriptors().delete(...).doit().await let r = hub.metric_descriptors().list(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -85,12 +85,12 @@ use cloudmonitoring2_beta2::{Result, Error}; use std::default::Default; use cloudmonitoring2_beta2::{CloudMonitoring, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -134,10 +134,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-cloudmonitoring2_beta2/5.0.3+20170501/google_cloudmonitoring2_beta2/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-cloudmonitoring2_beta2/5.0.3+20170501/google_cloudmonitoring2_beta2/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -147,25 +147,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-cloudm You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudmonitoring2_beta2/5.0.3+20170501/google_cloudmonitoring2_beta2/client::Delegate) to the -[Method Builder](https://docs.rs/google-cloudmonitoring2_beta2/5.0.3+20170501/google_cloudmonitoring2_beta2/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudmonitoring2_beta2/5.0.3+20170501/google_cloudmonitoring2_beta2/client::Delegate) to the +[Method Builder](https://docs.rs/google-cloudmonitoring2_beta2/5.0.3+20170501/google_cloudmonitoring2_beta2/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-cloudmonitoring2_beta2/5.0.3+20170501/google_cloudmonitoring2_beta2/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudmonitoring2_beta2/5.0.3+20170501/google_cloudmonitoring2_beta2/client::RequestValue) and -[decodable](https://docs.rs/google-cloudmonitoring2_beta2/5.0.3+20170501/google_cloudmonitoring2_beta2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudmonitoring2_beta2/5.0.3+20170501/google_cloudmonitoring2_beta2/client::RequestValue) and +[decodable](https://docs.rs/google-cloudmonitoring2_beta2/5.0.3+20170501/google_cloudmonitoring2_beta2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-cloudmonitoring2_beta2/5.0.3+20170501/google_cloudmonitoring2_beta2/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-cloudmonitoring2_beta2/5.0.3+20170501/google_cloudmonitoring2_beta2/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -184,7 +184,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **cloudmonitoring2_beta2** library was generated by Sebastian Thiel, and is placed +The **cloudmonitoring2_beta2** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/cloudmonitoring2_beta2/src/api.rs b/gen/cloudmonitoring2_beta2/src/api.rs index 81cfd14ae8..9f2691152d 100644 --- a/gen/cloudmonitoring2_beta2/src/api.rs +++ b/gen/cloudmonitoring2_beta2/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your data across Google Cloud Platform services CloudPlatform, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use cloudmonitoring2_beta2::{CloudMonitoring, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/cloudmonitoring2_beta2/src/lib.rs b/gen/cloudmonitoring2_beta2/src/lib.rs index c41c5e98d6..cab1b9ee6a 100644 --- a/gen/cloudmonitoring2_beta2/src/lib.rs +++ b/gen/cloudmonitoring2_beta2/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/cloudmonitoring2_beta2). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudMonitoring) ... +//! Handle the following *Resources* with ease from the central [hub](CloudMonitoring) ... //! //! * [metric descriptors](api::MetricDescriptor) //! * [*create*](api::MetricDescriptorCreateCall), [*delete*](api::MetricDescriptorDeleteCall) and [*list*](api::MetricDescriptorListCall) @@ -56,8 +56,8 @@ //! let r = hub.metric_descriptors().list(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -86,12 +86,12 @@ //! use std::default::Default; //! use cloudmonitoring2_beta2::{CloudMonitoring, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -135,10 +135,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -148,25 +148,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/cloudprivatecatalog1_beta1/README.md b/gen/cloudprivatecatalog1_beta1/README.md index 213f6431ef..64341d2f34 100644 --- a/gen/cloudprivatecatalog1_beta1/README.md +++ b/gen/cloudprivatecatalog1_beta1/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Private Catalog* *v1_beta1* API can be found at [official documentation site](https://cloud.google.com/private-catalog/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudprivatecatalog1_beta1/5.0.3+20200405/google_cloudprivatecatalog1_beta1/CloudPrivateCatalog) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudprivatecatalog1_beta1/5.0.3+20200405/google_cloudprivatecatalog1_beta1/CloudPrivateCatalog) ... * folders * [*catalogs search*](https://docs.rs/google-cloudprivatecatalog1_beta1/5.0.3+20200405/google_cloudprivatecatalog1_beta1/api::FolderCatalogSearchCall), [*products search*](https://docs.rs/google-cloudprivatecatalog1_beta1/5.0.3+20200405/google_cloudprivatecatalog1_beta1/api::FolderProductSearchCall) and [*versions search*](https://docs.rs/google-cloudprivatecatalog1_beta1/5.0.3+20200405/google_cloudprivatecatalog1_beta1/api::FolderVersionSearchCall) @@ -56,8 +56,8 @@ let r = hub.organizations().catalogs_search(...).doit().await let r = hub.projects().catalogs_search(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -84,12 +84,12 @@ use cloudprivatecatalog1_beta1::{Result, Error}; use std::default::Default; use cloudprivatecatalog1_beta1::{CloudPrivateCatalog, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -128,10 +128,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-cloudprivatecatalog1_beta1/5.0.3+20200405/google_cloudprivatecatalog1_beta1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-cloudprivatecatalog1_beta1/5.0.3+20200405/google_cloudprivatecatalog1_beta1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -141,25 +141,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-cloudp You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudprivatecatalog1_beta1/5.0.3+20200405/google_cloudprivatecatalog1_beta1/client::Delegate) to the -[Method Builder](https://docs.rs/google-cloudprivatecatalog1_beta1/5.0.3+20200405/google_cloudprivatecatalog1_beta1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudprivatecatalog1_beta1/5.0.3+20200405/google_cloudprivatecatalog1_beta1/client::Delegate) to the +[Method Builder](https://docs.rs/google-cloudprivatecatalog1_beta1/5.0.3+20200405/google_cloudprivatecatalog1_beta1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-cloudprivatecatalog1_beta1/5.0.3+20200405/google_cloudprivatecatalog1_beta1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudprivatecatalog1_beta1/5.0.3+20200405/google_cloudprivatecatalog1_beta1/client::RequestValue) and -[decodable](https://docs.rs/google-cloudprivatecatalog1_beta1/5.0.3+20200405/google_cloudprivatecatalog1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudprivatecatalog1_beta1/5.0.3+20200405/google_cloudprivatecatalog1_beta1/client::RequestValue) and +[decodable](https://docs.rs/google-cloudprivatecatalog1_beta1/5.0.3+20200405/google_cloudprivatecatalog1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-cloudprivatecatalog1_beta1/5.0.3+20200405/google_cloudprivatecatalog1_beta1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-cloudprivatecatalog1_beta1/5.0.3+20200405/google_cloudprivatecatalog1_beta1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -178,7 +178,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **cloudprivatecatalog1_beta1** library was generated by Sebastian Thiel, and is placed +The **cloudprivatecatalog1_beta1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/cloudprivatecatalog1_beta1/src/api.rs b/gen/cloudprivatecatalog1_beta1/src/api.rs index cafdff97fd..ac28b67016 100644 --- a/gen/cloudprivatecatalog1_beta1/src/api.rs +++ b/gen/cloudprivatecatalog1_beta1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your data across Google Cloud Platform services CloudPlatform, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use cloudprivatecatalog1_beta1::{CloudPrivateCatalog, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/cloudprivatecatalog1_beta1/src/lib.rs b/gen/cloudprivatecatalog1_beta1/src/lib.rs index a89b34367f..b649b3b939 100644 --- a/gen/cloudprivatecatalog1_beta1/src/lib.rs +++ b/gen/cloudprivatecatalog1_beta1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/cloudprivatecatalog1_beta1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudPrivateCatalog) ... +//! Handle the following *Resources* with ease from the central [hub](CloudPrivateCatalog) ... //! //! * folders //! * [*catalogs search*](api::FolderCatalogSearchCall), [*products search*](api::FolderProductSearchCall) and [*versions search*](api::FolderVersionSearchCall) @@ -56,8 +56,8 @@ //! let r = hub.projects().catalogs_search(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -85,12 +85,12 @@ //! use std::default::Default; //! use cloudprivatecatalog1_beta1::{CloudPrivateCatalog, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -129,10 +129,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -142,25 +142,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/cloudprivatecatalogproducer1_beta1/README.md b/gen/cloudprivatecatalogproducer1_beta1/README.md index e1b863fd14..4d64ce699a 100644 --- a/gen/cloudprivatecatalogproducer1_beta1/README.md +++ b/gen/cloudprivatecatalogproducer1_beta1/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud PrivateCatalog Producer* *v1_beta1* API can be [official documentation site](https://cloud.google.com/private-catalog/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudprivatecatalogproducer1_beta1/5.0.3+20200405/google_cloudprivatecatalogproducer1_beta1/CloudPrivateCatalogProducer) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudprivatecatalogproducer1_beta1/5.0.3+20200405/google_cloudprivatecatalogproducer1_beta1/CloudPrivateCatalogProducer) ... * catalogs * [*associations create*](https://docs.rs/google-cloudprivatecatalogproducer1_beta1/5.0.3+20200405/google_cloudprivatecatalogproducer1_beta1/api::CatalogAssociationCreateCall), [*associations delete*](https://docs.rs/google-cloudprivatecatalogproducer1_beta1/5.0.3+20200405/google_cloudprivatecatalogproducer1_beta1/api::CatalogAssociationDeleteCall), [*associations get*](https://docs.rs/google-cloudprivatecatalogproducer1_beta1/5.0.3+20200405/google_cloudprivatecatalogproducer1_beta1/api::CatalogAssociationGetCall), [*associations list*](https://docs.rs/google-cloudprivatecatalogproducer1_beta1/5.0.3+20200405/google_cloudprivatecatalogproducer1_beta1/api::CatalogAssociationListCall), [*create*](https://docs.rs/google-cloudprivatecatalogproducer1_beta1/5.0.3+20200405/google_cloudprivatecatalogproducer1_beta1/api::CatalogCreateCall), [*delete*](https://docs.rs/google-cloudprivatecatalogproducer1_beta1/5.0.3+20200405/google_cloudprivatecatalogproducer1_beta1/api::CatalogDeleteCall), [*get*](https://docs.rs/google-cloudprivatecatalogproducer1_beta1/5.0.3+20200405/google_cloudprivatecatalogproducer1_beta1/api::CatalogGetCall), [*get iam policy*](https://docs.rs/google-cloudprivatecatalogproducer1_beta1/5.0.3+20200405/google_cloudprivatecatalogproducer1_beta1/api::CatalogGetIamPolicyCall), [*list*](https://docs.rs/google-cloudprivatecatalogproducer1_beta1/5.0.3+20200405/google_cloudprivatecatalogproducer1_beta1/api::CatalogListCall), [*patch*](https://docs.rs/google-cloudprivatecatalogproducer1_beta1/5.0.3+20200405/google_cloudprivatecatalogproducer1_beta1/api::CatalogPatchCall), [*products copy*](https://docs.rs/google-cloudprivatecatalogproducer1_beta1/5.0.3+20200405/google_cloudprivatecatalogproducer1_beta1/api::CatalogProductCopyCall), [*products create*](https://docs.rs/google-cloudprivatecatalogproducer1_beta1/5.0.3+20200405/google_cloudprivatecatalogproducer1_beta1/api::CatalogProductCreateCall), [*products delete*](https://docs.rs/google-cloudprivatecatalogproducer1_beta1/5.0.3+20200405/google_cloudprivatecatalogproducer1_beta1/api::CatalogProductDeleteCall), [*products get*](https://docs.rs/google-cloudprivatecatalogproducer1_beta1/5.0.3+20200405/google_cloudprivatecatalogproducer1_beta1/api::CatalogProductGetCall), [*products icons upload*](https://docs.rs/google-cloudprivatecatalogproducer1_beta1/5.0.3+20200405/google_cloudprivatecatalogproducer1_beta1/api::CatalogProductIconUploadCall), [*products list*](https://docs.rs/google-cloudprivatecatalogproducer1_beta1/5.0.3+20200405/google_cloudprivatecatalogproducer1_beta1/api::CatalogProductListCall), [*products patch*](https://docs.rs/google-cloudprivatecatalogproducer1_beta1/5.0.3+20200405/google_cloudprivatecatalogproducer1_beta1/api::CatalogProductPatchCall), [*products versions create*](https://docs.rs/google-cloudprivatecatalogproducer1_beta1/5.0.3+20200405/google_cloudprivatecatalogproducer1_beta1/api::CatalogProductVersionCreateCall), [*products versions delete*](https://docs.rs/google-cloudprivatecatalogproducer1_beta1/5.0.3+20200405/google_cloudprivatecatalogproducer1_beta1/api::CatalogProductVersionDeleteCall), [*products versions get*](https://docs.rs/google-cloudprivatecatalogproducer1_beta1/5.0.3+20200405/google_cloudprivatecatalogproducer1_beta1/api::CatalogProductVersionGetCall), [*products versions list*](https://docs.rs/google-cloudprivatecatalogproducer1_beta1/5.0.3+20200405/google_cloudprivatecatalogproducer1_beta1/api::CatalogProductVersionListCall), [*products versions patch*](https://docs.rs/google-cloudprivatecatalogproducer1_beta1/5.0.3+20200405/google_cloudprivatecatalogproducer1_beta1/api::CatalogProductVersionPatchCall), [*set iam policy*](https://docs.rs/google-cloudprivatecatalogproducer1_beta1/5.0.3+20200405/google_cloudprivatecatalogproducer1_beta1/api::CatalogSetIamPolicyCall), [*test iam permissions*](https://docs.rs/google-cloudprivatecatalogproducer1_beta1/5.0.3+20200405/google_cloudprivatecatalogproducer1_beta1/api::CatalogTestIamPermissionCall) and [*undelete*](https://docs.rs/google-cloudprivatecatalogproducer1_beta1/5.0.3+20200405/google_cloudprivatecatalogproducer1_beta1/api::CatalogUndeleteCall) @@ -57,8 +57,8 @@ let r = hub.operations().cancel(...).doit().await let r = hub.operations().delete(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -86,12 +86,12 @@ use cloudprivatecatalogproducer1_beta1::{Result, Error}; use std::default::Default; use cloudprivatecatalogproducer1_beta1::{CloudPrivateCatalogProducer, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -132,10 +132,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-cloudprivatecatalogproducer1_beta1/5.0.3+20200405/google_cloudprivatecatalogproducer1_beta1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-cloudprivatecatalogproducer1_beta1/5.0.3+20200405/google_cloudprivatecatalogproducer1_beta1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -145,25 +145,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-cloudp You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudprivatecatalogproducer1_beta1/5.0.3+20200405/google_cloudprivatecatalogproducer1_beta1/client::Delegate) to the -[Method Builder](https://docs.rs/google-cloudprivatecatalogproducer1_beta1/5.0.3+20200405/google_cloudprivatecatalogproducer1_beta1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudprivatecatalogproducer1_beta1/5.0.3+20200405/google_cloudprivatecatalogproducer1_beta1/client::Delegate) to the +[Method Builder](https://docs.rs/google-cloudprivatecatalogproducer1_beta1/5.0.3+20200405/google_cloudprivatecatalogproducer1_beta1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-cloudprivatecatalogproducer1_beta1/5.0.3+20200405/google_cloudprivatecatalogproducer1_beta1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudprivatecatalogproducer1_beta1/5.0.3+20200405/google_cloudprivatecatalogproducer1_beta1/client::RequestValue) and -[decodable](https://docs.rs/google-cloudprivatecatalogproducer1_beta1/5.0.3+20200405/google_cloudprivatecatalogproducer1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudprivatecatalogproducer1_beta1/5.0.3+20200405/google_cloudprivatecatalogproducer1_beta1/client::RequestValue) and +[decodable](https://docs.rs/google-cloudprivatecatalogproducer1_beta1/5.0.3+20200405/google_cloudprivatecatalogproducer1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-cloudprivatecatalogproducer1_beta1/5.0.3+20200405/google_cloudprivatecatalogproducer1_beta1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-cloudprivatecatalogproducer1_beta1/5.0.3+20200405/google_cloudprivatecatalogproducer1_beta1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -182,7 +182,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **cloudprivatecatalogproducer1_beta1** library was generated by Sebastian Thiel, and is placed +The **cloudprivatecatalogproducer1_beta1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/cloudprivatecatalogproducer1_beta1/src/api.rs b/gen/cloudprivatecatalogproducer1_beta1/src/api.rs index 77297df10e..596d81c46c 100644 --- a/gen/cloudprivatecatalogproducer1_beta1/src/api.rs +++ b/gen/cloudprivatecatalogproducer1_beta1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your data across Google Cloud Platform services CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use cloudprivatecatalogproducer1_beta1::{CloudPrivateCatalogProducer, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/cloudprivatecatalogproducer1_beta1/src/lib.rs b/gen/cloudprivatecatalogproducer1_beta1/src/lib.rs index 3d36b822ac..2b29a85108 100644 --- a/gen/cloudprivatecatalogproducer1_beta1/src/lib.rs +++ b/gen/cloudprivatecatalogproducer1_beta1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/cloudprivatecatalogproducer1_beta1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudPrivateCatalogProducer) ... +//! Handle the following *Resources* with ease from the central [hub](CloudPrivateCatalogProducer) ... //! //! * catalogs //! * [*associations create*](api::CatalogAssociationCreateCall), [*associations delete*](api::CatalogAssociationDeleteCall), [*associations get*](api::CatalogAssociationGetCall), [*associations list*](api::CatalogAssociationListCall), [*create*](api::CatalogCreateCall), [*delete*](api::CatalogDeleteCall), [*get*](api::CatalogGetCall), [*get iam policy*](api::CatalogGetIamPolicyCall), [*list*](api::CatalogListCall), [*patch*](api::CatalogPatchCall), [*products copy*](api::CatalogProductCopyCall), [*products create*](api::CatalogProductCreateCall), [*products delete*](api::CatalogProductDeleteCall), [*products get*](api::CatalogProductGetCall), [*products icons upload*](api::CatalogProductIconUploadCall), [*products list*](api::CatalogProductListCall), [*products patch*](api::CatalogProductPatchCall), [*products versions create*](api::CatalogProductVersionCreateCall), [*products versions delete*](api::CatalogProductVersionDeleteCall), [*products versions get*](api::CatalogProductVersionGetCall), [*products versions list*](api::CatalogProductVersionListCall), [*products versions patch*](api::CatalogProductVersionPatchCall), [*set iam policy*](api::CatalogSetIamPolicyCall), [*test iam permissions*](api::CatalogTestIamPermissionCall) and [*undelete*](api::CatalogUndeleteCall) @@ -57,8 +57,8 @@ //! let r = hub.operations().delete(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -87,12 +87,12 @@ //! use std::default::Default; //! use cloudprivatecatalogproducer1_beta1::{CloudPrivateCatalogProducer, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -133,10 +133,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -146,25 +146,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/cloudprofiler2/README.md b/gen/cloudprofiler2/README.md index a2b76ea749..3a709d9faf 100644 --- a/gen/cloudprofiler2/README.md +++ b/gen/cloudprofiler2/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Profiler* *v2* API can be found at the [official documentation site](https://cloud.google.com/profiler/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudprofiler2/5.0.3+20230123/google_cloudprofiler2/CloudProfiler) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudprofiler2/5.0.3+20230123/google_cloudprofiler2/CloudProfiler) ... * projects * [*profiles create*](https://docs.rs/google-cloudprofiler2/5.0.3+20230123/google_cloudprofiler2/api::ProjectProfileCreateCall), [*profiles create offline*](https://docs.rs/google-cloudprofiler2/5.0.3+20230123/google_cloudprofiler2/api::ProjectProfileCreateOfflineCall) and [*profiles patch*](https://docs.rs/google-cloudprofiler2/5.0.3+20230123/google_cloudprofiler2/api::ProjectProfilePatchCall) @@ -52,8 +52,8 @@ let r = hub.projects().profiles_create_offline(...).doit().await let r = hub.projects().profiles_patch(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -81,12 +81,12 @@ use cloudprofiler2::{Result, Error}; use std::default::Default; use cloudprofiler2::{CloudProfiler, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -128,10 +128,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-cloudprofiler2/5.0.3+20230123/google_cloudprofiler2/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-cloudprofiler2/5.0.3+20230123/google_cloudprofiler2/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -141,25 +141,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-cloudp You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudprofiler2/5.0.3+20230123/google_cloudprofiler2/client::Delegate) to the -[Method Builder](https://docs.rs/google-cloudprofiler2/5.0.3+20230123/google_cloudprofiler2/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudprofiler2/5.0.3+20230123/google_cloudprofiler2/client::Delegate) to the +[Method Builder](https://docs.rs/google-cloudprofiler2/5.0.3+20230123/google_cloudprofiler2/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-cloudprofiler2/5.0.3+20230123/google_cloudprofiler2/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudprofiler2/5.0.3+20230123/google_cloudprofiler2/client::RequestValue) and -[decodable](https://docs.rs/google-cloudprofiler2/5.0.3+20230123/google_cloudprofiler2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudprofiler2/5.0.3+20230123/google_cloudprofiler2/client::RequestValue) and +[decodable](https://docs.rs/google-cloudprofiler2/5.0.3+20230123/google_cloudprofiler2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-cloudprofiler2/5.0.3+20230123/google_cloudprofiler2/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-cloudprofiler2/5.0.3+20230123/google_cloudprofiler2/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -178,7 +178,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **cloudprofiler2** library was generated by Sebastian Thiel, and is placed +The **cloudprofiler2** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/cloudprofiler2/src/api.rs b/gen/cloudprofiler2/src/api.rs index 83a5b5cccb..e13d77ad1e 100644 --- a/gen/cloudprofiler2/src/api.rs +++ b/gen/cloudprofiler2/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -73,12 +73,12 @@ impl Default for Scope { /// use std::default::Default; /// use cloudprofiler2::{CloudProfiler, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/cloudprofiler2/src/lib.rs b/gen/cloudprofiler2/src/lib.rs index 3f11ae639d..5d03b405d8 100644 --- a/gen/cloudprofiler2/src/lib.rs +++ b/gen/cloudprofiler2/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/cloudprofiler2). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudProfiler) ... +//! Handle the following *Resources* with ease from the central [hub](CloudProfiler) ... //! //! * projects //! * [*profiles create*](api::ProjectProfileCreateCall), [*profiles create offline*](api::ProjectProfileCreateOfflineCall) and [*profiles patch*](api::ProjectProfilePatchCall) @@ -52,8 +52,8 @@ //! let r = hub.projects().profiles_patch(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -82,12 +82,12 @@ //! use std::default::Default; //! use cloudprofiler2::{CloudProfiler, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -129,10 +129,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -142,25 +142,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/cloudresourcemanager1/README.md b/gen/cloudresourcemanager1/README.md index b0392c7e14..89c27d58c2 100644 --- a/gen/cloudresourcemanager1/README.md +++ b/gen/cloudresourcemanager1/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Resource Manager* *v1* API can be found at the [official documentation site](https://cloud.google.com/resource-manager). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudresourcemanager1/5.0.3+20230115/google_cloudresourcemanager1/CloudResourceManager) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudresourcemanager1/5.0.3+20230115/google_cloudresourcemanager1/CloudResourceManager) ... * folders * [*clear org policy*](https://docs.rs/google-cloudresourcemanager1/5.0.3+20230115/google_cloudresourcemanager1/api::FolderClearOrgPolicyCall), [*get effective org policy*](https://docs.rs/google-cloudresourcemanager1/5.0.3+20230115/google_cloudresourcemanager1/api::FolderGetEffectiveOrgPolicyCall), [*get org policy*](https://docs.rs/google-cloudresourcemanager1/5.0.3+20230115/google_cloudresourcemanager1/api::FolderGetOrgPolicyCall), [*list available org policy constraints*](https://docs.rs/google-cloudresourcemanager1/5.0.3+20230115/google_cloudresourcemanager1/api::FolderListAvailableOrgPolicyConstraintCall), [*list org policies*](https://docs.rs/google-cloudresourcemanager1/5.0.3+20230115/google_cloudresourcemanager1/api::FolderListOrgPolicyCall) and [*set org policy*](https://docs.rs/google-cloudresourcemanager1/5.0.3+20230115/google_cloudresourcemanager1/api::FolderSetOrgPolicyCall) @@ -73,8 +73,8 @@ let r = hub.projects().undelete(...).doit().await let r = hub.projects().update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -101,12 +101,12 @@ use cloudresourcemanager1::{Result, Error}; use std::default::Default; use cloudresourcemanager1::{CloudResourceManager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -145,10 +145,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-cloudresourcemanager1/5.0.3+20230115/google_cloudresourcemanager1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-cloudresourcemanager1/5.0.3+20230115/google_cloudresourcemanager1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -158,25 +158,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-cloudr You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudresourcemanager1/5.0.3+20230115/google_cloudresourcemanager1/client::Delegate) to the -[Method Builder](https://docs.rs/google-cloudresourcemanager1/5.0.3+20230115/google_cloudresourcemanager1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudresourcemanager1/5.0.3+20230115/google_cloudresourcemanager1/client::Delegate) to the +[Method Builder](https://docs.rs/google-cloudresourcemanager1/5.0.3+20230115/google_cloudresourcemanager1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-cloudresourcemanager1/5.0.3+20230115/google_cloudresourcemanager1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudresourcemanager1/5.0.3+20230115/google_cloudresourcemanager1/client::RequestValue) and -[decodable](https://docs.rs/google-cloudresourcemanager1/5.0.3+20230115/google_cloudresourcemanager1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudresourcemanager1/5.0.3+20230115/google_cloudresourcemanager1/client::RequestValue) and +[decodable](https://docs.rs/google-cloudresourcemanager1/5.0.3+20230115/google_cloudresourcemanager1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-cloudresourcemanager1/5.0.3+20230115/google_cloudresourcemanager1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-cloudresourcemanager1/5.0.3+20230115/google_cloudresourcemanager1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -195,7 +195,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **cloudresourcemanager1** library was generated by Sebastian Thiel, and is placed +The **cloudresourcemanager1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/cloudresourcemanager1/src/api.rs b/gen/cloudresourcemanager1/src/api.rs index 07863f90e5..831cf759c2 100644 --- a/gen/cloudresourcemanager1/src/api.rs +++ b/gen/cloudresourcemanager1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -68,12 +68,12 @@ impl Default for Scope { /// use std::default::Default; /// use cloudresourcemanager1::{CloudResourceManager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/cloudresourcemanager1/src/lib.rs b/gen/cloudresourcemanager1/src/lib.rs index 5273fe87dd..1a80c7de25 100644 --- a/gen/cloudresourcemanager1/src/lib.rs +++ b/gen/cloudresourcemanager1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/cloudresourcemanager1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudResourceManager) ... +//! Handle the following *Resources* with ease from the central [hub](CloudResourceManager) ... //! //! * folders //! * [*clear org policy*](api::FolderClearOrgPolicyCall), [*get effective org policy*](api::FolderGetEffectiveOrgPolicyCall), [*get org policy*](api::FolderGetOrgPolicyCall), [*list available org policy constraints*](api::FolderListAvailableOrgPolicyConstraintCall), [*list org policies*](api::FolderListOrgPolicyCall) and [*set org policy*](api::FolderSetOrgPolicyCall) @@ -73,8 +73,8 @@ //! let r = hub.projects().update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -102,12 +102,12 @@ //! use std::default::Default; //! use cloudresourcemanager1::{CloudResourceManager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -146,10 +146,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -159,25 +159,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/cloudresourcemanager1_beta1/README.md b/gen/cloudresourcemanager1_beta1/README.md index 4a5776c42f..dc04dce9ea 100644 --- a/gen/cloudresourcemanager1_beta1/README.md +++ b/gen/cloudresourcemanager1_beta1/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Resource Manager* *v1_beta1* API can be found a [official documentation site](https://cloud.google.com/resource-manager). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudresourcemanager1_beta1/5.0.3+20230115/google_cloudresourcemanager1_beta1/CloudResourceManager) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudresourcemanager1_beta1/5.0.3+20230115/google_cloudresourcemanager1_beta1/CloudResourceManager) ... * [organizations](https://docs.rs/google-cloudresourcemanager1_beta1/5.0.3+20230115/google_cloudresourcemanager1_beta1/api::Organization) * [*get*](https://docs.rs/google-cloudresourcemanager1_beta1/5.0.3+20230115/google_cloudresourcemanager1_beta1/api::OrganizationGetCall), [*get iam policy*](https://docs.rs/google-cloudresourcemanager1_beta1/5.0.3+20230115/google_cloudresourcemanager1_beta1/api::OrganizationGetIamPolicyCall), [*list*](https://docs.rs/google-cloudresourcemanager1_beta1/5.0.3+20230115/google_cloudresourcemanager1_beta1/api::OrganizationListCall), [*set iam policy*](https://docs.rs/google-cloudresourcemanager1_beta1/5.0.3+20230115/google_cloudresourcemanager1_beta1/api::OrganizationSetIamPolicyCall), [*test iam permissions*](https://docs.rs/google-cloudresourcemanager1_beta1/5.0.3+20230115/google_cloudresourcemanager1_beta1/api::OrganizationTestIamPermissionCall) and [*update*](https://docs.rs/google-cloudresourcemanager1_beta1/5.0.3+20230115/google_cloudresourcemanager1_beta1/api::OrganizationUpdateCall) @@ -61,8 +61,8 @@ let r = hub.projects().undelete(...).doit().await let r = hub.projects().update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -89,12 +89,12 @@ use cloudresourcemanager1_beta1::{Result, Error}; use std::default::Default; use cloudresourcemanager1_beta1::{CloudResourceManager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -133,10 +133,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-cloudresourcemanager1_beta1/5.0.3+20230115/google_cloudresourcemanager1_beta1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-cloudresourcemanager1_beta1/5.0.3+20230115/google_cloudresourcemanager1_beta1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -146,25 +146,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-cloudr You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudresourcemanager1_beta1/5.0.3+20230115/google_cloudresourcemanager1_beta1/client::Delegate) to the -[Method Builder](https://docs.rs/google-cloudresourcemanager1_beta1/5.0.3+20230115/google_cloudresourcemanager1_beta1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudresourcemanager1_beta1/5.0.3+20230115/google_cloudresourcemanager1_beta1/client::Delegate) to the +[Method Builder](https://docs.rs/google-cloudresourcemanager1_beta1/5.0.3+20230115/google_cloudresourcemanager1_beta1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-cloudresourcemanager1_beta1/5.0.3+20230115/google_cloudresourcemanager1_beta1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudresourcemanager1_beta1/5.0.3+20230115/google_cloudresourcemanager1_beta1/client::RequestValue) and -[decodable](https://docs.rs/google-cloudresourcemanager1_beta1/5.0.3+20230115/google_cloudresourcemanager1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudresourcemanager1_beta1/5.0.3+20230115/google_cloudresourcemanager1_beta1/client::RequestValue) and +[decodable](https://docs.rs/google-cloudresourcemanager1_beta1/5.0.3+20230115/google_cloudresourcemanager1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-cloudresourcemanager1_beta1/5.0.3+20230115/google_cloudresourcemanager1_beta1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-cloudresourcemanager1_beta1/5.0.3+20230115/google_cloudresourcemanager1_beta1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -183,7 +183,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **cloudresourcemanager1_beta1** library was generated by Sebastian Thiel, and is placed +The **cloudresourcemanager1_beta1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/cloudresourcemanager1_beta1/src/api.rs b/gen/cloudresourcemanager1_beta1/src/api.rs index a82e6fc33e..5b9852a08c 100644 --- a/gen/cloudresourcemanager1_beta1/src/api.rs +++ b/gen/cloudresourcemanager1_beta1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -68,12 +68,12 @@ impl Default for Scope { /// use std::default::Default; /// use cloudresourcemanager1_beta1::{CloudResourceManager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/cloudresourcemanager1_beta1/src/lib.rs b/gen/cloudresourcemanager1_beta1/src/lib.rs index 90d44f4eb5..69a34baa0b 100644 --- a/gen/cloudresourcemanager1_beta1/src/lib.rs +++ b/gen/cloudresourcemanager1_beta1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/cloudresourcemanager1_beta1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudResourceManager) ... +//! Handle the following *Resources* with ease from the central [hub](CloudResourceManager) ... //! //! * [organizations](api::Organization) //! * [*get*](api::OrganizationGetCall), [*get iam policy*](api::OrganizationGetIamPolicyCall), [*list*](api::OrganizationListCall), [*set iam policy*](api::OrganizationSetIamPolicyCall), [*test iam permissions*](api::OrganizationTestIamPermissionCall) and [*update*](api::OrganizationUpdateCall) @@ -61,8 +61,8 @@ //! let r = hub.projects().update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -90,12 +90,12 @@ //! use std::default::Default; //! use cloudresourcemanager1_beta1::{CloudResourceManager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -134,10 +134,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -147,25 +147,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/cloudresourcemanager2/README.md b/gen/cloudresourcemanager2/README.md index 150f875325..94d7413719 100644 --- a/gen/cloudresourcemanager2/README.md +++ b/gen/cloudresourcemanager2/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Resource Manager* *v2* API can be found at the [official documentation site](https://cloud.google.com/resource-manager). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudresourcemanager2/5.0.3+20230115/google_cloudresourcemanager2/CloudResourceManager) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudresourcemanager2/5.0.3+20230115/google_cloudresourcemanager2/CloudResourceManager) ... * [folders](https://docs.rs/google-cloudresourcemanager2/5.0.3+20230115/google_cloudresourcemanager2/api::Folder) * [*create*](https://docs.rs/google-cloudresourcemanager2/5.0.3+20230115/google_cloudresourcemanager2/api::FolderCreateCall), [*delete*](https://docs.rs/google-cloudresourcemanager2/5.0.3+20230115/google_cloudresourcemanager2/api::FolderDeleteCall), [*get*](https://docs.rs/google-cloudresourcemanager2/5.0.3+20230115/google_cloudresourcemanager2/api::FolderGetCall), [*get iam policy*](https://docs.rs/google-cloudresourcemanager2/5.0.3+20230115/google_cloudresourcemanager2/api::FolderGetIamPolicyCall), [*list*](https://docs.rs/google-cloudresourcemanager2/5.0.3+20230115/google_cloudresourcemanager2/api::FolderListCall), [*move*](https://docs.rs/google-cloudresourcemanager2/5.0.3+20230115/google_cloudresourcemanager2/api::FolderMoveCall), [*patch*](https://docs.rs/google-cloudresourcemanager2/5.0.3+20230115/google_cloudresourcemanager2/api::FolderPatchCall), [*search*](https://docs.rs/google-cloudresourcemanager2/5.0.3+20230115/google_cloudresourcemanager2/api::FolderSearchCall), [*set iam policy*](https://docs.rs/google-cloudresourcemanager2/5.0.3+20230115/google_cloudresourcemanager2/api::FolderSetIamPolicyCall), [*test iam permissions*](https://docs.rs/google-cloudresourcemanager2/5.0.3+20230115/google_cloudresourcemanager2/api::FolderTestIamPermissionCall) and [*undelete*](https://docs.rs/google-cloudresourcemanager2/5.0.3+20230115/google_cloudresourcemanager2/api::FolderUndeleteCall) @@ -62,8 +62,8 @@ let r = hub.folders().test_iam_permissions(...).doit().await let r = hub.folders().undelete(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -90,12 +90,12 @@ use cloudresourcemanager2::{Result, Error}; use std::default::Default; use cloudresourcemanager2::{CloudResourceManager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -135,10 +135,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-cloudresourcemanager2/5.0.3+20230115/google_cloudresourcemanager2/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-cloudresourcemanager2/5.0.3+20230115/google_cloudresourcemanager2/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -148,25 +148,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-cloudr You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudresourcemanager2/5.0.3+20230115/google_cloudresourcemanager2/client::Delegate) to the -[Method Builder](https://docs.rs/google-cloudresourcemanager2/5.0.3+20230115/google_cloudresourcemanager2/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudresourcemanager2/5.0.3+20230115/google_cloudresourcemanager2/client::Delegate) to the +[Method Builder](https://docs.rs/google-cloudresourcemanager2/5.0.3+20230115/google_cloudresourcemanager2/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-cloudresourcemanager2/5.0.3+20230115/google_cloudresourcemanager2/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudresourcemanager2/5.0.3+20230115/google_cloudresourcemanager2/client::RequestValue) and -[decodable](https://docs.rs/google-cloudresourcemanager2/5.0.3+20230115/google_cloudresourcemanager2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudresourcemanager2/5.0.3+20230115/google_cloudresourcemanager2/client::RequestValue) and +[decodable](https://docs.rs/google-cloudresourcemanager2/5.0.3+20230115/google_cloudresourcemanager2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-cloudresourcemanager2/5.0.3+20230115/google_cloudresourcemanager2/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-cloudresourcemanager2/5.0.3+20230115/google_cloudresourcemanager2/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -185,7 +185,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **cloudresourcemanager2** library was generated by Sebastian Thiel, and is placed +The **cloudresourcemanager2** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/cloudresourcemanager2/src/api.rs b/gen/cloudresourcemanager2/src/api.rs index fa3ff46105..ff9050bd13 100644 --- a/gen/cloudresourcemanager2/src/api.rs +++ b/gen/cloudresourcemanager2/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -68,12 +68,12 @@ impl Default for Scope { /// use std::default::Default; /// use cloudresourcemanager2::{CloudResourceManager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/cloudresourcemanager2/src/lib.rs b/gen/cloudresourcemanager2/src/lib.rs index 07bdaa466d..096b74b721 100644 --- a/gen/cloudresourcemanager2/src/lib.rs +++ b/gen/cloudresourcemanager2/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/cloudresourcemanager2). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudResourceManager) ... +//! Handle the following *Resources* with ease from the central [hub](CloudResourceManager) ... //! //! * [folders](api::Folder) //! * [*create*](api::FolderCreateCall), [*delete*](api::FolderDeleteCall), [*get*](api::FolderGetCall), [*get iam policy*](api::FolderGetIamPolicyCall), [*list*](api::FolderListCall), [*move*](api::FolderMoveCall), [*patch*](api::FolderPatchCall), [*search*](api::FolderSearchCall), [*set iam policy*](api::FolderSetIamPolicyCall), [*test iam permissions*](api::FolderTestIamPermissionCall) and [*undelete*](api::FolderUndeleteCall) @@ -62,8 +62,8 @@ //! let r = hub.folders().undelete(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -91,12 +91,12 @@ //! use std::default::Default; //! use cloudresourcemanager2::{CloudResourceManager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -136,10 +136,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -149,25 +149,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/cloudresourcemanager3/README.md b/gen/cloudresourcemanager3/README.md index c62a17a842..e28bd58140 100644 --- a/gen/cloudresourcemanager3/README.md +++ b/gen/cloudresourcemanager3/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Resource Manager* *v3* API can be found at the [official documentation site](https://cloud.google.com/resource-manager). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudresourcemanager3/5.0.3+20230115/google_cloudresourcemanager3/CloudResourceManager) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudresourcemanager3/5.0.3+20230115/google_cloudresourcemanager3/CloudResourceManager) ... * [effective tags](https://docs.rs/google-cloudresourcemanager3/5.0.3+20230115/google_cloudresourcemanager3/api::EffectiveTag) * [*list*](https://docs.rs/google-cloudresourcemanager3/5.0.3+20230115/google_cloudresourcemanager3/api::EffectiveTagListCall) @@ -86,8 +86,8 @@ let r = hub.tag_values().delete(...).doit().await let r = hub.tag_values().patch(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -115,12 +115,12 @@ use cloudresourcemanager3::{Result, Error}; use std::default::Default; use cloudresourcemanager3::{CloudResourceManager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -163,10 +163,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-cloudresourcemanager3/5.0.3+20230115/google_cloudresourcemanager3/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-cloudresourcemanager3/5.0.3+20230115/google_cloudresourcemanager3/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -176,25 +176,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-cloudr You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudresourcemanager3/5.0.3+20230115/google_cloudresourcemanager3/client::Delegate) to the -[Method Builder](https://docs.rs/google-cloudresourcemanager3/5.0.3+20230115/google_cloudresourcemanager3/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudresourcemanager3/5.0.3+20230115/google_cloudresourcemanager3/client::Delegate) to the +[Method Builder](https://docs.rs/google-cloudresourcemanager3/5.0.3+20230115/google_cloudresourcemanager3/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-cloudresourcemanager3/5.0.3+20230115/google_cloudresourcemanager3/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudresourcemanager3/5.0.3+20230115/google_cloudresourcemanager3/client::RequestValue) and -[decodable](https://docs.rs/google-cloudresourcemanager3/5.0.3+20230115/google_cloudresourcemanager3/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudresourcemanager3/5.0.3+20230115/google_cloudresourcemanager3/client::RequestValue) and +[decodable](https://docs.rs/google-cloudresourcemanager3/5.0.3+20230115/google_cloudresourcemanager3/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-cloudresourcemanager3/5.0.3+20230115/google_cloudresourcemanager3/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-cloudresourcemanager3/5.0.3+20230115/google_cloudresourcemanager3/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -213,7 +213,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **cloudresourcemanager3** library was generated by Sebastian Thiel, and is placed +The **cloudresourcemanager3** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/cloudresourcemanager3/src/api.rs b/gen/cloudresourcemanager3/src/api.rs index 375769085c..a158042d4c 100644 --- a/gen/cloudresourcemanager3/src/api.rs +++ b/gen/cloudresourcemanager3/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use cloudresourcemanager3::{CloudResourceManager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/cloudresourcemanager3/src/lib.rs b/gen/cloudresourcemanager3/src/lib.rs index b6f6ff2759..1bb07d9e44 100644 --- a/gen/cloudresourcemanager3/src/lib.rs +++ b/gen/cloudresourcemanager3/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/cloudresourcemanager3). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudResourceManager) ... +//! Handle the following *Resources* with ease from the central [hub](CloudResourceManager) ... //! //! * [effective tags](api::EffectiveTag) //! * [*list*](api::EffectiveTagListCall) @@ -86,8 +86,8 @@ //! let r = hub.tag_values().patch(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -116,12 +116,12 @@ //! use std::default::Default; //! use cloudresourcemanager3::{CloudResourceManager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -164,10 +164,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -177,25 +177,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/cloudscheduler1/README.md b/gen/cloudscheduler1/README.md index acee8e32ad..b6049ebf7e 100644 --- a/gen/cloudscheduler1/README.md +++ b/gen/cloudscheduler1/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Scheduler* *v1* API can be found at the [official documentation site](https://cloud.google.com/scheduler/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudscheduler1/5.0.3+20230106/google_cloudscheduler1/CloudScheduler) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudscheduler1/5.0.3+20230106/google_cloudscheduler1/CloudScheduler) ... * projects * [*locations get*](https://docs.rs/google-cloudscheduler1/5.0.3+20230106/google_cloudscheduler1/api::ProjectLocationGetCall), [*locations jobs create*](https://docs.rs/google-cloudscheduler1/5.0.3+20230106/google_cloudscheduler1/api::ProjectLocationJobCreateCall), [*locations jobs delete*](https://docs.rs/google-cloudscheduler1/5.0.3+20230106/google_cloudscheduler1/api::ProjectLocationJobDeleteCall), [*locations jobs get*](https://docs.rs/google-cloudscheduler1/5.0.3+20230106/google_cloudscheduler1/api::ProjectLocationJobGetCall), [*locations jobs list*](https://docs.rs/google-cloudscheduler1/5.0.3+20230106/google_cloudscheduler1/api::ProjectLocationJobListCall), [*locations jobs patch*](https://docs.rs/google-cloudscheduler1/5.0.3+20230106/google_cloudscheduler1/api::ProjectLocationJobPatchCall), [*locations jobs pause*](https://docs.rs/google-cloudscheduler1/5.0.3+20230106/google_cloudscheduler1/api::ProjectLocationJobPauseCall), [*locations jobs resume*](https://docs.rs/google-cloudscheduler1/5.0.3+20230106/google_cloudscheduler1/api::ProjectLocationJobResumeCall), [*locations jobs run*](https://docs.rs/google-cloudscheduler1/5.0.3+20230106/google_cloudscheduler1/api::ProjectLocationJobRunCall) and [*locations list*](https://docs.rs/google-cloudscheduler1/5.0.3+20230106/google_cloudscheduler1/api::ProjectLocationListCall) @@ -55,8 +55,8 @@ let r = hub.projects().locations_jobs_resume(...).doit().await let r = hub.projects().locations_jobs_run(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -84,12 +84,12 @@ use cloudscheduler1::{Result, Error}; use std::default::Default; use cloudscheduler1::{CloudScheduler, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -131,10 +131,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-cloudscheduler1/5.0.3+20230106/google_cloudscheduler1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-cloudscheduler1/5.0.3+20230106/google_cloudscheduler1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -144,25 +144,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-clouds You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudscheduler1/5.0.3+20230106/google_cloudscheduler1/client::Delegate) to the -[Method Builder](https://docs.rs/google-cloudscheduler1/5.0.3+20230106/google_cloudscheduler1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudscheduler1/5.0.3+20230106/google_cloudscheduler1/client::Delegate) to the +[Method Builder](https://docs.rs/google-cloudscheduler1/5.0.3+20230106/google_cloudscheduler1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-cloudscheduler1/5.0.3+20230106/google_cloudscheduler1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudscheduler1/5.0.3+20230106/google_cloudscheduler1/client::RequestValue) and -[decodable](https://docs.rs/google-cloudscheduler1/5.0.3+20230106/google_cloudscheduler1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudscheduler1/5.0.3+20230106/google_cloudscheduler1/client::RequestValue) and +[decodable](https://docs.rs/google-cloudscheduler1/5.0.3+20230106/google_cloudscheduler1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-cloudscheduler1/5.0.3+20230106/google_cloudscheduler1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-cloudscheduler1/5.0.3+20230106/google_cloudscheduler1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -181,7 +181,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **cloudscheduler1** library was generated by Sebastian Thiel, and is placed +The **cloudscheduler1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/cloudscheduler1/src/api.rs b/gen/cloudscheduler1/src/api.rs index fb834e0b54..c1c6d76569 100644 --- a/gen/cloudscheduler1/src/api.rs +++ b/gen/cloudscheduler1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use cloudscheduler1::{CloudScheduler, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/cloudscheduler1/src/lib.rs b/gen/cloudscheduler1/src/lib.rs index 3c2e0549d7..03df15edc7 100644 --- a/gen/cloudscheduler1/src/lib.rs +++ b/gen/cloudscheduler1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/cloudscheduler1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudScheduler) ... +//! Handle the following *Resources* with ease from the central [hub](CloudScheduler) ... //! //! * projects //! * [*locations get*](api::ProjectLocationGetCall), [*locations jobs create*](api::ProjectLocationJobCreateCall), [*locations jobs delete*](api::ProjectLocationJobDeleteCall), [*locations jobs get*](api::ProjectLocationJobGetCall), [*locations jobs list*](api::ProjectLocationJobListCall), [*locations jobs patch*](api::ProjectLocationJobPatchCall), [*locations jobs pause*](api::ProjectLocationJobPauseCall), [*locations jobs resume*](api::ProjectLocationJobResumeCall), [*locations jobs run*](api::ProjectLocationJobRunCall) and [*locations list*](api::ProjectLocationListCall) @@ -55,8 +55,8 @@ //! let r = hub.projects().locations_jobs_run(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -85,12 +85,12 @@ //! use std::default::Default; //! use cloudscheduler1::{CloudScheduler, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -132,10 +132,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -145,25 +145,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/cloudscheduler1_beta1/README.md b/gen/cloudscheduler1_beta1/README.md index cc1ba7fcfe..c793491295 100644 --- a/gen/cloudscheduler1_beta1/README.md +++ b/gen/cloudscheduler1_beta1/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Scheduler* *v1_beta1* API can be found at the [official documentation site](https://cloud.google.com/scheduler/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudscheduler1_beta1/5.0.3+20230106/google_cloudscheduler1_beta1/CloudScheduler) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudscheduler1_beta1/5.0.3+20230106/google_cloudscheduler1_beta1/CloudScheduler) ... * projects * [*locations get*](https://docs.rs/google-cloudscheduler1_beta1/5.0.3+20230106/google_cloudscheduler1_beta1/api::ProjectLocationGetCall), [*locations jobs create*](https://docs.rs/google-cloudscheduler1_beta1/5.0.3+20230106/google_cloudscheduler1_beta1/api::ProjectLocationJobCreateCall), [*locations jobs delete*](https://docs.rs/google-cloudscheduler1_beta1/5.0.3+20230106/google_cloudscheduler1_beta1/api::ProjectLocationJobDeleteCall), [*locations jobs get*](https://docs.rs/google-cloudscheduler1_beta1/5.0.3+20230106/google_cloudscheduler1_beta1/api::ProjectLocationJobGetCall), [*locations jobs list*](https://docs.rs/google-cloudscheduler1_beta1/5.0.3+20230106/google_cloudscheduler1_beta1/api::ProjectLocationJobListCall), [*locations jobs patch*](https://docs.rs/google-cloudscheduler1_beta1/5.0.3+20230106/google_cloudscheduler1_beta1/api::ProjectLocationJobPatchCall), [*locations jobs pause*](https://docs.rs/google-cloudscheduler1_beta1/5.0.3+20230106/google_cloudscheduler1_beta1/api::ProjectLocationJobPauseCall), [*locations jobs resume*](https://docs.rs/google-cloudscheduler1_beta1/5.0.3+20230106/google_cloudscheduler1_beta1/api::ProjectLocationJobResumeCall), [*locations jobs run*](https://docs.rs/google-cloudscheduler1_beta1/5.0.3+20230106/google_cloudscheduler1_beta1/api::ProjectLocationJobRunCall) and [*locations list*](https://docs.rs/google-cloudscheduler1_beta1/5.0.3+20230106/google_cloudscheduler1_beta1/api::ProjectLocationListCall) @@ -55,8 +55,8 @@ let r = hub.projects().locations_jobs_resume(...).doit().await let r = hub.projects().locations_jobs_run(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -84,12 +84,12 @@ use cloudscheduler1_beta1::{Result, Error}; use std::default::Default; use cloudscheduler1_beta1::{CloudScheduler, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -131,10 +131,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-cloudscheduler1_beta1/5.0.3+20230106/google_cloudscheduler1_beta1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-cloudscheduler1_beta1/5.0.3+20230106/google_cloudscheduler1_beta1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -144,25 +144,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-clouds You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudscheduler1_beta1/5.0.3+20230106/google_cloudscheduler1_beta1/client::Delegate) to the -[Method Builder](https://docs.rs/google-cloudscheduler1_beta1/5.0.3+20230106/google_cloudscheduler1_beta1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudscheduler1_beta1/5.0.3+20230106/google_cloudscheduler1_beta1/client::Delegate) to the +[Method Builder](https://docs.rs/google-cloudscheduler1_beta1/5.0.3+20230106/google_cloudscheduler1_beta1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-cloudscheduler1_beta1/5.0.3+20230106/google_cloudscheduler1_beta1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudscheduler1_beta1/5.0.3+20230106/google_cloudscheduler1_beta1/client::RequestValue) and -[decodable](https://docs.rs/google-cloudscheduler1_beta1/5.0.3+20230106/google_cloudscheduler1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudscheduler1_beta1/5.0.3+20230106/google_cloudscheduler1_beta1/client::RequestValue) and +[decodable](https://docs.rs/google-cloudscheduler1_beta1/5.0.3+20230106/google_cloudscheduler1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-cloudscheduler1_beta1/5.0.3+20230106/google_cloudscheduler1_beta1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-cloudscheduler1_beta1/5.0.3+20230106/google_cloudscheduler1_beta1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -181,7 +181,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **cloudscheduler1_beta1** library was generated by Sebastian Thiel, and is placed +The **cloudscheduler1_beta1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/cloudscheduler1_beta1/src/api.rs b/gen/cloudscheduler1_beta1/src/api.rs index 536063c03f..631c18674f 100644 --- a/gen/cloudscheduler1_beta1/src/api.rs +++ b/gen/cloudscheduler1_beta1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use cloudscheduler1_beta1::{CloudScheduler, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/cloudscheduler1_beta1/src/lib.rs b/gen/cloudscheduler1_beta1/src/lib.rs index 1fe32409f8..b94439fd37 100644 --- a/gen/cloudscheduler1_beta1/src/lib.rs +++ b/gen/cloudscheduler1_beta1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/cloudscheduler1_beta1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudScheduler) ... +//! Handle the following *Resources* with ease from the central [hub](CloudScheduler) ... //! //! * projects //! * [*locations get*](api::ProjectLocationGetCall), [*locations jobs create*](api::ProjectLocationJobCreateCall), [*locations jobs delete*](api::ProjectLocationJobDeleteCall), [*locations jobs get*](api::ProjectLocationJobGetCall), [*locations jobs list*](api::ProjectLocationJobListCall), [*locations jobs patch*](api::ProjectLocationJobPatchCall), [*locations jobs pause*](api::ProjectLocationJobPauseCall), [*locations jobs resume*](api::ProjectLocationJobResumeCall), [*locations jobs run*](api::ProjectLocationJobRunCall) and [*locations list*](api::ProjectLocationListCall) @@ -55,8 +55,8 @@ //! let r = hub.projects().locations_jobs_run(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -85,12 +85,12 @@ //! use std::default::Default; //! use cloudscheduler1_beta1::{CloudScheduler, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -132,10 +132,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -145,25 +145,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/cloudshell1/README.md b/gen/cloudshell1/README.md index 1bd0471de5..32950e939c 100644 --- a/gen/cloudshell1/README.md +++ b/gen/cloudshell1/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Shell* *v1* API can be found at the [official documentation site](https://cloud.google.com/shell/docs/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudshell1/5.0.3+20230109/google_cloudshell1/CloudShell) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudshell1/5.0.3+20230109/google_cloudshell1/CloudShell) ... * [operations](https://docs.rs/google-cloudshell1/5.0.3+20230109/google_cloudshell1/api::Operation) * [*cancel*](https://docs.rs/google-cloudshell1/5.0.3+20230109/google_cloudshell1/api::OperationCancelCall), [*delete*](https://docs.rs/google-cloudshell1/5.0.3+20230109/google_cloudshell1/api::OperationDeleteCall), [*get*](https://docs.rs/google-cloudshell1/5.0.3+20230109/google_cloudshell1/api::OperationGetCall) and [*list*](https://docs.rs/google-cloudshell1/5.0.3+20230109/google_cloudshell1/api::OperationListCall) @@ -59,8 +59,8 @@ let r = hub.users().environments_remove_public_key(...).doit().await let r = hub.users().environments_start(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -87,12 +87,12 @@ use cloudshell1::{Result, Error}; use std::default::Default; use cloudshell1::{CloudShell, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -131,10 +131,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-cloudshell1/5.0.3+20230109/google_cloudshell1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-cloudshell1/5.0.3+20230109/google_cloudshell1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -144,25 +144,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-clouds You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudshell1/5.0.3+20230109/google_cloudshell1/client::Delegate) to the -[Method Builder](https://docs.rs/google-cloudshell1/5.0.3+20230109/google_cloudshell1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudshell1/5.0.3+20230109/google_cloudshell1/client::Delegate) to the +[Method Builder](https://docs.rs/google-cloudshell1/5.0.3+20230109/google_cloudshell1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-cloudshell1/5.0.3+20230109/google_cloudshell1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudshell1/5.0.3+20230109/google_cloudshell1/client::RequestValue) and -[decodable](https://docs.rs/google-cloudshell1/5.0.3+20230109/google_cloudshell1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudshell1/5.0.3+20230109/google_cloudshell1/client::RequestValue) and +[decodable](https://docs.rs/google-cloudshell1/5.0.3+20230109/google_cloudshell1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-cloudshell1/5.0.3+20230109/google_cloudshell1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-cloudshell1/5.0.3+20230109/google_cloudshell1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -181,7 +181,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **cloudshell1** library was generated by Sebastian Thiel, and is placed +The **cloudshell1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/cloudshell1/src/api.rs b/gen/cloudshell1/src/api.rs index 0283aed739..7496c2b651 100644 --- a/gen/cloudshell1/src/api.rs +++ b/gen/cloudshell1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use cloudshell1::{CloudShell, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/cloudshell1/src/lib.rs b/gen/cloudshell1/src/lib.rs index 103c46586c..d96a29ecd3 100644 --- a/gen/cloudshell1/src/lib.rs +++ b/gen/cloudshell1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/cloudshell1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudShell) ... +//! Handle the following *Resources* with ease from the central [hub](CloudShell) ... //! //! * [operations](api::Operation) //! * [*cancel*](api::OperationCancelCall), [*delete*](api::OperationDeleteCall), [*get*](api::OperationGetCall) and [*list*](api::OperationListCall) @@ -59,8 +59,8 @@ //! let r = hub.users().environments_start(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -88,12 +88,12 @@ //! use std::default::Default; //! use cloudshell1::{CloudShell, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -132,10 +132,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -145,25 +145,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/cloudsupport2_beta/README.md b/gen/cloudsupport2_beta/README.md index 444e8752d6..e60ecfcf32 100644 --- a/gen/cloudsupport2_beta/README.md +++ b/gen/cloudsupport2_beta/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Support* *v2_beta* API can be found at the [official documentation site](https://cloud.google.com/support/docs/apis). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudsupport2_beta/5.0.3+20230121/google_cloudsupport2_beta/CloudSupport) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudsupport2_beta/5.0.3+20230121/google_cloudsupport2_beta/CloudSupport) ... * [attachments](https://docs.rs/google-cloudsupport2_beta/5.0.3+20230121/google_cloudsupport2_beta/api::Attachment) * [*create*](https://docs.rs/google-cloudsupport2_beta/5.0.3+20230121/google_cloudsupport2_beta/api::AttachmentCreateCall) @@ -73,8 +73,8 @@ let r = hub.cases().patch(...).doit().await let r = hub.cases().search(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -101,12 +101,12 @@ use cloudsupport2_beta::{Result, Error}; use std::default::Default; use cloudsupport2_beta::{CloudSupport, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -145,10 +145,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-cloudsupport2_beta/5.0.3+20230121/google_cloudsupport2_beta/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-cloudsupport2_beta/5.0.3+20230121/google_cloudsupport2_beta/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -158,25 +158,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-clouds You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudsupport2_beta/5.0.3+20230121/google_cloudsupport2_beta/client::Delegate) to the -[Method Builder](https://docs.rs/google-cloudsupport2_beta/5.0.3+20230121/google_cloudsupport2_beta/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudsupport2_beta/5.0.3+20230121/google_cloudsupport2_beta/client::Delegate) to the +[Method Builder](https://docs.rs/google-cloudsupport2_beta/5.0.3+20230121/google_cloudsupport2_beta/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-cloudsupport2_beta/5.0.3+20230121/google_cloudsupport2_beta/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudsupport2_beta/5.0.3+20230121/google_cloudsupport2_beta/client::RequestValue) and -[decodable](https://docs.rs/google-cloudsupport2_beta/5.0.3+20230121/google_cloudsupport2_beta/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudsupport2_beta/5.0.3+20230121/google_cloudsupport2_beta/client::RequestValue) and +[decodable](https://docs.rs/google-cloudsupport2_beta/5.0.3+20230121/google_cloudsupport2_beta/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-cloudsupport2_beta/5.0.3+20230121/google_cloudsupport2_beta/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-cloudsupport2_beta/5.0.3+20230121/google_cloudsupport2_beta/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -195,7 +195,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **cloudsupport2_beta** library was generated by Sebastian Thiel, and is placed +The **cloudsupport2_beta** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/cloudsupport2_beta/src/api.rs b/gen/cloudsupport2_beta/src/api.rs index 067bb7016b..b218f40dbf 100644 --- a/gen/cloudsupport2_beta/src/api.rs +++ b/gen/cloudsupport2_beta/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use cloudsupport2_beta::{CloudSupport, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/cloudsupport2_beta/src/lib.rs b/gen/cloudsupport2_beta/src/lib.rs index 8d69f0c89f..27b9fd083f 100644 --- a/gen/cloudsupport2_beta/src/lib.rs +++ b/gen/cloudsupport2_beta/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/cloudsupport2_beta). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudSupport) ... +//! Handle the following *Resources* with ease from the central [hub](CloudSupport) ... //! //! * [attachments](api::Attachment) //! * [*create*](api::AttachmentCreateCall) @@ -73,8 +73,8 @@ //! let r = hub.cases().search(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -102,12 +102,12 @@ //! use std::default::Default; //! use cloudsupport2_beta::{CloudSupport, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -146,10 +146,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -159,25 +159,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/cloudtasks2/README.md b/gen/cloudtasks2/README.md index f903ee3296..0db736532a 100644 --- a/gen/cloudtasks2/README.md +++ b/gen/cloudtasks2/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Tasks* *v2* API can be found at the [official documentation site](https://cloud.google.com/tasks/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudtasks2/5.0.3+20230105/google_cloudtasks2/CloudTasks) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudtasks2/5.0.3+20230105/google_cloudtasks2/CloudTasks) ... * projects * [*locations get*](https://docs.rs/google-cloudtasks2/5.0.3+20230105/google_cloudtasks2/api::ProjectLocationGetCall), [*locations list*](https://docs.rs/google-cloudtasks2/5.0.3+20230105/google_cloudtasks2/api::ProjectLocationListCall), [*locations queues create*](https://docs.rs/google-cloudtasks2/5.0.3+20230105/google_cloudtasks2/api::ProjectLocationQueueCreateCall), [*locations queues delete*](https://docs.rs/google-cloudtasks2/5.0.3+20230105/google_cloudtasks2/api::ProjectLocationQueueDeleteCall), [*locations queues get*](https://docs.rs/google-cloudtasks2/5.0.3+20230105/google_cloudtasks2/api::ProjectLocationQueueGetCall), [*locations queues get iam policy*](https://docs.rs/google-cloudtasks2/5.0.3+20230105/google_cloudtasks2/api::ProjectLocationQueueGetIamPolicyCall), [*locations queues list*](https://docs.rs/google-cloudtasks2/5.0.3+20230105/google_cloudtasks2/api::ProjectLocationQueueListCall), [*locations queues patch*](https://docs.rs/google-cloudtasks2/5.0.3+20230105/google_cloudtasks2/api::ProjectLocationQueuePatchCall), [*locations queues pause*](https://docs.rs/google-cloudtasks2/5.0.3+20230105/google_cloudtasks2/api::ProjectLocationQueuePauseCall), [*locations queues purge*](https://docs.rs/google-cloudtasks2/5.0.3+20230105/google_cloudtasks2/api::ProjectLocationQueuePurgeCall), [*locations queues resume*](https://docs.rs/google-cloudtasks2/5.0.3+20230105/google_cloudtasks2/api::ProjectLocationQueueResumeCall), [*locations queues set iam policy*](https://docs.rs/google-cloudtasks2/5.0.3+20230105/google_cloudtasks2/api::ProjectLocationQueueSetIamPolicyCall), [*locations queues tasks create*](https://docs.rs/google-cloudtasks2/5.0.3+20230105/google_cloudtasks2/api::ProjectLocationQueueTaskCreateCall), [*locations queues tasks delete*](https://docs.rs/google-cloudtasks2/5.0.3+20230105/google_cloudtasks2/api::ProjectLocationQueueTaskDeleteCall), [*locations queues tasks get*](https://docs.rs/google-cloudtasks2/5.0.3+20230105/google_cloudtasks2/api::ProjectLocationQueueTaskGetCall), [*locations queues tasks list*](https://docs.rs/google-cloudtasks2/5.0.3+20230105/google_cloudtasks2/api::ProjectLocationQueueTaskListCall), [*locations queues tasks run*](https://docs.rs/google-cloudtasks2/5.0.3+20230105/google_cloudtasks2/api::ProjectLocationQueueTaskRunCall) and [*locations queues test iam permissions*](https://docs.rs/google-cloudtasks2/5.0.3+20230105/google_cloudtasks2/api::ProjectLocationQueueTestIamPermissionCall) @@ -55,8 +55,8 @@ let r = hub.projects().locations_queues_purge(...).doit().await let r = hub.projects().locations_queues_resume(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -84,12 +84,12 @@ use cloudtasks2::{Result, Error}; use std::default::Default; use cloudtasks2::{CloudTasks, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -131,10 +131,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-cloudtasks2/5.0.3+20230105/google_cloudtasks2/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-cloudtasks2/5.0.3+20230105/google_cloudtasks2/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -144,25 +144,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-cloudt You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudtasks2/5.0.3+20230105/google_cloudtasks2/client::Delegate) to the -[Method Builder](https://docs.rs/google-cloudtasks2/5.0.3+20230105/google_cloudtasks2/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudtasks2/5.0.3+20230105/google_cloudtasks2/client::Delegate) to the +[Method Builder](https://docs.rs/google-cloudtasks2/5.0.3+20230105/google_cloudtasks2/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-cloudtasks2/5.0.3+20230105/google_cloudtasks2/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudtasks2/5.0.3+20230105/google_cloudtasks2/client::RequestValue) and -[decodable](https://docs.rs/google-cloudtasks2/5.0.3+20230105/google_cloudtasks2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudtasks2/5.0.3+20230105/google_cloudtasks2/client::RequestValue) and +[decodable](https://docs.rs/google-cloudtasks2/5.0.3+20230105/google_cloudtasks2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-cloudtasks2/5.0.3+20230105/google_cloudtasks2/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-cloudtasks2/5.0.3+20230105/google_cloudtasks2/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -181,7 +181,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **cloudtasks2** library was generated by Sebastian Thiel, and is placed +The **cloudtasks2** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/cloudtasks2/src/api.rs b/gen/cloudtasks2/src/api.rs index ce8a5fb4c0..6f19b88f41 100644 --- a/gen/cloudtasks2/src/api.rs +++ b/gen/cloudtasks2/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use cloudtasks2::{CloudTasks, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/cloudtasks2/src/lib.rs b/gen/cloudtasks2/src/lib.rs index 995bde8212..873c2b5a53 100644 --- a/gen/cloudtasks2/src/lib.rs +++ b/gen/cloudtasks2/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/cloudtasks2). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudTasks) ... +//! Handle the following *Resources* with ease from the central [hub](CloudTasks) ... //! //! * projects //! * [*locations get*](api::ProjectLocationGetCall), [*locations list*](api::ProjectLocationListCall), [*locations queues create*](api::ProjectLocationQueueCreateCall), [*locations queues delete*](api::ProjectLocationQueueDeleteCall), [*locations queues get*](api::ProjectLocationQueueGetCall), [*locations queues get iam policy*](api::ProjectLocationQueueGetIamPolicyCall), [*locations queues list*](api::ProjectLocationQueueListCall), [*locations queues patch*](api::ProjectLocationQueuePatchCall), [*locations queues pause*](api::ProjectLocationQueuePauseCall), [*locations queues purge*](api::ProjectLocationQueuePurgeCall), [*locations queues resume*](api::ProjectLocationQueueResumeCall), [*locations queues set iam policy*](api::ProjectLocationQueueSetIamPolicyCall), [*locations queues tasks create*](api::ProjectLocationQueueTaskCreateCall), [*locations queues tasks delete*](api::ProjectLocationQueueTaskDeleteCall), [*locations queues tasks get*](api::ProjectLocationQueueTaskGetCall), [*locations queues tasks list*](api::ProjectLocationQueueTaskListCall), [*locations queues tasks run*](api::ProjectLocationQueueTaskRunCall) and [*locations queues test iam permissions*](api::ProjectLocationQueueTestIamPermissionCall) @@ -55,8 +55,8 @@ //! let r = hub.projects().locations_queues_resume(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -85,12 +85,12 @@ //! use std::default::Default; //! use cloudtasks2::{CloudTasks, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -132,10 +132,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -145,25 +145,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/cloudtasks2_beta2/README.md b/gen/cloudtasks2_beta2/README.md index 918ec7c677..de00824389 100644 --- a/gen/cloudtasks2_beta2/README.md +++ b/gen/cloudtasks2_beta2/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Tasks* *v2_beta2* API can be found at the [official documentation site](https://cloud.google.com/tasks/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudtasks2_beta2/5.0.3+20230105/google_cloudtasks2_beta2/CloudTasks) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudtasks2_beta2/5.0.3+20230105/google_cloudtasks2_beta2/CloudTasks) ... * api * [*queue update*](https://docs.rs/google-cloudtasks2_beta2/5.0.3+20230105/google_cloudtasks2_beta2/api::ApiQueueUpdateCall) @@ -57,8 +57,8 @@ let r = hub.projects().locations_queues_purge(...).doit().await let r = hub.projects().locations_queues_resume(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -86,12 +86,12 @@ use cloudtasks2_beta2::{Result, Error}; use std::default::Default; use cloudtasks2_beta2::{CloudTasks, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -133,10 +133,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-cloudtasks2_beta2/5.0.3+20230105/google_cloudtasks2_beta2/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-cloudtasks2_beta2/5.0.3+20230105/google_cloudtasks2_beta2/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -146,25 +146,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-cloudt You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudtasks2_beta2/5.0.3+20230105/google_cloudtasks2_beta2/client::Delegate) to the -[Method Builder](https://docs.rs/google-cloudtasks2_beta2/5.0.3+20230105/google_cloudtasks2_beta2/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudtasks2_beta2/5.0.3+20230105/google_cloudtasks2_beta2/client::Delegate) to the +[Method Builder](https://docs.rs/google-cloudtasks2_beta2/5.0.3+20230105/google_cloudtasks2_beta2/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-cloudtasks2_beta2/5.0.3+20230105/google_cloudtasks2_beta2/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudtasks2_beta2/5.0.3+20230105/google_cloudtasks2_beta2/client::RequestValue) and -[decodable](https://docs.rs/google-cloudtasks2_beta2/5.0.3+20230105/google_cloudtasks2_beta2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudtasks2_beta2/5.0.3+20230105/google_cloudtasks2_beta2/client::RequestValue) and +[decodable](https://docs.rs/google-cloudtasks2_beta2/5.0.3+20230105/google_cloudtasks2_beta2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-cloudtasks2_beta2/5.0.3+20230105/google_cloudtasks2_beta2/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-cloudtasks2_beta2/5.0.3+20230105/google_cloudtasks2_beta2/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -183,7 +183,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **cloudtasks2_beta2** library was generated by Sebastian Thiel, and is placed +The **cloudtasks2_beta2** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/cloudtasks2_beta2/src/api.rs b/gen/cloudtasks2_beta2/src/api.rs index aa905e7132..8b8ae3d1f1 100644 --- a/gen/cloudtasks2_beta2/src/api.rs +++ b/gen/cloudtasks2_beta2/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use cloudtasks2_beta2::{CloudTasks, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/cloudtasks2_beta2/src/lib.rs b/gen/cloudtasks2_beta2/src/lib.rs index 379a338d61..4f592b6602 100644 --- a/gen/cloudtasks2_beta2/src/lib.rs +++ b/gen/cloudtasks2_beta2/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/cloudtasks2_beta2). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudTasks) ... +//! Handle the following *Resources* with ease from the central [hub](CloudTasks) ... //! //! * api //! * [*queue update*](api::ApiQueueUpdateCall) @@ -57,8 +57,8 @@ //! let r = hub.projects().locations_queues_resume(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -87,12 +87,12 @@ //! use std::default::Default; //! use cloudtasks2_beta2::{CloudTasks, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -134,10 +134,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -147,25 +147,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/cloudtasks2_beta3/README.md b/gen/cloudtasks2_beta3/README.md index 0f1f8d3ff3..d061ba8d1f 100644 --- a/gen/cloudtasks2_beta3/README.md +++ b/gen/cloudtasks2_beta3/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Tasks* *v2_beta3* API can be found at the [official documentation site](https://cloud.google.com/tasks/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudtasks2_beta3/5.0.3+20230105/google_cloudtasks2_beta3/CloudTasks) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudtasks2_beta3/5.0.3+20230105/google_cloudtasks2_beta3/CloudTasks) ... * projects * [*locations get*](https://docs.rs/google-cloudtasks2_beta3/5.0.3+20230105/google_cloudtasks2_beta3/api::ProjectLocationGetCall), [*locations list*](https://docs.rs/google-cloudtasks2_beta3/5.0.3+20230105/google_cloudtasks2_beta3/api::ProjectLocationListCall), [*locations queues create*](https://docs.rs/google-cloudtasks2_beta3/5.0.3+20230105/google_cloudtasks2_beta3/api::ProjectLocationQueueCreateCall), [*locations queues delete*](https://docs.rs/google-cloudtasks2_beta3/5.0.3+20230105/google_cloudtasks2_beta3/api::ProjectLocationQueueDeleteCall), [*locations queues get*](https://docs.rs/google-cloudtasks2_beta3/5.0.3+20230105/google_cloudtasks2_beta3/api::ProjectLocationQueueGetCall), [*locations queues get iam policy*](https://docs.rs/google-cloudtasks2_beta3/5.0.3+20230105/google_cloudtasks2_beta3/api::ProjectLocationQueueGetIamPolicyCall), [*locations queues list*](https://docs.rs/google-cloudtasks2_beta3/5.0.3+20230105/google_cloudtasks2_beta3/api::ProjectLocationQueueListCall), [*locations queues patch*](https://docs.rs/google-cloudtasks2_beta3/5.0.3+20230105/google_cloudtasks2_beta3/api::ProjectLocationQueuePatchCall), [*locations queues pause*](https://docs.rs/google-cloudtasks2_beta3/5.0.3+20230105/google_cloudtasks2_beta3/api::ProjectLocationQueuePauseCall), [*locations queues purge*](https://docs.rs/google-cloudtasks2_beta3/5.0.3+20230105/google_cloudtasks2_beta3/api::ProjectLocationQueuePurgeCall), [*locations queues resume*](https://docs.rs/google-cloudtasks2_beta3/5.0.3+20230105/google_cloudtasks2_beta3/api::ProjectLocationQueueResumeCall), [*locations queues set iam policy*](https://docs.rs/google-cloudtasks2_beta3/5.0.3+20230105/google_cloudtasks2_beta3/api::ProjectLocationQueueSetIamPolicyCall), [*locations queues tasks buffer*](https://docs.rs/google-cloudtasks2_beta3/5.0.3+20230105/google_cloudtasks2_beta3/api::ProjectLocationQueueTaskBufferCall), [*locations queues tasks create*](https://docs.rs/google-cloudtasks2_beta3/5.0.3+20230105/google_cloudtasks2_beta3/api::ProjectLocationQueueTaskCreateCall), [*locations queues tasks delete*](https://docs.rs/google-cloudtasks2_beta3/5.0.3+20230105/google_cloudtasks2_beta3/api::ProjectLocationQueueTaskDeleteCall), [*locations queues tasks get*](https://docs.rs/google-cloudtasks2_beta3/5.0.3+20230105/google_cloudtasks2_beta3/api::ProjectLocationQueueTaskGetCall), [*locations queues tasks list*](https://docs.rs/google-cloudtasks2_beta3/5.0.3+20230105/google_cloudtasks2_beta3/api::ProjectLocationQueueTaskListCall), [*locations queues tasks run*](https://docs.rs/google-cloudtasks2_beta3/5.0.3+20230105/google_cloudtasks2_beta3/api::ProjectLocationQueueTaskRunCall) and [*locations queues test iam permissions*](https://docs.rs/google-cloudtasks2_beta3/5.0.3+20230105/google_cloudtasks2_beta3/api::ProjectLocationQueueTestIamPermissionCall) @@ -55,8 +55,8 @@ let r = hub.projects().locations_queues_purge(...).doit().await let r = hub.projects().locations_queues_resume(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -84,12 +84,12 @@ use cloudtasks2_beta3::{Result, Error}; use std::default::Default; use cloudtasks2_beta3::{CloudTasks, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -131,10 +131,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-cloudtasks2_beta3/5.0.3+20230105/google_cloudtasks2_beta3/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-cloudtasks2_beta3/5.0.3+20230105/google_cloudtasks2_beta3/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -144,25 +144,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-cloudt You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudtasks2_beta3/5.0.3+20230105/google_cloudtasks2_beta3/client::Delegate) to the -[Method Builder](https://docs.rs/google-cloudtasks2_beta3/5.0.3+20230105/google_cloudtasks2_beta3/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudtasks2_beta3/5.0.3+20230105/google_cloudtasks2_beta3/client::Delegate) to the +[Method Builder](https://docs.rs/google-cloudtasks2_beta3/5.0.3+20230105/google_cloudtasks2_beta3/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-cloudtasks2_beta3/5.0.3+20230105/google_cloudtasks2_beta3/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudtasks2_beta3/5.0.3+20230105/google_cloudtasks2_beta3/client::RequestValue) and -[decodable](https://docs.rs/google-cloudtasks2_beta3/5.0.3+20230105/google_cloudtasks2_beta3/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudtasks2_beta3/5.0.3+20230105/google_cloudtasks2_beta3/client::RequestValue) and +[decodable](https://docs.rs/google-cloudtasks2_beta3/5.0.3+20230105/google_cloudtasks2_beta3/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-cloudtasks2_beta3/5.0.3+20230105/google_cloudtasks2_beta3/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-cloudtasks2_beta3/5.0.3+20230105/google_cloudtasks2_beta3/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -181,7 +181,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **cloudtasks2_beta3** library was generated by Sebastian Thiel, and is placed +The **cloudtasks2_beta3** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/cloudtasks2_beta3/src/api.rs b/gen/cloudtasks2_beta3/src/api.rs index 7efdfb9550..6a5d449456 100644 --- a/gen/cloudtasks2_beta3/src/api.rs +++ b/gen/cloudtasks2_beta3/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use cloudtasks2_beta3::{CloudTasks, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/cloudtasks2_beta3/src/lib.rs b/gen/cloudtasks2_beta3/src/lib.rs index a8f0ff0d04..08e1cb35eb 100644 --- a/gen/cloudtasks2_beta3/src/lib.rs +++ b/gen/cloudtasks2_beta3/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/cloudtasks2_beta3). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudTasks) ... +//! Handle the following *Resources* with ease from the central [hub](CloudTasks) ... //! //! * projects //! * [*locations get*](api::ProjectLocationGetCall), [*locations list*](api::ProjectLocationListCall), [*locations queues create*](api::ProjectLocationQueueCreateCall), [*locations queues delete*](api::ProjectLocationQueueDeleteCall), [*locations queues get*](api::ProjectLocationQueueGetCall), [*locations queues get iam policy*](api::ProjectLocationQueueGetIamPolicyCall), [*locations queues list*](api::ProjectLocationQueueListCall), [*locations queues patch*](api::ProjectLocationQueuePatchCall), [*locations queues pause*](api::ProjectLocationQueuePauseCall), [*locations queues purge*](api::ProjectLocationQueuePurgeCall), [*locations queues resume*](api::ProjectLocationQueueResumeCall), [*locations queues set iam policy*](api::ProjectLocationQueueSetIamPolicyCall), [*locations queues tasks buffer*](api::ProjectLocationQueueTaskBufferCall), [*locations queues tasks create*](api::ProjectLocationQueueTaskCreateCall), [*locations queues tasks delete*](api::ProjectLocationQueueTaskDeleteCall), [*locations queues tasks get*](api::ProjectLocationQueueTaskGetCall), [*locations queues tasks list*](api::ProjectLocationQueueTaskListCall), [*locations queues tasks run*](api::ProjectLocationQueueTaskRunCall) and [*locations queues test iam permissions*](api::ProjectLocationQueueTestIamPermissionCall) @@ -55,8 +55,8 @@ //! let r = hub.projects().locations_queues_resume(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -85,12 +85,12 @@ //! use std::default::Default; //! use cloudtasks2_beta3::{CloudTasks, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -132,10 +132,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -145,25 +145,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/cloudtrace1/README.md b/gen/cloudtrace1/README.md index 66f3c69ee6..a8e2abfeb3 100644 --- a/gen/cloudtrace1/README.md +++ b/gen/cloudtrace1/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Trace* *v1* API can be found at the [official documentation site](https://cloud.google.com/trace). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudtrace1/5.0.3+20230112/google_cloudtrace1/CloudTrace) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudtrace1/5.0.3+20230112/google_cloudtrace1/CloudTrace) ... * projects * [*patch traces*](https://docs.rs/google-cloudtrace1/5.0.3+20230112/google_cloudtrace1/api::ProjectPatchTraceCall), [*traces get*](https://docs.rs/google-cloudtrace1/5.0.3+20230112/google_cloudtrace1/api::ProjectTraceGetCall) and [*traces list*](https://docs.rs/google-cloudtrace1/5.0.3+20230112/google_cloudtrace1/api::ProjectTraceListCall) @@ -50,8 +50,8 @@ Or specifically ... let r = hub.projects().traces_get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -78,12 +78,12 @@ use cloudtrace1::{Result, Error}; use std::default::Default; use cloudtrace1::{CloudTrace, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -119,10 +119,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-cloudtrace1/5.0.3+20230112/google_cloudtrace1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-cloudtrace1/5.0.3+20230112/google_cloudtrace1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -132,25 +132,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-cloudt You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudtrace1/5.0.3+20230112/google_cloudtrace1/client::Delegate) to the -[Method Builder](https://docs.rs/google-cloudtrace1/5.0.3+20230112/google_cloudtrace1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudtrace1/5.0.3+20230112/google_cloudtrace1/client::Delegate) to the +[Method Builder](https://docs.rs/google-cloudtrace1/5.0.3+20230112/google_cloudtrace1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-cloudtrace1/5.0.3+20230112/google_cloudtrace1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudtrace1/5.0.3+20230112/google_cloudtrace1/client::RequestValue) and -[decodable](https://docs.rs/google-cloudtrace1/5.0.3+20230112/google_cloudtrace1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudtrace1/5.0.3+20230112/google_cloudtrace1/client::RequestValue) and +[decodable](https://docs.rs/google-cloudtrace1/5.0.3+20230112/google_cloudtrace1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-cloudtrace1/5.0.3+20230112/google_cloudtrace1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-cloudtrace1/5.0.3+20230112/google_cloudtrace1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -169,7 +169,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **cloudtrace1** library was generated by Sebastian Thiel, and is placed +The **cloudtrace1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/cloudtrace1/src/api.rs b/gen/cloudtrace1/src/api.rs index d5f11febec..c5b5d3d64e 100644 --- a/gen/cloudtrace1/src/api.rs +++ b/gen/cloudtrace1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -72,12 +72,12 @@ impl Default for Scope { /// use std::default::Default; /// use cloudtrace1::{CloudTrace, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/cloudtrace1/src/lib.rs b/gen/cloudtrace1/src/lib.rs index 61fa05e3e3..d2ed5d000e 100644 --- a/gen/cloudtrace1/src/lib.rs +++ b/gen/cloudtrace1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/cloudtrace1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudTrace) ... +//! Handle the following *Resources* with ease from the central [hub](CloudTrace) ... //! //! * projects //! * [*patch traces*](api::ProjectPatchTraceCall), [*traces get*](api::ProjectTraceGetCall) and [*traces list*](api::ProjectTraceListCall) @@ -50,8 +50,8 @@ //! let r = hub.projects().traces_get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -79,12 +79,12 @@ //! use std::default::Default; //! use cloudtrace1::{CloudTrace, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -120,10 +120,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -133,25 +133,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/cloudtrace2/README.md b/gen/cloudtrace2/README.md index cf06e803fa..c7aea750a3 100644 --- a/gen/cloudtrace2/README.md +++ b/gen/cloudtrace2/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Trace* *v2* API can be found at the [official documentation site](https://cloud.google.com/trace). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudtrace2/5.0.3+20230112/google_cloudtrace2/CloudTrace) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-cloudtrace2/5.0.3+20230112/google_cloudtrace2/CloudTrace) ... * projects * [*traces batch write*](https://docs.rs/google-cloudtrace2/5.0.3+20230112/google_cloudtrace2/api::ProjectTraceBatchWriteCall) and [*traces spans create span*](https://docs.rs/google-cloudtrace2/5.0.3+20230112/google_cloudtrace2/api::ProjectTraceSpanCreateSpanCall) @@ -50,8 +50,8 @@ Or specifically ... let r = hub.projects().traces_spans_create_span(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -79,12 +79,12 @@ use cloudtrace2::{Result, Error}; use std::default::Default; use cloudtrace2::{CloudTrace, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -125,10 +125,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-cloudtrace2/5.0.3+20230112/google_cloudtrace2/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-cloudtrace2/5.0.3+20230112/google_cloudtrace2/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -138,25 +138,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-cloudt You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudtrace2/5.0.3+20230112/google_cloudtrace2/client::Delegate) to the -[Method Builder](https://docs.rs/google-cloudtrace2/5.0.3+20230112/google_cloudtrace2/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-cloudtrace2/5.0.3+20230112/google_cloudtrace2/client::Delegate) to the +[Method Builder](https://docs.rs/google-cloudtrace2/5.0.3+20230112/google_cloudtrace2/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-cloudtrace2/5.0.3+20230112/google_cloudtrace2/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudtrace2/5.0.3+20230112/google_cloudtrace2/client::RequestValue) and -[decodable](https://docs.rs/google-cloudtrace2/5.0.3+20230112/google_cloudtrace2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-cloudtrace2/5.0.3+20230112/google_cloudtrace2/client::RequestValue) and +[decodable](https://docs.rs/google-cloudtrace2/5.0.3+20230112/google_cloudtrace2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-cloudtrace2/5.0.3+20230112/google_cloudtrace2/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-cloudtrace2/5.0.3+20230112/google_cloudtrace2/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -175,7 +175,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **cloudtrace2** library was generated by Sebastian Thiel, and is placed +The **cloudtrace2** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/cloudtrace2/src/api.rs b/gen/cloudtrace2/src/api.rs index 4988ab9afd..1d9db32910 100644 --- a/gen/cloudtrace2/src/api.rs +++ b/gen/cloudtrace2/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use cloudtrace2::{CloudTrace, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/cloudtrace2/src/lib.rs b/gen/cloudtrace2/src/lib.rs index a0e260b744..8f68e0aed7 100644 --- a/gen/cloudtrace2/src/lib.rs +++ b/gen/cloudtrace2/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/cloudtrace2). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudTrace) ... +//! Handle the following *Resources* with ease from the central [hub](CloudTrace) ... //! //! * projects //! * [*traces batch write*](api::ProjectTraceBatchWriteCall) and [*traces spans create span*](api::ProjectTraceSpanCreateSpanCall) @@ -50,8 +50,8 @@ //! let r = hub.projects().traces_spans_create_span(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -80,12 +80,12 @@ //! use std::default::Default; //! use cloudtrace2::{CloudTrace, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -126,10 +126,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -139,25 +139,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/clouduseraccountsvm_beta/README.md b/gen/clouduseraccountsvm_beta/README.md index c960a0d01c..4abee331ee 100644 --- a/gen/clouduseraccountsvm_beta/README.md +++ b/gen/clouduseraccountsvm_beta/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud User Accounts* *vm_beta* API can be found at th [official documentation site](https://cloud.google.com/compute/docs/access/user-accounts/api/latest/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-clouduseraccountsvm_beta/5.0.3+20160316/google_clouduseraccountsvm_beta/CloudUserAccounts) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-clouduseraccountsvm_beta/5.0.3+20160316/google_clouduseraccountsvm_beta/CloudUserAccounts) ... * global accounts operations * [*delete*](https://docs.rs/google-clouduseraccountsvm_beta/5.0.3+20160316/google_clouduseraccountsvm_beta/api::GlobalAccountsOperationDeleteCall), [*get*](https://docs.rs/google-clouduseraccountsvm_beta/5.0.3+20160316/google_clouduseraccountsvm_beta/api::GlobalAccountsOperationGetCall) and [*list*](https://docs.rs/google-clouduseraccountsvm_beta/5.0.3+20160316/google_clouduseraccountsvm_beta/api::GlobalAccountsOperationListCall) @@ -64,8 +64,8 @@ let r = hub.users().insert(...).doit().await let r = hub.users().remove_public_key(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -93,12 +93,12 @@ use clouduseraccountsvm_beta::{Result, Error}; use std::default::Default; use clouduseraccountsvm_beta::{CloudUserAccounts, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -139,10 +139,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-clouduseraccountsvm_beta/5.0.3+20160316/google_clouduseraccountsvm_beta/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-clouduseraccountsvm_beta/5.0.3+20160316/google_clouduseraccountsvm_beta/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -152,25 +152,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-cloudu You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-clouduseraccountsvm_beta/5.0.3+20160316/google_clouduseraccountsvm_beta/client::Delegate) to the -[Method Builder](https://docs.rs/google-clouduseraccountsvm_beta/5.0.3+20160316/google_clouduseraccountsvm_beta/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-clouduseraccountsvm_beta/5.0.3+20160316/google_clouduseraccountsvm_beta/client::Delegate) to the +[Method Builder](https://docs.rs/google-clouduseraccountsvm_beta/5.0.3+20160316/google_clouduseraccountsvm_beta/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-clouduseraccountsvm_beta/5.0.3+20160316/google_clouduseraccountsvm_beta/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-clouduseraccountsvm_beta/5.0.3+20160316/google_clouduseraccountsvm_beta/client::RequestValue) and -[decodable](https://docs.rs/google-clouduseraccountsvm_beta/5.0.3+20160316/google_clouduseraccountsvm_beta/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-clouduseraccountsvm_beta/5.0.3+20160316/google_clouduseraccountsvm_beta/client::RequestValue) and +[decodable](https://docs.rs/google-clouduseraccountsvm_beta/5.0.3+20160316/google_clouduseraccountsvm_beta/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-clouduseraccountsvm_beta/5.0.3+20160316/google_clouduseraccountsvm_beta/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-clouduseraccountsvm_beta/5.0.3+20160316/google_clouduseraccountsvm_beta/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -189,7 +189,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **clouduseraccountsvm_beta** library was generated by Sebastian Thiel, and is placed +The **clouduseraccountsvm_beta** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/clouduseraccountsvm_beta/src/api.rs b/gen/clouduseraccountsvm_beta/src/api.rs index 9bb2783f60..7931b0d6a5 100644 --- a/gen/clouduseraccountsvm_beta/src/api.rs +++ b/gen/clouduseraccountsvm_beta/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your data across Google Cloud Platform services CloudPlatform, @@ -77,12 +77,12 @@ impl Default for Scope { /// use std::default::Default; /// use clouduseraccountsvm_beta::{CloudUserAccounts, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/clouduseraccountsvm_beta/src/lib.rs b/gen/clouduseraccountsvm_beta/src/lib.rs index 40f50b7f0f..7f45001ffb 100644 --- a/gen/clouduseraccountsvm_beta/src/lib.rs +++ b/gen/clouduseraccountsvm_beta/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/clouduseraccountsvm_beta). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudUserAccounts) ... +//! Handle the following *Resources* with ease from the central [hub](CloudUserAccounts) ... //! //! * global accounts operations //! * [*delete*](api::GlobalAccountsOperationDeleteCall), [*get*](api::GlobalAccountsOperationGetCall) and [*list*](api::GlobalAccountsOperationListCall) @@ -64,8 +64,8 @@ //! let r = hub.users().remove_public_key(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -94,12 +94,12 @@ //! use std::default::Default; //! use clouduseraccountsvm_beta::{CloudUserAccounts, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -140,10 +140,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -153,25 +153,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/commentanalyzer1_alpha1/README.md b/gen/commentanalyzer1_alpha1/README.md index cda94bc6fa..8416aba8cb 100644 --- a/gen/commentanalyzer1_alpha1/README.md +++ b/gen/commentanalyzer1_alpha1/README.md @@ -11,7 +11,7 @@ Everything else about the *Comment Analyzer* *v1_alpha1* API can be found at the [official documentation site](https://github.com/conversationai/perspectiveapi/blob/master/README.md). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-commentanalyzer1_alpha1/5.0.3+20200405/google_commentanalyzer1_alpha1/CommentAnalyzer) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-commentanalyzer1_alpha1/5.0.3+20200405/google_commentanalyzer1_alpha1/CommentAnalyzer) ... * comments * [*analyze*](https://docs.rs/google-commentanalyzer1_alpha1/5.0.3+20200405/google_commentanalyzer1_alpha1/api::CommentAnalyzeCall) and [*suggestscore*](https://docs.rs/google-commentanalyzer1_alpha1/5.0.3+20200405/google_commentanalyzer1_alpha1/api::CommentSuggestscoreCall) @@ -50,8 +50,8 @@ Or specifically ... let r = hub.comments().analyze(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -79,12 +79,12 @@ use commentanalyzer1_alpha1::{Result, Error}; use std::default::Default; use commentanalyzer1_alpha1::{CommentAnalyzer, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -125,10 +125,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-commentanalyzer1_alpha1/5.0.3+20200405/google_commentanalyzer1_alpha1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-commentanalyzer1_alpha1/5.0.3+20200405/google_commentanalyzer1_alpha1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -138,25 +138,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-commen You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-commentanalyzer1_alpha1/5.0.3+20200405/google_commentanalyzer1_alpha1/client::Delegate) to the -[Method Builder](https://docs.rs/google-commentanalyzer1_alpha1/5.0.3+20200405/google_commentanalyzer1_alpha1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-commentanalyzer1_alpha1/5.0.3+20200405/google_commentanalyzer1_alpha1/client::Delegate) to the +[Method Builder](https://docs.rs/google-commentanalyzer1_alpha1/5.0.3+20200405/google_commentanalyzer1_alpha1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-commentanalyzer1_alpha1/5.0.3+20200405/google_commentanalyzer1_alpha1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-commentanalyzer1_alpha1/5.0.3+20200405/google_commentanalyzer1_alpha1/client::RequestValue) and -[decodable](https://docs.rs/google-commentanalyzer1_alpha1/5.0.3+20200405/google_commentanalyzer1_alpha1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-commentanalyzer1_alpha1/5.0.3+20200405/google_commentanalyzer1_alpha1/client::RequestValue) and +[decodable](https://docs.rs/google-commentanalyzer1_alpha1/5.0.3+20200405/google_commentanalyzer1_alpha1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-commentanalyzer1_alpha1/5.0.3+20200405/google_commentanalyzer1_alpha1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-commentanalyzer1_alpha1/5.0.3+20200405/google_commentanalyzer1_alpha1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -175,7 +175,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **commentanalyzer1_alpha1** library was generated by Sebastian Thiel, and is placed +The **commentanalyzer1_alpha1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/commentanalyzer1_alpha1/src/api.rs b/gen/commentanalyzer1_alpha1/src/api.rs index acbf1b82cb..46c39535da 100644 --- a/gen/commentanalyzer1_alpha1/src/api.rs +++ b/gen/commentanalyzer1_alpha1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View your email address UserinfoEmail, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use commentanalyzer1_alpha1::{CommentAnalyzer, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/commentanalyzer1_alpha1/src/lib.rs b/gen/commentanalyzer1_alpha1/src/lib.rs index 6006dcc5ae..932314f10d 100644 --- a/gen/commentanalyzer1_alpha1/src/lib.rs +++ b/gen/commentanalyzer1_alpha1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/commentanalyzer1_alpha1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CommentAnalyzer) ... +//! Handle the following *Resources* with ease from the central [hub](CommentAnalyzer) ... //! //! * comments //! * [*analyze*](api::CommentAnalyzeCall) and [*suggestscore*](api::CommentSuggestscoreCall) @@ -50,8 +50,8 @@ //! let r = hub.comments().analyze(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -80,12 +80,12 @@ //! use std::default::Default; //! use commentanalyzer1_alpha1::{CommentAnalyzer, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -126,10 +126,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -139,25 +139,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/composer1/README.md b/gen/composer1/README.md index 09c7dc99d2..c90cc1163b 100644 --- a/gen/composer1/README.md +++ b/gen/composer1/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Composer* *v1* API can be found at the [official documentation site](https://cloud.google.com/composer/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-composer1/5.0.3+20230107/google_composer1/CloudComposer) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-composer1/5.0.3+20230107/google_composer1/CloudComposer) ... * projects * [*locations environments create*](https://docs.rs/google-composer1/5.0.3+20230107/google_composer1/api::ProjectLocationEnvironmentCreateCall), [*locations environments delete*](https://docs.rs/google-composer1/5.0.3+20230107/google_composer1/api::ProjectLocationEnvironmentDeleteCall), [*locations environments get*](https://docs.rs/google-composer1/5.0.3+20230107/google_composer1/api::ProjectLocationEnvironmentGetCall), [*locations environments list*](https://docs.rs/google-composer1/5.0.3+20230107/google_composer1/api::ProjectLocationEnvironmentListCall), [*locations environments load snapshot*](https://docs.rs/google-composer1/5.0.3+20230107/google_composer1/api::ProjectLocationEnvironmentLoadSnapshotCall), [*locations environments patch*](https://docs.rs/google-composer1/5.0.3+20230107/google_composer1/api::ProjectLocationEnvironmentPatchCall), [*locations environments save snapshot*](https://docs.rs/google-composer1/5.0.3+20230107/google_composer1/api::ProjectLocationEnvironmentSaveSnapshotCall), [*locations image versions list*](https://docs.rs/google-composer1/5.0.3+20230107/google_composer1/api::ProjectLocationImageVersionListCall), [*locations operations delete*](https://docs.rs/google-composer1/5.0.3+20230107/google_composer1/api::ProjectLocationOperationDeleteCall), [*locations operations get*](https://docs.rs/google-composer1/5.0.3+20230107/google_composer1/api::ProjectLocationOperationGetCall) and [*locations operations list*](https://docs.rs/google-composer1/5.0.3+20230107/google_composer1/api::ProjectLocationOperationListCall) @@ -55,8 +55,8 @@ let r = hub.projects().locations_environments_save_snapshot(...).doit().await let r = hub.projects().locations_operations_get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -84,12 +84,12 @@ use composer1::{Result, Error}; use std::default::Default; use composer1::{CloudComposer, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -131,10 +131,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-composer1/5.0.3+20230107/google_composer1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-composer1/5.0.3+20230107/google_composer1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -144,25 +144,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-compos You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-composer1/5.0.3+20230107/google_composer1/client::Delegate) to the -[Method Builder](https://docs.rs/google-composer1/5.0.3+20230107/google_composer1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-composer1/5.0.3+20230107/google_composer1/client::Delegate) to the +[Method Builder](https://docs.rs/google-composer1/5.0.3+20230107/google_composer1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-composer1/5.0.3+20230107/google_composer1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-composer1/5.0.3+20230107/google_composer1/client::RequestValue) and -[decodable](https://docs.rs/google-composer1/5.0.3+20230107/google_composer1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-composer1/5.0.3+20230107/google_composer1/client::RequestValue) and +[decodable](https://docs.rs/google-composer1/5.0.3+20230107/google_composer1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-composer1/5.0.3+20230107/google_composer1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-composer1/5.0.3+20230107/google_composer1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -181,7 +181,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **composer1** library was generated by Sebastian Thiel, and is placed +The **composer1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/composer1/src/api.rs b/gen/composer1/src/api.rs index f3cfd29d85..974cb2c524 100644 --- a/gen/composer1/src/api.rs +++ b/gen/composer1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use composer1::{CloudComposer, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/composer1/src/lib.rs b/gen/composer1/src/lib.rs index e3058450e3..af4e0eae2a 100644 --- a/gen/composer1/src/lib.rs +++ b/gen/composer1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/composer1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudComposer) ... +//! Handle the following *Resources* with ease from the central [hub](CloudComposer) ... //! //! * projects //! * [*locations environments create*](api::ProjectLocationEnvironmentCreateCall), [*locations environments delete*](api::ProjectLocationEnvironmentDeleteCall), [*locations environments get*](api::ProjectLocationEnvironmentGetCall), [*locations environments list*](api::ProjectLocationEnvironmentListCall), [*locations environments load snapshot*](api::ProjectLocationEnvironmentLoadSnapshotCall), [*locations environments patch*](api::ProjectLocationEnvironmentPatchCall), [*locations environments save snapshot*](api::ProjectLocationEnvironmentSaveSnapshotCall), [*locations image versions list*](api::ProjectLocationImageVersionListCall), [*locations operations delete*](api::ProjectLocationOperationDeleteCall), [*locations operations get*](api::ProjectLocationOperationGetCall) and [*locations operations list*](api::ProjectLocationOperationListCall) @@ -55,8 +55,8 @@ //! let r = hub.projects().locations_operations_get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -85,12 +85,12 @@ //! use std::default::Default; //! use composer1::{CloudComposer, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -132,10 +132,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -145,25 +145,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/compute1/README.md b/gen/compute1/README.md index fcf3f60773..fe04947124 100644 --- a/gen/compute1/README.md +++ b/gen/compute1/README.md @@ -11,7 +11,7 @@ Everything else about the *compute* *v1* API can be found at the [official documentation site](https://cloud.google.com/compute/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-compute1/5.0.3+20230103/google_compute1/Compute) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-compute1/5.0.3+20230103/google_compute1/Compute) ... * [accelerator types](https://docs.rs/google-compute1/5.0.3+20230103/google_compute1/api::AcceleratorType) * [*aggregated list*](https://docs.rs/google-compute1/5.0.3+20230103/google_compute1/api::AcceleratorTypeAggregatedListCall), [*get*](https://docs.rs/google-compute1/5.0.3+20230103/google_compute1/api::AcceleratorTypeGetCall) and [*list*](https://docs.rs/google-compute1/5.0.3+20230103/google_compute1/api::AcceleratorTypeListCall) @@ -592,8 +592,8 @@ let r = hub.zone_operations().get(...).doit().await let r = hub.zone_operations().wait(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -621,12 +621,12 @@ use compute1::{Result, Error}; use std::default::Default; use compute1::{Compute, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -670,10 +670,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-compute1/5.0.3+20230103/google_compute1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-compute1/5.0.3+20230103/google_compute1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -683,25 +683,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-comput You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-compute1/5.0.3+20230103/google_compute1/client::Delegate) to the -[Method Builder](https://docs.rs/google-compute1/5.0.3+20230103/google_compute1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-compute1/5.0.3+20230103/google_compute1/client::Delegate) to the +[Method Builder](https://docs.rs/google-compute1/5.0.3+20230103/google_compute1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-compute1/5.0.3+20230103/google_compute1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-compute1/5.0.3+20230103/google_compute1/client::RequestValue) and -[decodable](https://docs.rs/google-compute1/5.0.3+20230103/google_compute1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-compute1/5.0.3+20230103/google_compute1/client::RequestValue) and +[decodable](https://docs.rs/google-compute1/5.0.3+20230103/google_compute1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-compute1/5.0.3+20230103/google_compute1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-compute1/5.0.3+20230103/google_compute1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -720,7 +720,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **compute1** library was generated by Sebastian Thiel, and is placed +The **compute1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/compute1/src/api.rs b/gen/compute1/src/api.rs index 5e1d6319ce..34daa819ee 100644 --- a/gen/compute1/src/api.rs +++ b/gen/compute1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -85,12 +85,12 @@ impl Default for Scope { /// use std::default::Default; /// use compute1::{Compute, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/compute1/src/lib.rs b/gen/compute1/src/lib.rs index 594aed7cdd..30554a2bbd 100644 --- a/gen/compute1/src/lib.rs +++ b/gen/compute1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/compute1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Compute) ... +//! Handle the following *Resources* with ease from the central [hub](Compute) ... //! //! * [accelerator types](api::AcceleratorType) //! * [*aggregated list*](api::AcceleratorTypeAggregatedListCall), [*get*](api::AcceleratorTypeGetCall) and [*list*](api::AcceleratorTypeListCall) @@ -592,8 +592,8 @@ //! let r = hub.zone_operations().wait(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -622,12 +622,12 @@ //! use std::default::Default; //! use compute1::{Compute, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -671,10 +671,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -684,25 +684,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/connectors1/README.md b/gen/connectors1/README.md index 3f463a2dae..9701f070f2 100644 --- a/gen/connectors1/README.md +++ b/gen/connectors1/README.md @@ -11,7 +11,7 @@ Everything else about the *Connectors* *v1* API can be found at the [official documentation site](https://cloud.google.com/apigee/docs/api-platform/connectors/about-connectors). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-connectors1/5.0.3+20230103/google_connectors1/Connectors) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-connectors1/5.0.3+20230103/google_connectors1/Connectors) ... * projects * [*locations connections connection schema metadata refresh*](https://docs.rs/google-connectors1/5.0.3+20230103/google_connectors1/api::ProjectLocationConnectionConnectionSchemaMetadataRefreshCall), [*locations connections create*](https://docs.rs/google-connectors1/5.0.3+20230103/google_connectors1/api::ProjectLocationConnectionCreateCall), [*locations connections delete*](https://docs.rs/google-connectors1/5.0.3+20230103/google_connectors1/api::ProjectLocationConnectionDeleteCall), [*locations connections get*](https://docs.rs/google-connectors1/5.0.3+20230103/google_connectors1/api::ProjectLocationConnectionGetCall), [*locations connections get connection schema metadata*](https://docs.rs/google-connectors1/5.0.3+20230103/google_connectors1/api::ProjectLocationConnectionGetConnectionSchemaMetadataCall), [*locations connections get iam policy*](https://docs.rs/google-connectors1/5.0.3+20230103/google_connectors1/api::ProjectLocationConnectionGetIamPolicyCall), [*locations connections list*](https://docs.rs/google-connectors1/5.0.3+20230103/google_connectors1/api::ProjectLocationConnectionListCall), [*locations connections patch*](https://docs.rs/google-connectors1/5.0.3+20230103/google_connectors1/api::ProjectLocationConnectionPatchCall), [*locations connections runtime action schemas list*](https://docs.rs/google-connectors1/5.0.3+20230103/google_connectors1/api::ProjectLocationConnectionRuntimeActionSchemaListCall), [*locations connections runtime entity schemas list*](https://docs.rs/google-connectors1/5.0.3+20230103/google_connectors1/api::ProjectLocationConnectionRuntimeEntitySchemaListCall), [*locations connections set iam policy*](https://docs.rs/google-connectors1/5.0.3+20230103/google_connectors1/api::ProjectLocationConnectionSetIamPolicyCall), [*locations connections test iam permissions*](https://docs.rs/google-connectors1/5.0.3+20230103/google_connectors1/api::ProjectLocationConnectionTestIamPermissionCall), [*locations get*](https://docs.rs/google-connectors1/5.0.3+20230103/google_connectors1/api::ProjectLocationGetCall), [*locations get runtime config*](https://docs.rs/google-connectors1/5.0.3+20230103/google_connectors1/api::ProjectLocationGetRuntimeConfigCall), [*locations list*](https://docs.rs/google-connectors1/5.0.3+20230103/google_connectors1/api::ProjectLocationListCall), [*locations operations cancel*](https://docs.rs/google-connectors1/5.0.3+20230103/google_connectors1/api::ProjectLocationOperationCancelCall), [*locations operations delete*](https://docs.rs/google-connectors1/5.0.3+20230103/google_connectors1/api::ProjectLocationOperationDeleteCall), [*locations operations get*](https://docs.rs/google-connectors1/5.0.3+20230103/google_connectors1/api::ProjectLocationOperationGetCall), [*locations operations list*](https://docs.rs/google-connectors1/5.0.3+20230103/google_connectors1/api::ProjectLocationOperationListCall), [*locations providers connectors get*](https://docs.rs/google-connectors1/5.0.3+20230103/google_connectors1/api::ProjectLocationProviderConnectorGetCall), [*locations providers connectors list*](https://docs.rs/google-connectors1/5.0.3+20230103/google_connectors1/api::ProjectLocationProviderConnectorListCall), [*locations providers connectors versions get*](https://docs.rs/google-connectors1/5.0.3+20230103/google_connectors1/api::ProjectLocationProviderConnectorVersionGetCall), [*locations providers connectors versions list*](https://docs.rs/google-connectors1/5.0.3+20230103/google_connectors1/api::ProjectLocationProviderConnectorVersionListCall), [*locations providers get*](https://docs.rs/google-connectors1/5.0.3+20230103/google_connectors1/api::ProjectLocationProviderGetCall), [*locations providers get iam policy*](https://docs.rs/google-connectors1/5.0.3+20230103/google_connectors1/api::ProjectLocationProviderGetIamPolicyCall), [*locations providers list*](https://docs.rs/google-connectors1/5.0.3+20230103/google_connectors1/api::ProjectLocationProviderListCall), [*locations providers set iam policy*](https://docs.rs/google-connectors1/5.0.3+20230103/google_connectors1/api::ProjectLocationProviderSetIamPolicyCall) and [*locations providers test iam permissions*](https://docs.rs/google-connectors1/5.0.3+20230103/google_connectors1/api::ProjectLocationProviderTestIamPermissionCall) @@ -54,8 +54,8 @@ let r = hub.projects().locations_connections_patch(...).doit().await let r = hub.projects().locations_operations_get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -83,12 +83,12 @@ use connectors1::{Result, Error}; use std::default::Default; use connectors1::{Connectors, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -130,10 +130,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-connectors1/5.0.3+20230103/google_connectors1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-connectors1/5.0.3+20230103/google_connectors1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -143,25 +143,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-connec You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-connectors1/5.0.3+20230103/google_connectors1/client::Delegate) to the -[Method Builder](https://docs.rs/google-connectors1/5.0.3+20230103/google_connectors1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-connectors1/5.0.3+20230103/google_connectors1/client::Delegate) to the +[Method Builder](https://docs.rs/google-connectors1/5.0.3+20230103/google_connectors1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-connectors1/5.0.3+20230103/google_connectors1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-connectors1/5.0.3+20230103/google_connectors1/client::RequestValue) and -[decodable](https://docs.rs/google-connectors1/5.0.3+20230103/google_connectors1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-connectors1/5.0.3+20230103/google_connectors1/client::RequestValue) and +[decodable](https://docs.rs/google-connectors1/5.0.3+20230103/google_connectors1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-connectors1/5.0.3+20230103/google_connectors1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-connectors1/5.0.3+20230103/google_connectors1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -180,7 +180,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **connectors1** library was generated by Sebastian Thiel, and is placed +The **connectors1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/connectors1/src/api.rs b/gen/connectors1/src/api.rs index fdc8a56e1f..5f428ee9fb 100644 --- a/gen/connectors1/src/api.rs +++ b/gen/connectors1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use connectors1::{Connectors, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/connectors1/src/lib.rs b/gen/connectors1/src/lib.rs index ce1a0a13c4..f6ff078953 100644 --- a/gen/connectors1/src/lib.rs +++ b/gen/connectors1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/connectors1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Connectors) ... +//! Handle the following *Resources* with ease from the central [hub](Connectors) ... //! //! * projects //! * [*locations connections connection schema metadata refresh*](api::ProjectLocationConnectionConnectionSchemaMetadataRefreshCall), [*locations connections create*](api::ProjectLocationConnectionCreateCall), [*locations connections delete*](api::ProjectLocationConnectionDeleteCall), [*locations connections get*](api::ProjectLocationConnectionGetCall), [*locations connections get connection schema metadata*](api::ProjectLocationConnectionGetConnectionSchemaMetadataCall), [*locations connections get iam policy*](api::ProjectLocationConnectionGetIamPolicyCall), [*locations connections list*](api::ProjectLocationConnectionListCall), [*locations connections patch*](api::ProjectLocationConnectionPatchCall), [*locations connections runtime action schemas list*](api::ProjectLocationConnectionRuntimeActionSchemaListCall), [*locations connections runtime entity schemas list*](api::ProjectLocationConnectionRuntimeEntitySchemaListCall), [*locations connections set iam policy*](api::ProjectLocationConnectionSetIamPolicyCall), [*locations connections test iam permissions*](api::ProjectLocationConnectionTestIamPermissionCall), [*locations get*](api::ProjectLocationGetCall), [*locations get runtime config*](api::ProjectLocationGetRuntimeConfigCall), [*locations list*](api::ProjectLocationListCall), [*locations operations cancel*](api::ProjectLocationOperationCancelCall), [*locations operations delete*](api::ProjectLocationOperationDeleteCall), [*locations operations get*](api::ProjectLocationOperationGetCall), [*locations operations list*](api::ProjectLocationOperationListCall), [*locations providers connectors get*](api::ProjectLocationProviderConnectorGetCall), [*locations providers connectors list*](api::ProjectLocationProviderConnectorListCall), [*locations providers connectors versions get*](api::ProjectLocationProviderConnectorVersionGetCall), [*locations providers connectors versions list*](api::ProjectLocationProviderConnectorVersionListCall), [*locations providers get*](api::ProjectLocationProviderGetCall), [*locations providers get iam policy*](api::ProjectLocationProviderGetIamPolicyCall), [*locations providers list*](api::ProjectLocationProviderListCall), [*locations providers set iam policy*](api::ProjectLocationProviderSetIamPolicyCall) and [*locations providers test iam permissions*](api::ProjectLocationProviderTestIamPermissionCall) @@ -54,8 +54,8 @@ //! let r = hub.projects().locations_operations_get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -84,12 +84,12 @@ //! use std::default::Default; //! use connectors1::{Connectors, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -131,10 +131,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -144,25 +144,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/consumersurveys2/README.md b/gen/consumersurveys2/README.md index ab039cbe02..78528075c2 100644 --- a/gen/consumersurveys2/README.md +++ b/gen/consumersurveys2/README.md @@ -8,7 +8,7 @@ The `google-consumersurveys2` library allows access to all features of the *Goog This documentation was generated from *Consumer Surveys* crate version *5.0.3+20170407*, where *20170407* is the exact revision of the *consumersurveys:v2* schema built by the [mako](http://www.makotemplates.org/) code generator *v5.0.3*. # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-consumersurveys2/5.0.3+20170407/google_consumersurveys2/ConsumerSurveys) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-consumersurveys2/5.0.3+20170407/google_consumersurveys2/ConsumerSurveys) ... * mobileapppanels * [*get*](https://docs.rs/google-consumersurveys2/5.0.3+20170407/google_consumersurveys2/api::MobileapppanelGetCall), [*list*](https://docs.rs/google-consumersurveys2/5.0.3+20170407/google_consumersurveys2/api::MobileapppanelListCall) and [*update*](https://docs.rs/google-consumersurveys2/5.0.3+20170407/google_consumersurveys2/api::MobileapppanelUpdateCall) @@ -61,8 +61,8 @@ let r = hub.surveys().stop(...).doit().await let r = hub.surveys().update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -89,12 +89,12 @@ use consumersurveys2::{Result, Error}; use std::default::Default; use consumersurveys2::{ConsumerSurveys, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -133,10 +133,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-consumersurveys2/5.0.3+20170407/google_consumersurveys2/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-consumersurveys2/5.0.3+20170407/google_consumersurveys2/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -146,25 +146,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-consum You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-consumersurveys2/5.0.3+20170407/google_consumersurveys2/client::Delegate) to the -[Method Builder](https://docs.rs/google-consumersurveys2/5.0.3+20170407/google_consumersurveys2/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-consumersurveys2/5.0.3+20170407/google_consumersurveys2/client::Delegate) to the +[Method Builder](https://docs.rs/google-consumersurveys2/5.0.3+20170407/google_consumersurveys2/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-consumersurveys2/5.0.3+20170407/google_consumersurveys2/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-consumersurveys2/5.0.3+20170407/google_consumersurveys2/client::RequestValue) and -[decodable](https://docs.rs/google-consumersurveys2/5.0.3+20170407/google_consumersurveys2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-consumersurveys2/5.0.3+20170407/google_consumersurveys2/client::RequestValue) and +[decodable](https://docs.rs/google-consumersurveys2/5.0.3+20170407/google_consumersurveys2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-consumersurveys2/5.0.3+20170407/google_consumersurveys2/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-consumersurveys2/5.0.3+20170407/google_consumersurveys2/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -183,7 +183,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **consumersurveys2** library was generated by Sebastian Thiel, and is placed +The **consumersurveys2** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/consumersurveys2/src/api.rs b/gen/consumersurveys2/src/api.rs index 8ee1a88ea6..103b5d99fe 100644 --- a/gen/consumersurveys2/src/api.rs +++ b/gen/consumersurveys2/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and edit your surveys and results Full, @@ -72,12 +72,12 @@ impl Default for Scope { /// use std::default::Default; /// use consumersurveys2::{ConsumerSurveys, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/consumersurveys2/src/lib.rs b/gen/consumersurveys2/src/lib.rs index c43393bff6..b220e71497 100644 --- a/gen/consumersurveys2/src/lib.rs +++ b/gen/consumersurveys2/src/lib.rs @@ -6,7 +6,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/consumersurveys2). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](ConsumerSurveys) ... +//! Handle the following *Resources* with ease from the central [hub](ConsumerSurveys) ... //! //! * mobileapppanels //! * [*get*](api::MobileapppanelGetCall), [*list*](api::MobileapppanelListCall) and [*update*](api::MobileapppanelUpdateCall) @@ -61,8 +61,8 @@ //! let r = hub.surveys().update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -90,12 +90,12 @@ //! use std::default::Default; //! use consumersurveys2::{ConsumerSurveys, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -134,10 +134,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -147,25 +147,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/contactcenterinsights1/README.md b/gen/contactcenterinsights1/README.md index a2f4fa8718..326bbb927f 100644 --- a/gen/contactcenterinsights1/README.md +++ b/gen/contactcenterinsights1/README.md @@ -11,7 +11,7 @@ Everything else about the *Contactcenterinsights* *v1* API can be found at the [official documentation site](https://cloud.google.com/contact-center/insights/docs). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/Contactcenterinsights) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/Contactcenterinsights) ... * projects * [*locations conversations analyses create*](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/api::ProjectLocationConversationAnalysisCreateCall), [*locations conversations analyses delete*](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/api::ProjectLocationConversationAnalysisDeleteCall), [*locations conversations analyses get*](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/api::ProjectLocationConversationAnalysisGetCall), [*locations conversations analyses list*](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/api::ProjectLocationConversationAnalysisListCall), [*locations conversations bulk analyze*](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/api::ProjectLocationConversationBulkAnalyzeCall), [*locations conversations calculate stats*](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/api::ProjectLocationConversationCalculateStatCall), [*locations conversations create*](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/api::ProjectLocationConversationCreateCall), [*locations conversations delete*](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/api::ProjectLocationConversationDeleteCall), [*locations conversations get*](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/api::ProjectLocationConversationGetCall), [*locations conversations ingest*](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/api::ProjectLocationConversationIngestCall), [*locations conversations list*](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/api::ProjectLocationConversationListCall), [*locations conversations patch*](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/api::ProjectLocationConversationPatchCall), [*locations get settings*](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/api::ProjectLocationGetSettingCall), [*locations insightsdata export*](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/api::ProjectLocationInsightsdataExportCall), [*locations issue models calculate issue model stats*](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/api::ProjectLocationIssueModelCalculateIssueModelStatCall), [*locations issue models create*](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/api::ProjectLocationIssueModelCreateCall), [*locations issue models delete*](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/api::ProjectLocationIssueModelDeleteCall), [*locations issue models deploy*](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/api::ProjectLocationIssueModelDeployCall), [*locations issue models get*](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/api::ProjectLocationIssueModelGetCall), [*locations issue models issues delete*](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/api::ProjectLocationIssueModelIssueDeleteCall), [*locations issue models issues get*](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/api::ProjectLocationIssueModelIssueGetCall), [*locations issue models issues list*](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/api::ProjectLocationIssueModelIssueListCall), [*locations issue models issues patch*](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/api::ProjectLocationIssueModelIssuePatchCall), [*locations issue models list*](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/api::ProjectLocationIssueModelListCall), [*locations issue models patch*](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/api::ProjectLocationIssueModelPatchCall), [*locations issue models undeploy*](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/api::ProjectLocationIssueModelUndeployCall), [*locations operations cancel*](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/api::ProjectLocationOperationCancelCall), [*locations operations get*](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/api::ProjectLocationOperationGetCall), [*locations operations list*](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/api::ProjectLocationOperationListCall), [*locations phrase matchers create*](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/api::ProjectLocationPhraseMatcherCreateCall), [*locations phrase matchers delete*](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/api::ProjectLocationPhraseMatcherDeleteCall), [*locations phrase matchers get*](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/api::ProjectLocationPhraseMatcherGetCall), [*locations phrase matchers list*](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/api::ProjectLocationPhraseMatcherListCall), [*locations phrase matchers patch*](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/api::ProjectLocationPhraseMatcherPatchCall), [*locations update settings*](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/api::ProjectLocationUpdateSettingCall), [*locations views create*](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/api::ProjectLocationViewCreateCall), [*locations views delete*](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/api::ProjectLocationViewDeleteCall), [*locations views get*](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/api::ProjectLocationViewGetCall), [*locations views list*](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/api::ProjectLocationViewListCall) and [*locations views patch*](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/api::ProjectLocationViewPatchCall) @@ -58,8 +58,8 @@ let r = hub.projects().locations_issue_models_undeploy(...).doit().await let r = hub.projects().locations_operations_get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -87,12 +87,12 @@ use contactcenterinsights1::{Result, Error}; use std::default::Default; use contactcenterinsights1::{Contactcenterinsights, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -133,10 +133,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -146,25 +146,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-contac You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/client::Delegate) to the -[Method Builder](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/client::Delegate) to the +[Method Builder](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/client::RequestValue) and -[decodable](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/client::RequestValue) and +[decodable](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-contactcenterinsights1/5.0.3+20230115/google_contactcenterinsights1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -183,7 +183,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **contactcenterinsights1** library was generated by Sebastian Thiel, and is placed +The **contactcenterinsights1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/contactcenterinsights1/src/api.rs b/gen/contactcenterinsights1/src/api.rs index 0893984607..44591ce837 100644 --- a/gen/contactcenterinsights1/src/api.rs +++ b/gen/contactcenterinsights1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use contactcenterinsights1::{Contactcenterinsights, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/contactcenterinsights1/src/lib.rs b/gen/contactcenterinsights1/src/lib.rs index 8d5281f10a..97d4e5a0fa 100644 --- a/gen/contactcenterinsights1/src/lib.rs +++ b/gen/contactcenterinsights1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/contactcenterinsights1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Contactcenterinsights) ... +//! Handle the following *Resources* with ease from the central [hub](Contactcenterinsights) ... //! //! * projects //! * [*locations conversations analyses create*](api::ProjectLocationConversationAnalysisCreateCall), [*locations conversations analyses delete*](api::ProjectLocationConversationAnalysisDeleteCall), [*locations conversations analyses get*](api::ProjectLocationConversationAnalysisGetCall), [*locations conversations analyses list*](api::ProjectLocationConversationAnalysisListCall), [*locations conversations bulk analyze*](api::ProjectLocationConversationBulkAnalyzeCall), [*locations conversations calculate stats*](api::ProjectLocationConversationCalculateStatCall), [*locations conversations create*](api::ProjectLocationConversationCreateCall), [*locations conversations delete*](api::ProjectLocationConversationDeleteCall), [*locations conversations get*](api::ProjectLocationConversationGetCall), [*locations conversations ingest*](api::ProjectLocationConversationIngestCall), [*locations conversations list*](api::ProjectLocationConversationListCall), [*locations conversations patch*](api::ProjectLocationConversationPatchCall), [*locations get settings*](api::ProjectLocationGetSettingCall), [*locations insightsdata export*](api::ProjectLocationInsightsdataExportCall), [*locations issue models calculate issue model stats*](api::ProjectLocationIssueModelCalculateIssueModelStatCall), [*locations issue models create*](api::ProjectLocationIssueModelCreateCall), [*locations issue models delete*](api::ProjectLocationIssueModelDeleteCall), [*locations issue models deploy*](api::ProjectLocationIssueModelDeployCall), [*locations issue models get*](api::ProjectLocationIssueModelGetCall), [*locations issue models issues delete*](api::ProjectLocationIssueModelIssueDeleteCall), [*locations issue models issues get*](api::ProjectLocationIssueModelIssueGetCall), [*locations issue models issues list*](api::ProjectLocationIssueModelIssueListCall), [*locations issue models issues patch*](api::ProjectLocationIssueModelIssuePatchCall), [*locations issue models list*](api::ProjectLocationIssueModelListCall), [*locations issue models patch*](api::ProjectLocationIssueModelPatchCall), [*locations issue models undeploy*](api::ProjectLocationIssueModelUndeployCall), [*locations operations cancel*](api::ProjectLocationOperationCancelCall), [*locations operations get*](api::ProjectLocationOperationGetCall), [*locations operations list*](api::ProjectLocationOperationListCall), [*locations phrase matchers create*](api::ProjectLocationPhraseMatcherCreateCall), [*locations phrase matchers delete*](api::ProjectLocationPhraseMatcherDeleteCall), [*locations phrase matchers get*](api::ProjectLocationPhraseMatcherGetCall), [*locations phrase matchers list*](api::ProjectLocationPhraseMatcherListCall), [*locations phrase matchers patch*](api::ProjectLocationPhraseMatcherPatchCall), [*locations update settings*](api::ProjectLocationUpdateSettingCall), [*locations views create*](api::ProjectLocationViewCreateCall), [*locations views delete*](api::ProjectLocationViewDeleteCall), [*locations views get*](api::ProjectLocationViewGetCall), [*locations views list*](api::ProjectLocationViewListCall) and [*locations views patch*](api::ProjectLocationViewPatchCall) @@ -58,8 +58,8 @@ //! let r = hub.projects().locations_operations_get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -88,12 +88,12 @@ //! use std::default::Default; //! use contactcenterinsights1::{Contactcenterinsights, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -134,10 +134,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -147,25 +147,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/container1/README.md b/gen/container1/README.md index ba046d00a2..48a6e42ced 100644 --- a/gen/container1/README.md +++ b/gen/container1/README.md @@ -11,7 +11,7 @@ Everything else about the *Container* *v1* API can be found at the [official documentation site](https://cloud.google.com/container-engine/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-container1/5.0.3+20230104/google_container1/Container) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-container1/5.0.3+20230104/google_container1/Container) ... * projects * [*aggregated usable subnetworks list*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectAggregatedUsableSubnetworkListCall), [*locations clusters complete ip rotation*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectLocationClusterCompleteIpRotationCall), [*locations clusters create*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectLocationClusterCreateCall), [*locations clusters delete*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectLocationClusterDeleteCall), [*locations clusters get*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectLocationClusterGetCall), [*locations clusters get jwks*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectLocationClusterGetJwkCall), [*locations clusters list*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectLocationClusterListCall), [*locations clusters node pools complete upgrade*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectLocationClusterNodePoolCompleteUpgradeCall), [*locations clusters node pools create*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectLocationClusterNodePoolCreateCall), [*locations clusters node pools delete*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectLocationClusterNodePoolDeleteCall), [*locations clusters node pools get*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectLocationClusterNodePoolGetCall), [*locations clusters node pools list*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectLocationClusterNodePoolListCall), [*locations clusters node pools rollback*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectLocationClusterNodePoolRollbackCall), [*locations clusters node pools set autoscaling*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectLocationClusterNodePoolSetAutoscalingCall), [*locations clusters node pools set management*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectLocationClusterNodePoolSetManagementCall), [*locations clusters node pools set size*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectLocationClusterNodePoolSetSizeCall), [*locations clusters node pools update*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectLocationClusterNodePoolUpdateCall), [*locations clusters set addons*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectLocationClusterSetAddonCall), [*locations clusters set legacy abac*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectLocationClusterSetLegacyAbacCall), [*locations clusters set locations*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectLocationClusterSetLocationCall), [*locations clusters set logging*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectLocationClusterSetLoggingCall), [*locations clusters set maintenance policy*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectLocationClusterSetMaintenancePolicyCall), [*locations clusters set master auth*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectLocationClusterSetMasterAuthCall), [*locations clusters set monitoring*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectLocationClusterSetMonitoringCall), [*locations clusters set network policy*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectLocationClusterSetNetworkPolicyCall), [*locations clusters set resource labels*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectLocationClusterSetResourceLabelCall), [*locations clusters start ip rotation*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectLocationClusterStartIpRotationCall), [*locations clusters update*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectLocationClusterUpdateCall), [*locations clusters update master*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectLocationClusterUpdateMasterCall), [*locations clusters well-known get openid-configuration*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectLocationClusterWellKnownGetOpenidConfigurationCall), [*locations get server config*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectLocationGetServerConfigCall), [*locations operations cancel*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectLocationOperationCancelCall), [*locations operations get*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectLocationOperationGetCall), [*locations operations list*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectLocationOperationListCall), [*zones clusters addons*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectZoneClusterAddonCall), [*zones clusters complete ip rotation*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectZoneClusterCompleteIpRotationCall), [*zones clusters create*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectZoneClusterCreateCall), [*zones clusters delete*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectZoneClusterDeleteCall), [*zones clusters get*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectZoneClusterGetCall), [*zones clusters legacy abac*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectZoneClusterLegacyAbacCall), [*zones clusters list*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectZoneClusterListCall), [*zones clusters locations*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectZoneClusterLocationCall), [*zones clusters logging*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectZoneClusterLoggingCall), [*zones clusters master*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectZoneClusterMasterCall), [*zones clusters monitoring*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectZoneClusterMonitoringCall), [*zones clusters node pools autoscaling*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectZoneClusterNodePoolAutoscalingCall), [*zones clusters node pools create*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectZoneClusterNodePoolCreateCall), [*zones clusters node pools delete*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectZoneClusterNodePoolDeleteCall), [*zones clusters node pools get*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectZoneClusterNodePoolGetCall), [*zones clusters node pools list*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectZoneClusterNodePoolListCall), [*zones clusters node pools rollback*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectZoneClusterNodePoolRollbackCall), [*zones clusters node pools set management*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectZoneClusterNodePoolSetManagementCall), [*zones clusters node pools set size*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectZoneClusterNodePoolSetSizeCall), [*zones clusters node pools update*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectZoneClusterNodePoolUpdateCall), [*zones clusters resource labels*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectZoneClusterResourceLabelCall), [*zones clusters set maintenance policy*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectZoneClusterSetMaintenancePolicyCall), [*zones clusters set master auth*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectZoneClusterSetMasterAuthCall), [*zones clusters set network policy*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectZoneClusterSetNetworkPolicyCall), [*zones clusters start ip rotation*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectZoneClusterStartIpRotationCall), [*zones clusters update*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectZoneClusterUpdateCall), [*zones get serverconfig*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectZoneGetServerconfigCall), [*zones operations cancel*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectZoneOperationCancelCall), [*zones operations get*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectZoneOperationGetCall) and [*zones operations list*](https://docs.rs/google-container1/5.0.3+20230104/google_container1/api::ProjectZoneOperationListCall) @@ -95,8 +95,8 @@ let r = hub.projects().zones_clusters_update(...).doit().await let r = hub.projects().zones_operations_get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -123,12 +123,12 @@ use container1::{Result, Error}; use std::default::Default; use container1::{Container, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -168,10 +168,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-container1/5.0.3+20230104/google_container1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-container1/5.0.3+20230104/google_container1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -181,25 +181,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-contai You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-container1/5.0.3+20230104/google_container1/client::Delegate) to the -[Method Builder](https://docs.rs/google-container1/5.0.3+20230104/google_container1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-container1/5.0.3+20230104/google_container1/client::Delegate) to the +[Method Builder](https://docs.rs/google-container1/5.0.3+20230104/google_container1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-container1/5.0.3+20230104/google_container1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-container1/5.0.3+20230104/google_container1/client::RequestValue) and -[decodable](https://docs.rs/google-container1/5.0.3+20230104/google_container1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-container1/5.0.3+20230104/google_container1/client::RequestValue) and +[decodable](https://docs.rs/google-container1/5.0.3+20230104/google_container1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-container1/5.0.3+20230104/google_container1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-container1/5.0.3+20230104/google_container1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -218,7 +218,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **container1** library was generated by Sebastian Thiel, and is placed +The **container1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/container1/src/api.rs b/gen/container1/src/api.rs index 0a40be8b16..48295c037f 100644 --- a/gen/container1/src/api.rs +++ b/gen/container1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use container1::{Container, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/container1/src/lib.rs b/gen/container1/src/lib.rs index d20769f8e5..e26b1d26ef 100644 --- a/gen/container1/src/lib.rs +++ b/gen/container1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/container1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Container) ... +//! Handle the following *Resources* with ease from the central [hub](Container) ... //! //! * projects //! * [*aggregated usable subnetworks list*](api::ProjectAggregatedUsableSubnetworkListCall), [*locations clusters complete ip rotation*](api::ProjectLocationClusterCompleteIpRotationCall), [*locations clusters create*](api::ProjectLocationClusterCreateCall), [*locations clusters delete*](api::ProjectLocationClusterDeleteCall), [*locations clusters get*](api::ProjectLocationClusterGetCall), [*locations clusters get jwks*](api::ProjectLocationClusterGetJwkCall), [*locations clusters list*](api::ProjectLocationClusterListCall), [*locations clusters node pools complete upgrade*](api::ProjectLocationClusterNodePoolCompleteUpgradeCall), [*locations clusters node pools create*](api::ProjectLocationClusterNodePoolCreateCall), [*locations clusters node pools delete*](api::ProjectLocationClusterNodePoolDeleteCall), [*locations clusters node pools get*](api::ProjectLocationClusterNodePoolGetCall), [*locations clusters node pools list*](api::ProjectLocationClusterNodePoolListCall), [*locations clusters node pools rollback*](api::ProjectLocationClusterNodePoolRollbackCall), [*locations clusters node pools set autoscaling*](api::ProjectLocationClusterNodePoolSetAutoscalingCall), [*locations clusters node pools set management*](api::ProjectLocationClusterNodePoolSetManagementCall), [*locations clusters node pools set size*](api::ProjectLocationClusterNodePoolSetSizeCall), [*locations clusters node pools update*](api::ProjectLocationClusterNodePoolUpdateCall), [*locations clusters set addons*](api::ProjectLocationClusterSetAddonCall), [*locations clusters set legacy abac*](api::ProjectLocationClusterSetLegacyAbacCall), [*locations clusters set locations*](api::ProjectLocationClusterSetLocationCall), [*locations clusters set logging*](api::ProjectLocationClusterSetLoggingCall), [*locations clusters set maintenance policy*](api::ProjectLocationClusterSetMaintenancePolicyCall), [*locations clusters set master auth*](api::ProjectLocationClusterSetMasterAuthCall), [*locations clusters set monitoring*](api::ProjectLocationClusterSetMonitoringCall), [*locations clusters set network policy*](api::ProjectLocationClusterSetNetworkPolicyCall), [*locations clusters set resource labels*](api::ProjectLocationClusterSetResourceLabelCall), [*locations clusters start ip rotation*](api::ProjectLocationClusterStartIpRotationCall), [*locations clusters update*](api::ProjectLocationClusterUpdateCall), [*locations clusters update master*](api::ProjectLocationClusterUpdateMasterCall), [*locations clusters well-known get openid-configuration*](api::ProjectLocationClusterWellKnownGetOpenidConfigurationCall), [*locations get server config*](api::ProjectLocationGetServerConfigCall), [*locations operations cancel*](api::ProjectLocationOperationCancelCall), [*locations operations get*](api::ProjectLocationOperationGetCall), [*locations operations list*](api::ProjectLocationOperationListCall), [*zones clusters addons*](api::ProjectZoneClusterAddonCall), [*zones clusters complete ip rotation*](api::ProjectZoneClusterCompleteIpRotationCall), [*zones clusters create*](api::ProjectZoneClusterCreateCall), [*zones clusters delete*](api::ProjectZoneClusterDeleteCall), [*zones clusters get*](api::ProjectZoneClusterGetCall), [*zones clusters legacy abac*](api::ProjectZoneClusterLegacyAbacCall), [*zones clusters list*](api::ProjectZoneClusterListCall), [*zones clusters locations*](api::ProjectZoneClusterLocationCall), [*zones clusters logging*](api::ProjectZoneClusterLoggingCall), [*zones clusters master*](api::ProjectZoneClusterMasterCall), [*zones clusters monitoring*](api::ProjectZoneClusterMonitoringCall), [*zones clusters node pools autoscaling*](api::ProjectZoneClusterNodePoolAutoscalingCall), [*zones clusters node pools create*](api::ProjectZoneClusterNodePoolCreateCall), [*zones clusters node pools delete*](api::ProjectZoneClusterNodePoolDeleteCall), [*zones clusters node pools get*](api::ProjectZoneClusterNodePoolGetCall), [*zones clusters node pools list*](api::ProjectZoneClusterNodePoolListCall), [*zones clusters node pools rollback*](api::ProjectZoneClusterNodePoolRollbackCall), [*zones clusters node pools set management*](api::ProjectZoneClusterNodePoolSetManagementCall), [*zones clusters node pools set size*](api::ProjectZoneClusterNodePoolSetSizeCall), [*zones clusters node pools update*](api::ProjectZoneClusterNodePoolUpdateCall), [*zones clusters resource labels*](api::ProjectZoneClusterResourceLabelCall), [*zones clusters set maintenance policy*](api::ProjectZoneClusterSetMaintenancePolicyCall), [*zones clusters set master auth*](api::ProjectZoneClusterSetMasterAuthCall), [*zones clusters set network policy*](api::ProjectZoneClusterSetNetworkPolicyCall), [*zones clusters start ip rotation*](api::ProjectZoneClusterStartIpRotationCall), [*zones clusters update*](api::ProjectZoneClusterUpdateCall), [*zones get serverconfig*](api::ProjectZoneGetServerconfigCall), [*zones operations cancel*](api::ProjectZoneOperationCancelCall), [*zones operations get*](api::ProjectZoneOperationGetCall) and [*zones operations list*](api::ProjectZoneOperationListCall) @@ -95,8 +95,8 @@ //! let r = hub.projects().zones_operations_get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -124,12 +124,12 @@ //! use std::default::Default; //! use container1::{Container, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -169,10 +169,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -182,25 +182,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/containeranalysis1/README.md b/gen/containeranalysis1/README.md index 7ae12090dc..ef246a4540 100644 --- a/gen/containeranalysis1/README.md +++ b/gen/containeranalysis1/README.md @@ -11,7 +11,7 @@ Everything else about the *Container Analysis* *v1* API can be found at the [official documentation site](https://cloud.google.com/container-analysis/api/reference/rest/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-containeranalysis1/5.0.3+20230106/google_containeranalysis1/ContainerAnalysis) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-containeranalysis1/5.0.3+20230106/google_containeranalysis1/ContainerAnalysis) ... * projects * [*notes batch create*](https://docs.rs/google-containeranalysis1/5.0.3+20230106/google_containeranalysis1/api::ProjectNoteBatchCreateCall), [*notes create*](https://docs.rs/google-containeranalysis1/5.0.3+20230106/google_containeranalysis1/api::ProjectNoteCreateCall), [*notes delete*](https://docs.rs/google-containeranalysis1/5.0.3+20230106/google_containeranalysis1/api::ProjectNoteDeleteCall), [*notes get*](https://docs.rs/google-containeranalysis1/5.0.3+20230106/google_containeranalysis1/api::ProjectNoteGetCall), [*notes get iam policy*](https://docs.rs/google-containeranalysis1/5.0.3+20230106/google_containeranalysis1/api::ProjectNoteGetIamPolicyCall), [*notes list*](https://docs.rs/google-containeranalysis1/5.0.3+20230106/google_containeranalysis1/api::ProjectNoteListCall), [*notes occurrences list*](https://docs.rs/google-containeranalysis1/5.0.3+20230106/google_containeranalysis1/api::ProjectNoteOccurrenceListCall), [*notes patch*](https://docs.rs/google-containeranalysis1/5.0.3+20230106/google_containeranalysis1/api::ProjectNotePatchCall), [*notes set iam policy*](https://docs.rs/google-containeranalysis1/5.0.3+20230106/google_containeranalysis1/api::ProjectNoteSetIamPolicyCall), [*notes test iam permissions*](https://docs.rs/google-containeranalysis1/5.0.3+20230106/google_containeranalysis1/api::ProjectNoteTestIamPermissionCall), [*occurrences batch create*](https://docs.rs/google-containeranalysis1/5.0.3+20230106/google_containeranalysis1/api::ProjectOccurrenceBatchCreateCall), [*occurrences create*](https://docs.rs/google-containeranalysis1/5.0.3+20230106/google_containeranalysis1/api::ProjectOccurrenceCreateCall), [*occurrences delete*](https://docs.rs/google-containeranalysis1/5.0.3+20230106/google_containeranalysis1/api::ProjectOccurrenceDeleteCall), [*occurrences get*](https://docs.rs/google-containeranalysis1/5.0.3+20230106/google_containeranalysis1/api::ProjectOccurrenceGetCall), [*occurrences get iam policy*](https://docs.rs/google-containeranalysis1/5.0.3+20230106/google_containeranalysis1/api::ProjectOccurrenceGetIamPolicyCall), [*occurrences get notes*](https://docs.rs/google-containeranalysis1/5.0.3+20230106/google_containeranalysis1/api::ProjectOccurrenceGetNoteCall), [*occurrences get vulnerability summary*](https://docs.rs/google-containeranalysis1/5.0.3+20230106/google_containeranalysis1/api::ProjectOccurrenceGetVulnerabilitySummaryCall), [*occurrences list*](https://docs.rs/google-containeranalysis1/5.0.3+20230106/google_containeranalysis1/api::ProjectOccurrenceListCall), [*occurrences patch*](https://docs.rs/google-containeranalysis1/5.0.3+20230106/google_containeranalysis1/api::ProjectOccurrencePatchCall), [*occurrences set iam policy*](https://docs.rs/google-containeranalysis1/5.0.3+20230106/google_containeranalysis1/api::ProjectOccurrenceSetIamPolicyCall) and [*occurrences test iam permissions*](https://docs.rs/google-containeranalysis1/5.0.3+20230106/google_containeranalysis1/api::ProjectOccurrenceTestIamPermissionCall) @@ -53,8 +53,8 @@ let r = hub.projects().notes_patch(...).doit().await let r = hub.projects().occurrences_get_notes(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -82,12 +82,12 @@ use containeranalysis1::{Result, Error}; use std::default::Default; use containeranalysis1::{ContainerAnalysis, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -129,10 +129,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-containeranalysis1/5.0.3+20230106/google_containeranalysis1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-containeranalysis1/5.0.3+20230106/google_containeranalysis1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -142,25 +142,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-contai You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-containeranalysis1/5.0.3+20230106/google_containeranalysis1/client::Delegate) to the -[Method Builder](https://docs.rs/google-containeranalysis1/5.0.3+20230106/google_containeranalysis1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-containeranalysis1/5.0.3+20230106/google_containeranalysis1/client::Delegate) to the +[Method Builder](https://docs.rs/google-containeranalysis1/5.0.3+20230106/google_containeranalysis1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-containeranalysis1/5.0.3+20230106/google_containeranalysis1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-containeranalysis1/5.0.3+20230106/google_containeranalysis1/client::RequestValue) and -[decodable](https://docs.rs/google-containeranalysis1/5.0.3+20230106/google_containeranalysis1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-containeranalysis1/5.0.3+20230106/google_containeranalysis1/client::RequestValue) and +[decodable](https://docs.rs/google-containeranalysis1/5.0.3+20230106/google_containeranalysis1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-containeranalysis1/5.0.3+20230106/google_containeranalysis1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-containeranalysis1/5.0.3+20230106/google_containeranalysis1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -179,7 +179,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **containeranalysis1** library was generated by Sebastian Thiel, and is placed +The **containeranalysis1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/containeranalysis1/src/api.rs b/gen/containeranalysis1/src/api.rs index 29b26f0211..8387d444d8 100644 --- a/gen/containeranalysis1/src/api.rs +++ b/gen/containeranalysis1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use containeranalysis1::{ContainerAnalysis, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/containeranalysis1/src/lib.rs b/gen/containeranalysis1/src/lib.rs index 97de62aaba..4bffba12d4 100644 --- a/gen/containeranalysis1/src/lib.rs +++ b/gen/containeranalysis1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/containeranalysis1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](ContainerAnalysis) ... +//! Handle the following *Resources* with ease from the central [hub](ContainerAnalysis) ... //! //! * projects //! * [*notes batch create*](api::ProjectNoteBatchCreateCall), [*notes create*](api::ProjectNoteCreateCall), [*notes delete*](api::ProjectNoteDeleteCall), [*notes get*](api::ProjectNoteGetCall), [*notes get iam policy*](api::ProjectNoteGetIamPolicyCall), [*notes list*](api::ProjectNoteListCall), [*notes occurrences list*](api::ProjectNoteOccurrenceListCall), [*notes patch*](api::ProjectNotePatchCall), [*notes set iam policy*](api::ProjectNoteSetIamPolicyCall), [*notes test iam permissions*](api::ProjectNoteTestIamPermissionCall), [*occurrences batch create*](api::ProjectOccurrenceBatchCreateCall), [*occurrences create*](api::ProjectOccurrenceCreateCall), [*occurrences delete*](api::ProjectOccurrenceDeleteCall), [*occurrences get*](api::ProjectOccurrenceGetCall), [*occurrences get iam policy*](api::ProjectOccurrenceGetIamPolicyCall), [*occurrences get notes*](api::ProjectOccurrenceGetNoteCall), [*occurrences get vulnerability summary*](api::ProjectOccurrenceGetVulnerabilitySummaryCall), [*occurrences list*](api::ProjectOccurrenceListCall), [*occurrences patch*](api::ProjectOccurrencePatchCall), [*occurrences set iam policy*](api::ProjectOccurrenceSetIamPolicyCall) and [*occurrences test iam permissions*](api::ProjectOccurrenceTestIamPermissionCall) @@ -53,8 +53,8 @@ //! let r = hub.projects().occurrences_get_notes(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -83,12 +83,12 @@ //! use std::default::Default; //! use containeranalysis1::{ContainerAnalysis, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -130,10 +130,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -143,25 +143,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/containeranalysis1_beta1/README.md b/gen/containeranalysis1_beta1/README.md index ecd8ad931a..c9e70b49ae 100644 --- a/gen/containeranalysis1_beta1/README.md +++ b/gen/containeranalysis1_beta1/README.md @@ -11,7 +11,7 @@ Everything else about the *Container Analysis* *v1_beta1* API can be found at th [official documentation site](https://cloud.google.com/container-analysis/api/reference/rest/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-containeranalysis1_beta1/5.0.3+20230106/google_containeranalysis1_beta1/ContainerAnalysis) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-containeranalysis1_beta1/5.0.3+20230106/google_containeranalysis1_beta1/ContainerAnalysis) ... * projects * [*notes batch create*](https://docs.rs/google-containeranalysis1_beta1/5.0.3+20230106/google_containeranalysis1_beta1/api::ProjectNoteBatchCreateCall), [*notes create*](https://docs.rs/google-containeranalysis1_beta1/5.0.3+20230106/google_containeranalysis1_beta1/api::ProjectNoteCreateCall), [*notes delete*](https://docs.rs/google-containeranalysis1_beta1/5.0.3+20230106/google_containeranalysis1_beta1/api::ProjectNoteDeleteCall), [*notes get*](https://docs.rs/google-containeranalysis1_beta1/5.0.3+20230106/google_containeranalysis1_beta1/api::ProjectNoteGetCall), [*notes get iam policy*](https://docs.rs/google-containeranalysis1_beta1/5.0.3+20230106/google_containeranalysis1_beta1/api::ProjectNoteGetIamPolicyCall), [*notes list*](https://docs.rs/google-containeranalysis1_beta1/5.0.3+20230106/google_containeranalysis1_beta1/api::ProjectNoteListCall), [*notes occurrences list*](https://docs.rs/google-containeranalysis1_beta1/5.0.3+20230106/google_containeranalysis1_beta1/api::ProjectNoteOccurrenceListCall), [*notes patch*](https://docs.rs/google-containeranalysis1_beta1/5.0.3+20230106/google_containeranalysis1_beta1/api::ProjectNotePatchCall), [*notes set iam policy*](https://docs.rs/google-containeranalysis1_beta1/5.0.3+20230106/google_containeranalysis1_beta1/api::ProjectNoteSetIamPolicyCall), [*notes test iam permissions*](https://docs.rs/google-containeranalysis1_beta1/5.0.3+20230106/google_containeranalysis1_beta1/api::ProjectNoteTestIamPermissionCall), [*occurrences batch create*](https://docs.rs/google-containeranalysis1_beta1/5.0.3+20230106/google_containeranalysis1_beta1/api::ProjectOccurrenceBatchCreateCall), [*occurrences create*](https://docs.rs/google-containeranalysis1_beta1/5.0.3+20230106/google_containeranalysis1_beta1/api::ProjectOccurrenceCreateCall), [*occurrences delete*](https://docs.rs/google-containeranalysis1_beta1/5.0.3+20230106/google_containeranalysis1_beta1/api::ProjectOccurrenceDeleteCall), [*occurrences get*](https://docs.rs/google-containeranalysis1_beta1/5.0.3+20230106/google_containeranalysis1_beta1/api::ProjectOccurrenceGetCall), [*occurrences get iam policy*](https://docs.rs/google-containeranalysis1_beta1/5.0.3+20230106/google_containeranalysis1_beta1/api::ProjectOccurrenceGetIamPolicyCall), [*occurrences get notes*](https://docs.rs/google-containeranalysis1_beta1/5.0.3+20230106/google_containeranalysis1_beta1/api::ProjectOccurrenceGetNoteCall), [*occurrences get vulnerability summary*](https://docs.rs/google-containeranalysis1_beta1/5.0.3+20230106/google_containeranalysis1_beta1/api::ProjectOccurrenceGetVulnerabilitySummaryCall), [*occurrences list*](https://docs.rs/google-containeranalysis1_beta1/5.0.3+20230106/google_containeranalysis1_beta1/api::ProjectOccurrenceListCall), [*occurrences patch*](https://docs.rs/google-containeranalysis1_beta1/5.0.3+20230106/google_containeranalysis1_beta1/api::ProjectOccurrencePatchCall), [*occurrences set iam policy*](https://docs.rs/google-containeranalysis1_beta1/5.0.3+20230106/google_containeranalysis1_beta1/api::ProjectOccurrenceSetIamPolicyCall) and [*occurrences test iam permissions*](https://docs.rs/google-containeranalysis1_beta1/5.0.3+20230106/google_containeranalysis1_beta1/api::ProjectOccurrenceTestIamPermissionCall) @@ -53,8 +53,8 @@ let r = hub.projects().notes_patch(...).doit().await let r = hub.projects().occurrences_get_notes(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -82,12 +82,12 @@ use containeranalysis1_beta1::{Result, Error}; use std::default::Default; use containeranalysis1_beta1::{ContainerAnalysis, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -129,10 +129,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-containeranalysis1_beta1/5.0.3+20230106/google_containeranalysis1_beta1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-containeranalysis1_beta1/5.0.3+20230106/google_containeranalysis1_beta1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -142,25 +142,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-contai You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-containeranalysis1_beta1/5.0.3+20230106/google_containeranalysis1_beta1/client::Delegate) to the -[Method Builder](https://docs.rs/google-containeranalysis1_beta1/5.0.3+20230106/google_containeranalysis1_beta1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-containeranalysis1_beta1/5.0.3+20230106/google_containeranalysis1_beta1/client::Delegate) to the +[Method Builder](https://docs.rs/google-containeranalysis1_beta1/5.0.3+20230106/google_containeranalysis1_beta1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-containeranalysis1_beta1/5.0.3+20230106/google_containeranalysis1_beta1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-containeranalysis1_beta1/5.0.3+20230106/google_containeranalysis1_beta1/client::RequestValue) and -[decodable](https://docs.rs/google-containeranalysis1_beta1/5.0.3+20230106/google_containeranalysis1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-containeranalysis1_beta1/5.0.3+20230106/google_containeranalysis1_beta1/client::RequestValue) and +[decodable](https://docs.rs/google-containeranalysis1_beta1/5.0.3+20230106/google_containeranalysis1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-containeranalysis1_beta1/5.0.3+20230106/google_containeranalysis1_beta1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-containeranalysis1_beta1/5.0.3+20230106/google_containeranalysis1_beta1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -179,7 +179,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **containeranalysis1_beta1** library was generated by Sebastian Thiel, and is placed +The **containeranalysis1_beta1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/containeranalysis1_beta1/src/api.rs b/gen/containeranalysis1_beta1/src/api.rs index 1f1f87f14e..79648f2853 100644 --- a/gen/containeranalysis1_beta1/src/api.rs +++ b/gen/containeranalysis1_beta1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use containeranalysis1_beta1::{ContainerAnalysis, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/containeranalysis1_beta1/src/lib.rs b/gen/containeranalysis1_beta1/src/lib.rs index 12d34f21bc..9af131d923 100644 --- a/gen/containeranalysis1_beta1/src/lib.rs +++ b/gen/containeranalysis1_beta1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/containeranalysis1_beta1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](ContainerAnalysis) ... +//! Handle the following *Resources* with ease from the central [hub](ContainerAnalysis) ... //! //! * projects //! * [*notes batch create*](api::ProjectNoteBatchCreateCall), [*notes create*](api::ProjectNoteCreateCall), [*notes delete*](api::ProjectNoteDeleteCall), [*notes get*](api::ProjectNoteGetCall), [*notes get iam policy*](api::ProjectNoteGetIamPolicyCall), [*notes list*](api::ProjectNoteListCall), [*notes occurrences list*](api::ProjectNoteOccurrenceListCall), [*notes patch*](api::ProjectNotePatchCall), [*notes set iam policy*](api::ProjectNoteSetIamPolicyCall), [*notes test iam permissions*](api::ProjectNoteTestIamPermissionCall), [*occurrences batch create*](api::ProjectOccurrenceBatchCreateCall), [*occurrences create*](api::ProjectOccurrenceCreateCall), [*occurrences delete*](api::ProjectOccurrenceDeleteCall), [*occurrences get*](api::ProjectOccurrenceGetCall), [*occurrences get iam policy*](api::ProjectOccurrenceGetIamPolicyCall), [*occurrences get notes*](api::ProjectOccurrenceGetNoteCall), [*occurrences get vulnerability summary*](api::ProjectOccurrenceGetVulnerabilitySummaryCall), [*occurrences list*](api::ProjectOccurrenceListCall), [*occurrences patch*](api::ProjectOccurrencePatchCall), [*occurrences set iam policy*](api::ProjectOccurrenceSetIamPolicyCall) and [*occurrences test iam permissions*](api::ProjectOccurrenceTestIamPermissionCall) @@ -53,8 +53,8 @@ //! let r = hub.projects().occurrences_get_notes(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -83,12 +83,12 @@ //! use std::default::Default; //! use containeranalysis1_beta1::{ContainerAnalysis, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -130,10 +130,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -143,25 +143,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/content2/README.md b/gen/content2/README.md index c17b97cd53..c59365380f 100644 --- a/gen/content2/README.md +++ b/gen/content2/README.md @@ -11,7 +11,7 @@ Everything else about the *Shopping Content* *v2* API can be found at the [official documentation site](https://developers.google.com/shopping-content/v2/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-content2/5.0.3+20220303/google_content2/ShoppingContent) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-content2/5.0.3+20220303/google_content2/ShoppingContent) ... * [accounts](https://docs.rs/google-content2/5.0.3+20220303/google_content2/api::Account) * [*authinfo*](https://docs.rs/google-content2/5.0.3+20220303/google_content2/api::AccountAuthinfoCall), [*claimwebsite*](https://docs.rs/google-content2/5.0.3+20220303/google_content2/api::AccountClaimwebsiteCall), [*custombatch*](https://docs.rs/google-content2/5.0.3+20220303/google_content2/api::AccountCustombatchCall), [*delete*](https://docs.rs/google-content2/5.0.3+20220303/google_content2/api::AccountDeleteCall), [*get*](https://docs.rs/google-content2/5.0.3+20220303/google_content2/api::AccountGetCall), [*insert*](https://docs.rs/google-content2/5.0.3+20220303/google_content2/api::AccountInsertCall), [*link*](https://docs.rs/google-content2/5.0.3+20220303/google_content2/api::AccountLinkCall), [*list*](https://docs.rs/google-content2/5.0.3+20220303/google_content2/api::AccountListCall) and [*update*](https://docs.rs/google-content2/5.0.3+20220303/google_content2/api::AccountUpdateCall) @@ -99,8 +99,8 @@ let r = hub.orders().updatemerchantorderid(...).doit().await let r = hub.orders().updateshipment(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -127,12 +127,12 @@ use content2::{Result, Error}; use std::default::Default; use content2::{ShoppingContent, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -175,10 +175,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-content2/5.0.3+20220303/google_content2/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-content2/5.0.3+20220303/google_content2/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -188,25 +188,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-conten You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-content2/5.0.3+20220303/google_content2/client::Delegate) to the -[Method Builder](https://docs.rs/google-content2/5.0.3+20220303/google_content2/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-content2/5.0.3+20220303/google_content2/client::Delegate) to the +[Method Builder](https://docs.rs/google-content2/5.0.3+20220303/google_content2/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-content2/5.0.3+20220303/google_content2/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-content2/5.0.3+20220303/google_content2/client::RequestValue) and -[decodable](https://docs.rs/google-content2/5.0.3+20220303/google_content2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-content2/5.0.3+20220303/google_content2/client::RequestValue) and +[decodable](https://docs.rs/google-content2/5.0.3+20220303/google_content2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-content2/5.0.3+20220303/google_content2/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-content2/5.0.3+20220303/google_content2/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -225,7 +225,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **content2** library was generated by Sebastian Thiel, and is placed +The **content2** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/content2/src/api.rs b/gen/content2/src/api.rs index 8bf569404c..78a9877aad 100644 --- a/gen/content2/src/api.rs +++ b/gen/content2/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// Manage your product listings and accounts for Google Shopping Full, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use content2::{ShoppingContent, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/content2/src/lib.rs b/gen/content2/src/lib.rs index 3b37990cfa..ff8fb3f215 100644 --- a/gen/content2/src/lib.rs +++ b/gen/content2/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/content2). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](ShoppingContent) ... +//! Handle the following *Resources* with ease from the central [hub](ShoppingContent) ... //! //! * [accounts](api::Account) //! * [*authinfo*](api::AccountAuthinfoCall), [*claimwebsite*](api::AccountClaimwebsiteCall), [*custombatch*](api::AccountCustombatchCall), [*delete*](api::AccountDeleteCall), [*get*](api::AccountGetCall), [*insert*](api::AccountInsertCall), [*link*](api::AccountLinkCall), [*list*](api::AccountListCall) and [*update*](api::AccountUpdateCall) @@ -99,8 +99,8 @@ //! let r = hub.orders().updateshipment(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -128,12 +128,12 @@ //! use std::default::Default; //! use content2::{ShoppingContent, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -176,10 +176,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -189,25 +189,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/content2_sandbox/README.md b/gen/content2_sandbox/README.md index 7d5f2764a9..52dc026614 100644 --- a/gen/content2_sandbox/README.md +++ b/gen/content2_sandbox/README.md @@ -11,7 +11,7 @@ Everything else about the *Shopping Content* *v2_sandbox* API can be found at th [official documentation site](https://developers.google.com/shopping-content). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-content2_sandbox/5.0.3+20181009/google_content2_sandbox/ShoppingContent) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-content2_sandbox/5.0.3+20181009/google_content2_sandbox/ShoppingContent) ... * orderinvoices * [*createchargeinvoice*](https://docs.rs/google-content2_sandbox/5.0.3+20181009/google_content2_sandbox/api::OrderinvoiceCreatechargeinvoiceCall) and [*createrefundinvoice*](https://docs.rs/google-content2_sandbox/5.0.3+20181009/google_content2_sandbox/api::OrderinvoiceCreaterefundinvoiceCall) @@ -77,8 +77,8 @@ let r = hub.orders().updatemerchantorderid(...).doit().await let r = hub.orders().updateshipment(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -105,12 +105,12 @@ use content2_sandbox::{Result, Error}; use std::default::Default; use content2_sandbox::{ShoppingContent, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -153,10 +153,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-content2_sandbox/5.0.3+20181009/google_content2_sandbox/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-content2_sandbox/5.0.3+20181009/google_content2_sandbox/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -166,25 +166,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-conten You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-content2_sandbox/5.0.3+20181009/google_content2_sandbox/client::Delegate) to the -[Method Builder](https://docs.rs/google-content2_sandbox/5.0.3+20181009/google_content2_sandbox/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-content2_sandbox/5.0.3+20181009/google_content2_sandbox/client::Delegate) to the +[Method Builder](https://docs.rs/google-content2_sandbox/5.0.3+20181009/google_content2_sandbox/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-content2_sandbox/5.0.3+20181009/google_content2_sandbox/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-content2_sandbox/5.0.3+20181009/google_content2_sandbox/client::RequestValue) and -[decodable](https://docs.rs/google-content2_sandbox/5.0.3+20181009/google_content2_sandbox/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-content2_sandbox/5.0.3+20181009/google_content2_sandbox/client::RequestValue) and +[decodable](https://docs.rs/google-content2_sandbox/5.0.3+20181009/google_content2_sandbox/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-content2_sandbox/5.0.3+20181009/google_content2_sandbox/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-content2_sandbox/5.0.3+20181009/google_content2_sandbox/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -203,7 +203,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **content2_sandbox** library was generated by Sebastian Thiel, and is placed +The **content2_sandbox** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/content2_sandbox/src/api.rs b/gen/content2_sandbox/src/api.rs index f8a1f39bf0..0411fe5933 100644 --- a/gen/content2_sandbox/src/api.rs +++ b/gen/content2_sandbox/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// Manage your product listings and accounts for Google Shopping Full, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use content2_sandbox::{ShoppingContent, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/content2_sandbox/src/lib.rs b/gen/content2_sandbox/src/lib.rs index 0f4a8d7ce5..2feeeb7f4d 100644 --- a/gen/content2_sandbox/src/lib.rs +++ b/gen/content2_sandbox/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/content2_sandbox). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](ShoppingContent) ... +//! Handle the following *Resources* with ease from the central [hub](ShoppingContent) ... //! //! * orderinvoices //! * [*createchargeinvoice*](api::OrderinvoiceCreatechargeinvoiceCall) and [*createrefundinvoice*](api::OrderinvoiceCreaterefundinvoiceCall) @@ -77,8 +77,8 @@ //! let r = hub.orders().updateshipment(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -106,12 +106,12 @@ //! use std::default::Default; //! use content2_sandbox::{ShoppingContent, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -154,10 +154,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -167,25 +167,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/coordinate1/README.md b/gen/coordinate1/README.md index f1b45a70a2..21c50e6aac 100644 --- a/gen/coordinate1/README.md +++ b/gen/coordinate1/README.md @@ -11,7 +11,7 @@ Everything else about the *coordinate* *v1* API can be found at the [official documentation site](https://developers.google.com/coordinate/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-coordinate1/5.0.3+20150811/google_coordinate1/Coordinate) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-coordinate1/5.0.3+20150811/google_coordinate1/Coordinate) ... * [custom field def](https://docs.rs/google-coordinate1/5.0.3+20150811/google_coordinate1/api::CustomFieldDef) * [*list*](https://docs.rs/google-coordinate1/5.0.3+20150811/google_coordinate1/api::CustomFieldDefListCall) @@ -64,8 +64,8 @@ let r = hub.jobs().patch(...).doit().await let r = hub.jobs().update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -93,12 +93,12 @@ use coordinate1::{Result, Error}; use std::default::Default; use coordinate1::{Coordinate, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -149,10 +149,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-coordinate1/5.0.3+20150811/google_coordinate1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-coordinate1/5.0.3+20150811/google_coordinate1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -162,25 +162,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-coordi You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-coordinate1/5.0.3+20150811/google_coordinate1/client::Delegate) to the -[Method Builder](https://docs.rs/google-coordinate1/5.0.3+20150811/google_coordinate1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-coordinate1/5.0.3+20150811/google_coordinate1/client::Delegate) to the +[Method Builder](https://docs.rs/google-coordinate1/5.0.3+20150811/google_coordinate1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-coordinate1/5.0.3+20150811/google_coordinate1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-coordinate1/5.0.3+20150811/google_coordinate1/client::RequestValue) and -[decodable](https://docs.rs/google-coordinate1/5.0.3+20150811/google_coordinate1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-coordinate1/5.0.3+20150811/google_coordinate1/client::RequestValue) and +[decodable](https://docs.rs/google-coordinate1/5.0.3+20150811/google_coordinate1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-coordinate1/5.0.3+20150811/google_coordinate1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-coordinate1/5.0.3+20150811/google_coordinate1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -199,7 +199,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **coordinate1** library was generated by Sebastian Thiel, and is placed +The **coordinate1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/coordinate1/src/api.rs b/gen/coordinate1/src/api.rs index 1c5309ef34..547409d12d 100644 --- a/gen/coordinate1/src/api.rs +++ b/gen/coordinate1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your Google Maps Coordinate jobs Full, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use coordinate1::{Coordinate, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/coordinate1/src/lib.rs b/gen/coordinate1/src/lib.rs index c7e84e4070..2fed88f909 100644 --- a/gen/coordinate1/src/lib.rs +++ b/gen/coordinate1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/coordinate1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Coordinate) ... +//! Handle the following *Resources* with ease from the central [hub](Coordinate) ... //! //! * [custom field def](api::CustomFieldDef) //! * [*list*](api::CustomFieldDefListCall) @@ -64,8 +64,8 @@ //! let r = hub.jobs().update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -94,12 +94,12 @@ //! use std::default::Default; //! use coordinate1::{Coordinate, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -150,10 +150,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -163,25 +163,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/customsearch1/README.md b/gen/customsearch1/README.md index 005fe32eab..1d777d6eb3 100644 --- a/gen/customsearch1/README.md +++ b/gen/customsearch1/README.md @@ -11,7 +11,7 @@ Everything else about the *CustomSearch API* *v1* API can be found at the [official documentation site](https://developers.google.com/custom-search/v1/introduction). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-customsearch1/5.0.3+20230123/google_customsearch1/CustomSearchAPI) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-customsearch1/5.0.3+20230123/google_customsearch1/CustomSearchAPI) ... * cse * [*list*](https://docs.rs/google-customsearch1/5.0.3+20230123/google_customsearch1/api::CseListCall) and [*siterestrict list*](https://docs.rs/google-customsearch1/5.0.3+20230123/google_customsearch1/api::CseSiterestrictListCall) @@ -51,8 +51,8 @@ let r = hub.cse().siterestrict_list(...).doit().await let r = hub.cse().list(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -79,12 +79,12 @@ use customsearch1::{Result, Error}; use std::default::Default; use customsearch1::{CustomSearchAPI, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -151,10 +151,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-customsearch1/5.0.3+20230123/google_customsearch1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-customsearch1/5.0.3+20230123/google_customsearch1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -164,25 +164,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-custom You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-customsearch1/5.0.3+20230123/google_customsearch1/client::Delegate) to the -[Method Builder](https://docs.rs/google-customsearch1/5.0.3+20230123/google_customsearch1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-customsearch1/5.0.3+20230123/google_customsearch1/client::Delegate) to the +[Method Builder](https://docs.rs/google-customsearch1/5.0.3+20230123/google_customsearch1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-customsearch1/5.0.3+20230123/google_customsearch1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-customsearch1/5.0.3+20230123/google_customsearch1/client::RequestValue) and -[decodable](https://docs.rs/google-customsearch1/5.0.3+20230123/google_customsearch1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-customsearch1/5.0.3+20230123/google_customsearch1/client::RequestValue) and +[decodable](https://docs.rs/google-customsearch1/5.0.3+20230123/google_customsearch1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-customsearch1/5.0.3+20230123/google_customsearch1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-customsearch1/5.0.3+20230123/google_customsearch1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -201,7 +201,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **customsearch1** library was generated by Sebastian Thiel, and is placed +The **customsearch1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/customsearch1/src/api.rs b/gen/customsearch1/src/api.rs index 7748c9584b..4d5735fffe 100644 --- a/gen/customsearch1/src/api.rs +++ b/gen/customsearch1/src/api.rs @@ -42,12 +42,12 @@ use crate::{client, client::GetToken, client::serde_with}; /// use std::default::Default; /// use customsearch1::{CustomSearchAPI, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/customsearch1/src/lib.rs b/gen/customsearch1/src/lib.rs index dfe9ada1e8..ceaa8d3e78 100644 --- a/gen/customsearch1/src/lib.rs +++ b/gen/customsearch1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/customsearch1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CustomSearchAPI) ... +//! Handle the following *Resources* with ease from the central [hub](CustomSearchAPI) ... //! //! * cse //! * [*list*](api::CseListCall) and [*siterestrict list*](api::CseSiterestrictListCall) @@ -51,8 +51,8 @@ //! let r = hub.cse().list(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -80,12 +80,12 @@ //! use std::default::Default; //! use customsearch1::{CustomSearchAPI, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -152,10 +152,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -165,25 +165,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/datacatalog1/README.md b/gen/datacatalog1/README.md index 03e03530e1..66e90529fe 100644 --- a/gen/datacatalog1/README.md +++ b/gen/datacatalog1/README.md @@ -11,7 +11,7 @@ Everything else about the *Data Catalog* *v1* API can be found at the [official documentation site](https://cloud.google.com/data-catalog/docs/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-datacatalog1/5.0.3+20230117/google_datacatalog1/DataCatalog) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-datacatalog1/5.0.3+20230117/google_datacatalog1/DataCatalog) ... * catalog * [*search*](https://docs.rs/google-datacatalog1/5.0.3+20230117/google_datacatalog1/api::CatalogSearchCall) @@ -63,8 +63,8 @@ let r = hub.projects().locations_taxonomies_policy_tags_delete(...).doit().await let r = hub.projects().locations_taxonomies_delete(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -91,12 +91,12 @@ use datacatalog1::{Result, Error}; use std::default::Default; use datacatalog1::{DataCatalog, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -133,10 +133,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-datacatalog1/5.0.3+20230117/google_datacatalog1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-datacatalog1/5.0.3+20230117/google_datacatalog1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -146,25 +146,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-dataca You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-datacatalog1/5.0.3+20230117/google_datacatalog1/client::Delegate) to the -[Method Builder](https://docs.rs/google-datacatalog1/5.0.3+20230117/google_datacatalog1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-datacatalog1/5.0.3+20230117/google_datacatalog1/client::Delegate) to the +[Method Builder](https://docs.rs/google-datacatalog1/5.0.3+20230117/google_datacatalog1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-datacatalog1/5.0.3+20230117/google_datacatalog1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-datacatalog1/5.0.3+20230117/google_datacatalog1/client::RequestValue) and -[decodable](https://docs.rs/google-datacatalog1/5.0.3+20230117/google_datacatalog1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-datacatalog1/5.0.3+20230117/google_datacatalog1/client::RequestValue) and +[decodable](https://docs.rs/google-datacatalog1/5.0.3+20230117/google_datacatalog1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-datacatalog1/5.0.3+20230117/google_datacatalog1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-datacatalog1/5.0.3+20230117/google_datacatalog1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -183,7 +183,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **datacatalog1** library was generated by Sebastian Thiel, and is placed +The **datacatalog1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/datacatalog1/src/api.rs b/gen/datacatalog1/src/api.rs index 138c7cd1bf..2ef779b445 100644 --- a/gen/datacatalog1/src/api.rs +++ b/gen/datacatalog1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use datacatalog1::{DataCatalog, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/datacatalog1/src/lib.rs b/gen/datacatalog1/src/lib.rs index e422227feb..81d6009a36 100644 --- a/gen/datacatalog1/src/lib.rs +++ b/gen/datacatalog1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/datacatalog1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](DataCatalog) ... +//! Handle the following *Resources* with ease from the central [hub](DataCatalog) ... //! //! * catalog //! * [*search*](api::CatalogSearchCall) @@ -63,8 +63,8 @@ //! let r = hub.projects().locations_taxonomies_delete(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -92,12 +92,12 @@ //! use std::default::Default; //! use datacatalog1::{DataCatalog, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -134,10 +134,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -147,25 +147,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/datacatalog1_beta1/README.md b/gen/datacatalog1_beta1/README.md index ffc4b45204..41b5973655 100644 --- a/gen/datacatalog1_beta1/README.md +++ b/gen/datacatalog1_beta1/README.md @@ -11,7 +11,7 @@ Everything else about the *Data Catalog* *v1_beta1* API can be found at the [official documentation site](https://cloud.google.com/data-catalog/docs/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-datacatalog1_beta1/5.0.3+20230117/google_datacatalog1_beta1/DataCatalog) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-datacatalog1_beta1/5.0.3+20230117/google_datacatalog1_beta1/DataCatalog) ... * catalog * [*search*](https://docs.rs/google-datacatalog1_beta1/5.0.3+20230117/google_datacatalog1_beta1/api::CatalogSearchCall) @@ -62,8 +62,8 @@ let r = hub.projects().locations_taxonomies_get_iam_policy(...).doit().await let r = hub.projects().locations_taxonomies_set_iam_policy(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -91,12 +91,12 @@ use datacatalog1_beta1::{Result, Error}; use std::default::Default; use datacatalog1_beta1::{DataCatalog, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -137,10 +137,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-datacatalog1_beta1/5.0.3+20230117/google_datacatalog1_beta1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-datacatalog1_beta1/5.0.3+20230117/google_datacatalog1_beta1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -150,25 +150,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-dataca You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-datacatalog1_beta1/5.0.3+20230117/google_datacatalog1_beta1/client::Delegate) to the -[Method Builder](https://docs.rs/google-datacatalog1_beta1/5.0.3+20230117/google_datacatalog1_beta1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-datacatalog1_beta1/5.0.3+20230117/google_datacatalog1_beta1/client::Delegate) to the +[Method Builder](https://docs.rs/google-datacatalog1_beta1/5.0.3+20230117/google_datacatalog1_beta1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-datacatalog1_beta1/5.0.3+20230117/google_datacatalog1_beta1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-datacatalog1_beta1/5.0.3+20230117/google_datacatalog1_beta1/client::RequestValue) and -[decodable](https://docs.rs/google-datacatalog1_beta1/5.0.3+20230117/google_datacatalog1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-datacatalog1_beta1/5.0.3+20230117/google_datacatalog1_beta1/client::RequestValue) and +[decodable](https://docs.rs/google-datacatalog1_beta1/5.0.3+20230117/google_datacatalog1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-datacatalog1_beta1/5.0.3+20230117/google_datacatalog1_beta1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-datacatalog1_beta1/5.0.3+20230117/google_datacatalog1_beta1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -187,7 +187,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **datacatalog1_beta1** library was generated by Sebastian Thiel, and is placed +The **datacatalog1_beta1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/datacatalog1_beta1/src/api.rs b/gen/datacatalog1_beta1/src/api.rs index be81a16f31..620e8b3c49 100644 --- a/gen/datacatalog1_beta1/src/api.rs +++ b/gen/datacatalog1_beta1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use datacatalog1_beta1::{DataCatalog, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/datacatalog1_beta1/src/lib.rs b/gen/datacatalog1_beta1/src/lib.rs index fe02b72c8f..6ced2222e6 100644 --- a/gen/datacatalog1_beta1/src/lib.rs +++ b/gen/datacatalog1_beta1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/datacatalog1_beta1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](DataCatalog) ... +//! Handle the following *Resources* with ease from the central [hub](DataCatalog) ... //! //! * catalog //! * [*search*](api::CatalogSearchCall) @@ -62,8 +62,8 @@ //! let r = hub.projects().locations_taxonomies_set_iam_policy(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -92,12 +92,12 @@ //! use std::default::Default; //! use datacatalog1_beta1::{DataCatalog, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -138,10 +138,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -151,25 +151,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/datafusion1/README.md b/gen/datafusion1/README.md index 99b7f50088..9c9c3cdc3d 100644 --- a/gen/datafusion1/README.md +++ b/gen/datafusion1/README.md @@ -11,7 +11,7 @@ Everything else about the *Data Fusion* *v1* API can be found at the [official documentation site](https://cloud.google.com/data-fusion/docs). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-datafusion1/5.0.3+20221213/google_datafusion1/DataFusion) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-datafusion1/5.0.3+20221213/google_datafusion1/DataFusion) ... * projects * [*locations get*](https://docs.rs/google-datafusion1/5.0.3+20221213/google_datafusion1/api::ProjectLocationGetCall), [*locations instances create*](https://docs.rs/google-datafusion1/5.0.3+20221213/google_datafusion1/api::ProjectLocationInstanceCreateCall), [*locations instances delete*](https://docs.rs/google-datafusion1/5.0.3+20221213/google_datafusion1/api::ProjectLocationInstanceDeleteCall), [*locations instances dns peerings create*](https://docs.rs/google-datafusion1/5.0.3+20221213/google_datafusion1/api::ProjectLocationInstanceDnsPeeringCreateCall), [*locations instances dns peerings delete*](https://docs.rs/google-datafusion1/5.0.3+20221213/google_datafusion1/api::ProjectLocationInstanceDnsPeeringDeleteCall), [*locations instances dns peerings list*](https://docs.rs/google-datafusion1/5.0.3+20221213/google_datafusion1/api::ProjectLocationInstanceDnsPeeringListCall), [*locations instances get*](https://docs.rs/google-datafusion1/5.0.3+20221213/google_datafusion1/api::ProjectLocationInstanceGetCall), [*locations instances get iam policy*](https://docs.rs/google-datafusion1/5.0.3+20221213/google_datafusion1/api::ProjectLocationInstanceGetIamPolicyCall), [*locations instances list*](https://docs.rs/google-datafusion1/5.0.3+20221213/google_datafusion1/api::ProjectLocationInstanceListCall), [*locations instances patch*](https://docs.rs/google-datafusion1/5.0.3+20221213/google_datafusion1/api::ProjectLocationInstancePatchCall), [*locations instances restart*](https://docs.rs/google-datafusion1/5.0.3+20221213/google_datafusion1/api::ProjectLocationInstanceRestartCall), [*locations instances set iam policy*](https://docs.rs/google-datafusion1/5.0.3+20221213/google_datafusion1/api::ProjectLocationInstanceSetIamPolicyCall), [*locations instances test iam permissions*](https://docs.rs/google-datafusion1/5.0.3+20221213/google_datafusion1/api::ProjectLocationInstanceTestIamPermissionCall), [*locations list*](https://docs.rs/google-datafusion1/5.0.3+20221213/google_datafusion1/api::ProjectLocationListCall), [*locations operations cancel*](https://docs.rs/google-datafusion1/5.0.3+20221213/google_datafusion1/api::ProjectLocationOperationCancelCall), [*locations operations delete*](https://docs.rs/google-datafusion1/5.0.3+20221213/google_datafusion1/api::ProjectLocationOperationDeleteCall), [*locations operations get*](https://docs.rs/google-datafusion1/5.0.3+20221213/google_datafusion1/api::ProjectLocationOperationGetCall), [*locations operations list*](https://docs.rs/google-datafusion1/5.0.3+20221213/google_datafusion1/api::ProjectLocationOperationListCall) and [*locations versions list*](https://docs.rs/google-datafusion1/5.0.3+20221213/google_datafusion1/api::ProjectLocationVersionListCall) @@ -54,8 +54,8 @@ let r = hub.projects().locations_instances_restart(...).doit().await let r = hub.projects().locations_operations_get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -83,12 +83,12 @@ use datafusion1::{Result, Error}; use std::default::Default; use datafusion1::{DataFusion, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -130,10 +130,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-datafusion1/5.0.3+20221213/google_datafusion1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-datafusion1/5.0.3+20221213/google_datafusion1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -143,25 +143,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-datafu You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-datafusion1/5.0.3+20221213/google_datafusion1/client::Delegate) to the -[Method Builder](https://docs.rs/google-datafusion1/5.0.3+20221213/google_datafusion1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-datafusion1/5.0.3+20221213/google_datafusion1/client::Delegate) to the +[Method Builder](https://docs.rs/google-datafusion1/5.0.3+20221213/google_datafusion1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-datafusion1/5.0.3+20221213/google_datafusion1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-datafusion1/5.0.3+20221213/google_datafusion1/client::RequestValue) and -[decodable](https://docs.rs/google-datafusion1/5.0.3+20221213/google_datafusion1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-datafusion1/5.0.3+20221213/google_datafusion1/client::RequestValue) and +[decodable](https://docs.rs/google-datafusion1/5.0.3+20221213/google_datafusion1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-datafusion1/5.0.3+20221213/google_datafusion1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-datafusion1/5.0.3+20221213/google_datafusion1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -180,7 +180,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **datafusion1** library was generated by Sebastian Thiel, and is placed +The **datafusion1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/datafusion1/src/api.rs b/gen/datafusion1/src/api.rs index 785507cbd5..35ace1830f 100644 --- a/gen/datafusion1/src/api.rs +++ b/gen/datafusion1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use datafusion1::{DataFusion, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/datafusion1/src/lib.rs b/gen/datafusion1/src/lib.rs index 0c8899b5b7..e64b611856 100644 --- a/gen/datafusion1/src/lib.rs +++ b/gen/datafusion1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/datafusion1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](DataFusion) ... +//! Handle the following *Resources* with ease from the central [hub](DataFusion) ... //! //! * projects //! * [*locations get*](api::ProjectLocationGetCall), [*locations instances create*](api::ProjectLocationInstanceCreateCall), [*locations instances delete*](api::ProjectLocationInstanceDeleteCall), [*locations instances dns peerings create*](api::ProjectLocationInstanceDnsPeeringCreateCall), [*locations instances dns peerings delete*](api::ProjectLocationInstanceDnsPeeringDeleteCall), [*locations instances dns peerings list*](api::ProjectLocationInstanceDnsPeeringListCall), [*locations instances get*](api::ProjectLocationInstanceGetCall), [*locations instances get iam policy*](api::ProjectLocationInstanceGetIamPolicyCall), [*locations instances list*](api::ProjectLocationInstanceListCall), [*locations instances patch*](api::ProjectLocationInstancePatchCall), [*locations instances restart*](api::ProjectLocationInstanceRestartCall), [*locations instances set iam policy*](api::ProjectLocationInstanceSetIamPolicyCall), [*locations instances test iam permissions*](api::ProjectLocationInstanceTestIamPermissionCall), [*locations list*](api::ProjectLocationListCall), [*locations operations cancel*](api::ProjectLocationOperationCancelCall), [*locations operations delete*](api::ProjectLocationOperationDeleteCall), [*locations operations get*](api::ProjectLocationOperationGetCall), [*locations operations list*](api::ProjectLocationOperationListCall) and [*locations versions list*](api::ProjectLocationVersionListCall) @@ -54,8 +54,8 @@ //! let r = hub.projects().locations_operations_get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -84,12 +84,12 @@ //! use std::default::Default; //! use datafusion1::{DataFusion, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -131,10 +131,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -144,25 +144,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/datafusion1_beta1/README.md b/gen/datafusion1_beta1/README.md index ecef75496e..7c76940bc3 100644 --- a/gen/datafusion1_beta1/README.md +++ b/gen/datafusion1_beta1/README.md @@ -11,7 +11,7 @@ Everything else about the *Data Fusion* *v1_beta1* API can be found at the [official documentation site](https://cloud.google.com/data-fusion/docs). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-datafusion1_beta1/5.0.3+20221213/google_datafusion1_beta1/DataFusion) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-datafusion1_beta1/5.0.3+20221213/google_datafusion1_beta1/DataFusion) ... * projects * [*locations get*](https://docs.rs/google-datafusion1_beta1/5.0.3+20221213/google_datafusion1_beta1/api::ProjectLocationGetCall), [*locations instances create*](https://docs.rs/google-datafusion1_beta1/5.0.3+20221213/google_datafusion1_beta1/api::ProjectLocationInstanceCreateCall), [*locations instances delete*](https://docs.rs/google-datafusion1_beta1/5.0.3+20221213/google_datafusion1_beta1/api::ProjectLocationInstanceDeleteCall), [*locations instances dns peerings create*](https://docs.rs/google-datafusion1_beta1/5.0.3+20221213/google_datafusion1_beta1/api::ProjectLocationInstanceDnsPeeringCreateCall), [*locations instances dns peerings delete*](https://docs.rs/google-datafusion1_beta1/5.0.3+20221213/google_datafusion1_beta1/api::ProjectLocationInstanceDnsPeeringDeleteCall), [*locations instances dns peerings list*](https://docs.rs/google-datafusion1_beta1/5.0.3+20221213/google_datafusion1_beta1/api::ProjectLocationInstanceDnsPeeringListCall), [*locations instances get*](https://docs.rs/google-datafusion1_beta1/5.0.3+20221213/google_datafusion1_beta1/api::ProjectLocationInstanceGetCall), [*locations instances get iam policy*](https://docs.rs/google-datafusion1_beta1/5.0.3+20221213/google_datafusion1_beta1/api::ProjectLocationInstanceGetIamPolicyCall), [*locations instances list*](https://docs.rs/google-datafusion1_beta1/5.0.3+20221213/google_datafusion1_beta1/api::ProjectLocationInstanceListCall), [*locations instances namespaces get iam policy*](https://docs.rs/google-datafusion1_beta1/5.0.3+20221213/google_datafusion1_beta1/api::ProjectLocationInstanceNamespaceGetIamPolicyCall), [*locations instances namespaces list*](https://docs.rs/google-datafusion1_beta1/5.0.3+20221213/google_datafusion1_beta1/api::ProjectLocationInstanceNamespaceListCall), [*locations instances namespaces set iam policy*](https://docs.rs/google-datafusion1_beta1/5.0.3+20221213/google_datafusion1_beta1/api::ProjectLocationInstanceNamespaceSetIamPolicyCall), [*locations instances namespaces test iam permissions*](https://docs.rs/google-datafusion1_beta1/5.0.3+20221213/google_datafusion1_beta1/api::ProjectLocationInstanceNamespaceTestIamPermissionCall), [*locations instances patch*](https://docs.rs/google-datafusion1_beta1/5.0.3+20221213/google_datafusion1_beta1/api::ProjectLocationInstancePatchCall), [*locations instances restart*](https://docs.rs/google-datafusion1_beta1/5.0.3+20221213/google_datafusion1_beta1/api::ProjectLocationInstanceRestartCall), [*locations instances set iam policy*](https://docs.rs/google-datafusion1_beta1/5.0.3+20221213/google_datafusion1_beta1/api::ProjectLocationInstanceSetIamPolicyCall), [*locations instances test iam permissions*](https://docs.rs/google-datafusion1_beta1/5.0.3+20221213/google_datafusion1_beta1/api::ProjectLocationInstanceTestIamPermissionCall), [*locations instances upgrade*](https://docs.rs/google-datafusion1_beta1/5.0.3+20221213/google_datafusion1_beta1/api::ProjectLocationInstanceUpgradeCall), [*locations list*](https://docs.rs/google-datafusion1_beta1/5.0.3+20221213/google_datafusion1_beta1/api::ProjectLocationListCall), [*locations operations cancel*](https://docs.rs/google-datafusion1_beta1/5.0.3+20221213/google_datafusion1_beta1/api::ProjectLocationOperationCancelCall), [*locations operations delete*](https://docs.rs/google-datafusion1_beta1/5.0.3+20221213/google_datafusion1_beta1/api::ProjectLocationOperationDeleteCall), [*locations operations get*](https://docs.rs/google-datafusion1_beta1/5.0.3+20221213/google_datafusion1_beta1/api::ProjectLocationOperationGetCall), [*locations operations list*](https://docs.rs/google-datafusion1_beta1/5.0.3+20221213/google_datafusion1_beta1/api::ProjectLocationOperationListCall), [*locations remove iam policy*](https://docs.rs/google-datafusion1_beta1/5.0.3+20221213/google_datafusion1_beta1/api::ProjectLocationRemoveIamPolicyCall) and [*locations versions list*](https://docs.rs/google-datafusion1_beta1/5.0.3+20221213/google_datafusion1_beta1/api::ProjectLocationVersionListCall) @@ -55,8 +55,8 @@ let r = hub.projects().locations_instances_upgrade(...).doit().await let r = hub.projects().locations_operations_get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -84,12 +84,12 @@ use datafusion1_beta1::{Result, Error}; use std::default::Default; use datafusion1_beta1::{DataFusion, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -131,10 +131,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-datafusion1_beta1/5.0.3+20221213/google_datafusion1_beta1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-datafusion1_beta1/5.0.3+20221213/google_datafusion1_beta1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -144,25 +144,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-datafu You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-datafusion1_beta1/5.0.3+20221213/google_datafusion1_beta1/client::Delegate) to the -[Method Builder](https://docs.rs/google-datafusion1_beta1/5.0.3+20221213/google_datafusion1_beta1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-datafusion1_beta1/5.0.3+20221213/google_datafusion1_beta1/client::Delegate) to the +[Method Builder](https://docs.rs/google-datafusion1_beta1/5.0.3+20221213/google_datafusion1_beta1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-datafusion1_beta1/5.0.3+20221213/google_datafusion1_beta1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-datafusion1_beta1/5.0.3+20221213/google_datafusion1_beta1/client::RequestValue) and -[decodable](https://docs.rs/google-datafusion1_beta1/5.0.3+20221213/google_datafusion1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-datafusion1_beta1/5.0.3+20221213/google_datafusion1_beta1/client::RequestValue) and +[decodable](https://docs.rs/google-datafusion1_beta1/5.0.3+20221213/google_datafusion1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-datafusion1_beta1/5.0.3+20221213/google_datafusion1_beta1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-datafusion1_beta1/5.0.3+20221213/google_datafusion1_beta1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -181,7 +181,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **datafusion1_beta1** library was generated by Sebastian Thiel, and is placed +The **datafusion1_beta1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/datafusion1_beta1/src/api.rs b/gen/datafusion1_beta1/src/api.rs index 20c040ee37..a60f2f5d0d 100644 --- a/gen/datafusion1_beta1/src/api.rs +++ b/gen/datafusion1_beta1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use datafusion1_beta1::{DataFusion, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/datafusion1_beta1/src/lib.rs b/gen/datafusion1_beta1/src/lib.rs index 5427adbbfd..0bfcbe3490 100644 --- a/gen/datafusion1_beta1/src/lib.rs +++ b/gen/datafusion1_beta1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/datafusion1_beta1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](DataFusion) ... +//! Handle the following *Resources* with ease from the central [hub](DataFusion) ... //! //! * projects //! * [*locations get*](api::ProjectLocationGetCall), [*locations instances create*](api::ProjectLocationInstanceCreateCall), [*locations instances delete*](api::ProjectLocationInstanceDeleteCall), [*locations instances dns peerings create*](api::ProjectLocationInstanceDnsPeeringCreateCall), [*locations instances dns peerings delete*](api::ProjectLocationInstanceDnsPeeringDeleteCall), [*locations instances dns peerings list*](api::ProjectLocationInstanceDnsPeeringListCall), [*locations instances get*](api::ProjectLocationInstanceGetCall), [*locations instances get iam policy*](api::ProjectLocationInstanceGetIamPolicyCall), [*locations instances list*](api::ProjectLocationInstanceListCall), [*locations instances namespaces get iam policy*](api::ProjectLocationInstanceNamespaceGetIamPolicyCall), [*locations instances namespaces list*](api::ProjectLocationInstanceNamespaceListCall), [*locations instances namespaces set iam policy*](api::ProjectLocationInstanceNamespaceSetIamPolicyCall), [*locations instances namespaces test iam permissions*](api::ProjectLocationInstanceNamespaceTestIamPermissionCall), [*locations instances patch*](api::ProjectLocationInstancePatchCall), [*locations instances restart*](api::ProjectLocationInstanceRestartCall), [*locations instances set iam policy*](api::ProjectLocationInstanceSetIamPolicyCall), [*locations instances test iam permissions*](api::ProjectLocationInstanceTestIamPermissionCall), [*locations instances upgrade*](api::ProjectLocationInstanceUpgradeCall), [*locations list*](api::ProjectLocationListCall), [*locations operations cancel*](api::ProjectLocationOperationCancelCall), [*locations operations delete*](api::ProjectLocationOperationDeleteCall), [*locations operations get*](api::ProjectLocationOperationGetCall), [*locations operations list*](api::ProjectLocationOperationListCall), [*locations remove iam policy*](api::ProjectLocationRemoveIamPolicyCall) and [*locations versions list*](api::ProjectLocationVersionListCall) @@ -55,8 +55,8 @@ //! let r = hub.projects().locations_operations_get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -85,12 +85,12 @@ //! use std::default::Default; //! use datafusion1_beta1::{DataFusion, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -132,10 +132,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -145,25 +145,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/datalabeling1_beta1/README.md b/gen/datalabeling1_beta1/README.md index 8c66fcb3a5..f8dddbf46f 100644 --- a/gen/datalabeling1_beta1/README.md +++ b/gen/datalabeling1_beta1/README.md @@ -11,7 +11,7 @@ Everything else about the *Data Labeling* *v1_beta1* API can be found at the [official documentation site](https://cloud.google.com/data-labeling/docs/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/DataLabeling) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/DataLabeling) ... * projects * [*annotation spec sets create*](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/api::ProjectAnnotationSpecSetCreateCall), [*annotation spec sets delete*](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/api::ProjectAnnotationSpecSetDeleteCall), [*annotation spec sets get*](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/api::ProjectAnnotationSpecSetGetCall), [*annotation spec sets list*](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/api::ProjectAnnotationSpecSetListCall), [*datasets annotated datasets data items get*](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/api::ProjectDatasetAnnotatedDatasetDataItemGetCall), [*datasets annotated datasets data items list*](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/api::ProjectDatasetAnnotatedDatasetDataItemListCall), [*datasets annotated datasets delete*](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/api::ProjectDatasetAnnotatedDatasetDeleteCall), [*datasets annotated datasets examples get*](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/api::ProjectDatasetAnnotatedDatasetExampleGetCall), [*datasets annotated datasets examples list*](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/api::ProjectDatasetAnnotatedDatasetExampleListCall), [*datasets annotated datasets feedback threads delete*](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/api::ProjectDatasetAnnotatedDatasetFeedbackThreadDeleteCall), [*datasets annotated datasets feedback threads feedback messages create*](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/api::ProjectDatasetAnnotatedDatasetFeedbackThreadFeedbackMessageCreateCall), [*datasets annotated datasets feedback threads feedback messages delete*](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/api::ProjectDatasetAnnotatedDatasetFeedbackThreadFeedbackMessageDeleteCall), [*datasets annotated datasets feedback threads feedback messages get*](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/api::ProjectDatasetAnnotatedDatasetFeedbackThreadFeedbackMessageGetCall), [*datasets annotated datasets feedback threads feedback messages list*](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/api::ProjectDatasetAnnotatedDatasetFeedbackThreadFeedbackMessageListCall), [*datasets annotated datasets feedback threads get*](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/api::ProjectDatasetAnnotatedDatasetFeedbackThreadGetCall), [*datasets annotated datasets feedback threads list*](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/api::ProjectDatasetAnnotatedDatasetFeedbackThreadListCall), [*datasets annotated datasets get*](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/api::ProjectDatasetAnnotatedDatasetGetCall), [*datasets annotated datasets list*](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/api::ProjectDatasetAnnotatedDatasetListCall), [*datasets create*](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/api::ProjectDatasetCreateCall), [*datasets data items get*](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/api::ProjectDatasetDataItemGetCall), [*datasets data items list*](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/api::ProjectDatasetDataItemListCall), [*datasets delete*](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/api::ProjectDatasetDeleteCall), [*datasets evaluations example comparisons search*](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/api::ProjectDatasetEvaluationExampleComparisonSearchCall), [*datasets evaluations get*](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/api::ProjectDatasetEvaluationGetCall), [*datasets export data*](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/api::ProjectDatasetExportDataCall), [*datasets get*](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/api::ProjectDatasetGetCall), [*datasets image label*](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/api::ProjectDatasetImageLabelCall), [*datasets import data*](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/api::ProjectDatasetImportDataCall), [*datasets list*](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/api::ProjectDatasetListCall), [*datasets text label*](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/api::ProjectDatasetTextLabelCall), [*datasets video label*](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/api::ProjectDatasetVideoLabelCall), [*evaluation jobs create*](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/api::ProjectEvaluationJobCreateCall), [*evaluation jobs delete*](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/api::ProjectEvaluationJobDeleteCall), [*evaluation jobs get*](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/api::ProjectEvaluationJobGetCall), [*evaluation jobs list*](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/api::ProjectEvaluationJobListCall), [*evaluation jobs patch*](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/api::ProjectEvaluationJobPatchCall), [*evaluation jobs pause*](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/api::ProjectEvaluationJobPauseCall), [*evaluation jobs resume*](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/api::ProjectEvaluationJobResumeCall), [*evaluations search*](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/api::ProjectEvaluationSearchCall), [*instructions create*](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/api::ProjectInstructionCreateCall), [*instructions delete*](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/api::ProjectInstructionDeleteCall), [*instructions get*](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/api::ProjectInstructionGetCall), [*instructions list*](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/api::ProjectInstructionListCall), [*operations cancel*](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/api::ProjectOperationCancelCall), [*operations delete*](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/api::ProjectOperationDeleteCall), [*operations get*](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/api::ProjectOperationGetCall) and [*operations list*](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/api::ProjectOperationListCall) @@ -60,8 +60,8 @@ let r = hub.projects().operations_cancel(...).doit().await let r = hub.projects().operations_delete(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -89,12 +89,12 @@ use datalabeling1_beta1::{Result, Error}; use std::default::Default; use datalabeling1_beta1::{DataLabeling, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -135,10 +135,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -148,25 +148,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-datala You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/client::Delegate) to the -[Method Builder](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/client::Delegate) to the +[Method Builder](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/client::RequestValue) and -[decodable](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/client::RequestValue) and +[decodable](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-datalabeling1_beta1/5.0.3+20221205/google_datalabeling1_beta1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -185,7 +185,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **datalabeling1_beta1** library was generated by Sebastian Thiel, and is placed +The **datalabeling1_beta1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/datalabeling1_beta1/src/api.rs b/gen/datalabeling1_beta1/src/api.rs index 7b7de9eafa..b69805a86e 100644 --- a/gen/datalabeling1_beta1/src/api.rs +++ b/gen/datalabeling1_beta1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use datalabeling1_beta1::{DataLabeling, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/datalabeling1_beta1/src/lib.rs b/gen/datalabeling1_beta1/src/lib.rs index a38385aab9..2f373c016a 100644 --- a/gen/datalabeling1_beta1/src/lib.rs +++ b/gen/datalabeling1_beta1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/datalabeling1_beta1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](DataLabeling) ... +//! Handle the following *Resources* with ease from the central [hub](DataLabeling) ... //! //! * projects //! * [*annotation spec sets create*](api::ProjectAnnotationSpecSetCreateCall), [*annotation spec sets delete*](api::ProjectAnnotationSpecSetDeleteCall), [*annotation spec sets get*](api::ProjectAnnotationSpecSetGetCall), [*annotation spec sets list*](api::ProjectAnnotationSpecSetListCall), [*datasets annotated datasets data items get*](api::ProjectDatasetAnnotatedDatasetDataItemGetCall), [*datasets annotated datasets data items list*](api::ProjectDatasetAnnotatedDatasetDataItemListCall), [*datasets annotated datasets delete*](api::ProjectDatasetAnnotatedDatasetDeleteCall), [*datasets annotated datasets examples get*](api::ProjectDatasetAnnotatedDatasetExampleGetCall), [*datasets annotated datasets examples list*](api::ProjectDatasetAnnotatedDatasetExampleListCall), [*datasets annotated datasets feedback threads delete*](api::ProjectDatasetAnnotatedDatasetFeedbackThreadDeleteCall), [*datasets annotated datasets feedback threads feedback messages create*](api::ProjectDatasetAnnotatedDatasetFeedbackThreadFeedbackMessageCreateCall), [*datasets annotated datasets feedback threads feedback messages delete*](api::ProjectDatasetAnnotatedDatasetFeedbackThreadFeedbackMessageDeleteCall), [*datasets annotated datasets feedback threads feedback messages get*](api::ProjectDatasetAnnotatedDatasetFeedbackThreadFeedbackMessageGetCall), [*datasets annotated datasets feedback threads feedback messages list*](api::ProjectDatasetAnnotatedDatasetFeedbackThreadFeedbackMessageListCall), [*datasets annotated datasets feedback threads get*](api::ProjectDatasetAnnotatedDatasetFeedbackThreadGetCall), [*datasets annotated datasets feedback threads list*](api::ProjectDatasetAnnotatedDatasetFeedbackThreadListCall), [*datasets annotated datasets get*](api::ProjectDatasetAnnotatedDatasetGetCall), [*datasets annotated datasets list*](api::ProjectDatasetAnnotatedDatasetListCall), [*datasets create*](api::ProjectDatasetCreateCall), [*datasets data items get*](api::ProjectDatasetDataItemGetCall), [*datasets data items list*](api::ProjectDatasetDataItemListCall), [*datasets delete*](api::ProjectDatasetDeleteCall), [*datasets evaluations example comparisons search*](api::ProjectDatasetEvaluationExampleComparisonSearchCall), [*datasets evaluations get*](api::ProjectDatasetEvaluationGetCall), [*datasets export data*](api::ProjectDatasetExportDataCall), [*datasets get*](api::ProjectDatasetGetCall), [*datasets image label*](api::ProjectDatasetImageLabelCall), [*datasets import data*](api::ProjectDatasetImportDataCall), [*datasets list*](api::ProjectDatasetListCall), [*datasets text label*](api::ProjectDatasetTextLabelCall), [*datasets video label*](api::ProjectDatasetVideoLabelCall), [*evaluation jobs create*](api::ProjectEvaluationJobCreateCall), [*evaluation jobs delete*](api::ProjectEvaluationJobDeleteCall), [*evaluation jobs get*](api::ProjectEvaluationJobGetCall), [*evaluation jobs list*](api::ProjectEvaluationJobListCall), [*evaluation jobs patch*](api::ProjectEvaluationJobPatchCall), [*evaluation jobs pause*](api::ProjectEvaluationJobPauseCall), [*evaluation jobs resume*](api::ProjectEvaluationJobResumeCall), [*evaluations search*](api::ProjectEvaluationSearchCall), [*instructions create*](api::ProjectInstructionCreateCall), [*instructions delete*](api::ProjectInstructionDeleteCall), [*instructions get*](api::ProjectInstructionGetCall), [*instructions list*](api::ProjectInstructionListCall), [*operations cancel*](api::ProjectOperationCancelCall), [*operations delete*](api::ProjectOperationDeleteCall), [*operations get*](api::ProjectOperationGetCall) and [*operations list*](api::ProjectOperationListCall) @@ -60,8 +60,8 @@ //! let r = hub.projects().operations_delete(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -90,12 +90,12 @@ //! use std::default::Default; //! use datalabeling1_beta1::{DataLabeling, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -136,10 +136,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -149,25 +149,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/datamigration1/README.md b/gen/datamigration1/README.md index 3f8f1563f4..b0694b5ad1 100644 --- a/gen/datamigration1/README.md +++ b/gen/datamigration1/README.md @@ -11,7 +11,7 @@ Everything else about the *Database Migration Service* *v1* API can be found at [official documentation site](https://cloud.google.com/database-migration/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/DatabaseMigrationService) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/DatabaseMigrationService) ... * projects * [*locations connection profiles create*](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/api::ProjectLocationConnectionProfileCreateCall), [*locations connection profiles delete*](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/api::ProjectLocationConnectionProfileDeleteCall), [*locations connection profiles get*](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/api::ProjectLocationConnectionProfileGetCall), [*locations connection profiles get iam policy*](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/api::ProjectLocationConnectionProfileGetIamPolicyCall), [*locations connection profiles list*](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/api::ProjectLocationConnectionProfileListCall), [*locations connection profiles patch*](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/api::ProjectLocationConnectionProfilePatchCall), [*locations connection profiles set iam policy*](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/api::ProjectLocationConnectionProfileSetIamPolicyCall), [*locations connection profiles test iam permissions*](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/api::ProjectLocationConnectionProfileTestIamPermissionCall), [*locations conversion workspaces apply*](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/api::ProjectLocationConversionWorkspaceApplyCall), [*locations conversion workspaces commit*](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/api::ProjectLocationConversionWorkspaceCommitCall), [*locations conversion workspaces convert*](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/api::ProjectLocationConversionWorkspaceConvertCall), [*locations conversion workspaces create*](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/api::ProjectLocationConversionWorkspaceCreateCall), [*locations conversion workspaces delete*](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/api::ProjectLocationConversionWorkspaceDeleteCall), [*locations conversion workspaces describe conversion workspace revisions*](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/api::ProjectLocationConversionWorkspaceDescribeConversionWorkspaceRevisionCall), [*locations conversion workspaces describe database entities*](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/api::ProjectLocationConversionWorkspaceDescribeDatabaseEntityCall), [*locations conversion workspaces get*](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/api::ProjectLocationConversionWorkspaceGetCall), [*locations conversion workspaces list*](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/api::ProjectLocationConversionWorkspaceListCall), [*locations conversion workspaces mapping rules import*](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/api::ProjectLocationConversionWorkspaceMappingRuleImportCall), [*locations conversion workspaces patch*](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/api::ProjectLocationConversionWorkspacePatchCall), [*locations conversion workspaces rollback*](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/api::ProjectLocationConversionWorkspaceRollbackCall), [*locations conversion workspaces search background jobs*](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/api::ProjectLocationConversionWorkspaceSearchBackgroundJobCall), [*locations conversion workspaces seed*](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/api::ProjectLocationConversionWorkspaceSeedCall), [*locations get*](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/api::ProjectLocationGetCall), [*locations list*](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/api::ProjectLocationListCall), [*locations migration jobs create*](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/api::ProjectLocationMigrationJobCreateCall), [*locations migration jobs delete*](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/api::ProjectLocationMigrationJobDeleteCall), [*locations migration jobs generate ssh script*](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/api::ProjectLocationMigrationJobGenerateSshScriptCall), [*locations migration jobs get*](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/api::ProjectLocationMigrationJobGetCall), [*locations migration jobs get iam policy*](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/api::ProjectLocationMigrationJobGetIamPolicyCall), [*locations migration jobs list*](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/api::ProjectLocationMigrationJobListCall), [*locations migration jobs patch*](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/api::ProjectLocationMigrationJobPatchCall), [*locations migration jobs promote*](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/api::ProjectLocationMigrationJobPromoteCall), [*locations migration jobs restart*](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/api::ProjectLocationMigrationJobRestartCall), [*locations migration jobs resume*](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/api::ProjectLocationMigrationJobResumeCall), [*locations migration jobs set iam policy*](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/api::ProjectLocationMigrationJobSetIamPolicyCall), [*locations migration jobs start*](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/api::ProjectLocationMigrationJobStartCall), [*locations migration jobs stop*](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/api::ProjectLocationMigrationJobStopCall), [*locations migration jobs test iam permissions*](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/api::ProjectLocationMigrationJobTestIamPermissionCall), [*locations migration jobs verify*](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/api::ProjectLocationMigrationJobVerifyCall), [*locations operations cancel*](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/api::ProjectLocationOperationCancelCall), [*locations operations delete*](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/api::ProjectLocationOperationDeleteCall), [*locations operations get*](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/api::ProjectLocationOperationGetCall), [*locations operations list*](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/api::ProjectLocationOperationListCall), [*locations private connections create*](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/api::ProjectLocationPrivateConnectionCreateCall), [*locations private connections delete*](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/api::ProjectLocationPrivateConnectionDeleteCall), [*locations private connections get*](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/api::ProjectLocationPrivateConnectionGetCall) and [*locations private connections list*](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/api::ProjectLocationPrivateConnectionListCall) @@ -73,8 +73,8 @@ let r = hub.projects().locations_private_connections_create(...).doit().await let r = hub.projects().locations_private_connections_delete(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -102,12 +102,12 @@ use datamigration1::{Result, Error}; use std::default::Default; use datamigration1::{DatabaseMigrationService, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -152,10 +152,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -165,25 +165,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-datami You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/client::Delegate) to the -[Method Builder](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/client::Delegate) to the +[Method Builder](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/client::RequestValue) and -[decodable](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/client::RequestValue) and +[decodable](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-datamigration1/5.0.3+20230105/google_datamigration1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -202,7 +202,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **datamigration1** library was generated by Sebastian Thiel, and is placed +The **datamigration1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/datamigration1/src/api.rs b/gen/datamigration1/src/api.rs index 0a933a0f37..4bb47100ac 100644 --- a/gen/datamigration1/src/api.rs +++ b/gen/datamigration1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use datamigration1::{DatabaseMigrationService, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/datamigration1/src/lib.rs b/gen/datamigration1/src/lib.rs index 783bfd753e..9c48023d47 100644 --- a/gen/datamigration1/src/lib.rs +++ b/gen/datamigration1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/datamigration1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](DatabaseMigrationService) ... +//! Handle the following *Resources* with ease from the central [hub](DatabaseMigrationService) ... //! //! * projects //! * [*locations connection profiles create*](api::ProjectLocationConnectionProfileCreateCall), [*locations connection profiles delete*](api::ProjectLocationConnectionProfileDeleteCall), [*locations connection profiles get*](api::ProjectLocationConnectionProfileGetCall), [*locations connection profiles get iam policy*](api::ProjectLocationConnectionProfileGetIamPolicyCall), [*locations connection profiles list*](api::ProjectLocationConnectionProfileListCall), [*locations connection profiles patch*](api::ProjectLocationConnectionProfilePatchCall), [*locations connection profiles set iam policy*](api::ProjectLocationConnectionProfileSetIamPolicyCall), [*locations connection profiles test iam permissions*](api::ProjectLocationConnectionProfileTestIamPermissionCall), [*locations conversion workspaces apply*](api::ProjectLocationConversionWorkspaceApplyCall), [*locations conversion workspaces commit*](api::ProjectLocationConversionWorkspaceCommitCall), [*locations conversion workspaces convert*](api::ProjectLocationConversionWorkspaceConvertCall), [*locations conversion workspaces create*](api::ProjectLocationConversionWorkspaceCreateCall), [*locations conversion workspaces delete*](api::ProjectLocationConversionWorkspaceDeleteCall), [*locations conversion workspaces describe conversion workspace revisions*](api::ProjectLocationConversionWorkspaceDescribeConversionWorkspaceRevisionCall), [*locations conversion workspaces describe database entities*](api::ProjectLocationConversionWorkspaceDescribeDatabaseEntityCall), [*locations conversion workspaces get*](api::ProjectLocationConversionWorkspaceGetCall), [*locations conversion workspaces list*](api::ProjectLocationConversionWorkspaceListCall), [*locations conversion workspaces mapping rules import*](api::ProjectLocationConversionWorkspaceMappingRuleImportCall), [*locations conversion workspaces patch*](api::ProjectLocationConversionWorkspacePatchCall), [*locations conversion workspaces rollback*](api::ProjectLocationConversionWorkspaceRollbackCall), [*locations conversion workspaces search background jobs*](api::ProjectLocationConversionWorkspaceSearchBackgroundJobCall), [*locations conversion workspaces seed*](api::ProjectLocationConversionWorkspaceSeedCall), [*locations get*](api::ProjectLocationGetCall), [*locations list*](api::ProjectLocationListCall), [*locations migration jobs create*](api::ProjectLocationMigrationJobCreateCall), [*locations migration jobs delete*](api::ProjectLocationMigrationJobDeleteCall), [*locations migration jobs generate ssh script*](api::ProjectLocationMigrationJobGenerateSshScriptCall), [*locations migration jobs get*](api::ProjectLocationMigrationJobGetCall), [*locations migration jobs get iam policy*](api::ProjectLocationMigrationJobGetIamPolicyCall), [*locations migration jobs list*](api::ProjectLocationMigrationJobListCall), [*locations migration jobs patch*](api::ProjectLocationMigrationJobPatchCall), [*locations migration jobs promote*](api::ProjectLocationMigrationJobPromoteCall), [*locations migration jobs restart*](api::ProjectLocationMigrationJobRestartCall), [*locations migration jobs resume*](api::ProjectLocationMigrationJobResumeCall), [*locations migration jobs set iam policy*](api::ProjectLocationMigrationJobSetIamPolicyCall), [*locations migration jobs start*](api::ProjectLocationMigrationJobStartCall), [*locations migration jobs stop*](api::ProjectLocationMigrationJobStopCall), [*locations migration jobs test iam permissions*](api::ProjectLocationMigrationJobTestIamPermissionCall), [*locations migration jobs verify*](api::ProjectLocationMigrationJobVerifyCall), [*locations operations cancel*](api::ProjectLocationOperationCancelCall), [*locations operations delete*](api::ProjectLocationOperationDeleteCall), [*locations operations get*](api::ProjectLocationOperationGetCall), [*locations operations list*](api::ProjectLocationOperationListCall), [*locations private connections create*](api::ProjectLocationPrivateConnectionCreateCall), [*locations private connections delete*](api::ProjectLocationPrivateConnectionDeleteCall), [*locations private connections get*](api::ProjectLocationPrivateConnectionGetCall) and [*locations private connections list*](api::ProjectLocationPrivateConnectionListCall) @@ -73,8 +73,8 @@ //! let r = hub.projects().locations_private_connections_delete(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -103,12 +103,12 @@ //! use std::default::Default; //! use datamigration1::{DatabaseMigrationService, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -153,10 +153,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -166,25 +166,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/datapipelines1/README.md b/gen/datapipelines1/README.md index a78e581e4a..f61725cc30 100644 --- a/gen/datapipelines1/README.md +++ b/gen/datapipelines1/README.md @@ -11,7 +11,7 @@ Everything else about the *Datapipelines* *v1* API can be found at the [official documentation site](https://cloud.google.com/dataflow/docs/guides/data-pipelines). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-datapipelines1/5.0.3+20230115/google_datapipelines1/Datapipelines) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-datapipelines1/5.0.3+20230115/google_datapipelines1/Datapipelines) ... * projects * [*locations pipelines create*](https://docs.rs/google-datapipelines1/5.0.3+20230115/google_datapipelines1/api::ProjectLocationPipelineCreateCall), [*locations pipelines delete*](https://docs.rs/google-datapipelines1/5.0.3+20230115/google_datapipelines1/api::ProjectLocationPipelineDeleteCall), [*locations pipelines get*](https://docs.rs/google-datapipelines1/5.0.3+20230115/google_datapipelines1/api::ProjectLocationPipelineGetCall), [*locations pipelines jobs list*](https://docs.rs/google-datapipelines1/5.0.3+20230115/google_datapipelines1/api::ProjectLocationPipelineJobListCall), [*locations pipelines list*](https://docs.rs/google-datapipelines1/5.0.3+20230115/google_datapipelines1/api::ProjectLocationPipelineListCall), [*locations pipelines patch*](https://docs.rs/google-datapipelines1/5.0.3+20230115/google_datapipelines1/api::ProjectLocationPipelinePatchCall), [*locations pipelines run*](https://docs.rs/google-datapipelines1/5.0.3+20230115/google_datapipelines1/api::ProjectLocationPipelineRunCall) and [*locations pipelines stop*](https://docs.rs/google-datapipelines1/5.0.3+20230115/google_datapipelines1/api::ProjectLocationPipelineStopCall) @@ -53,8 +53,8 @@ let r = hub.projects().locations_pipelines_patch(...).doit().await let r = hub.projects().locations_pipelines_stop(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -82,12 +82,12 @@ use datapipelines1::{Result, Error}; use std::default::Default; use datapipelines1::{Datapipelines, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -129,10 +129,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-datapipelines1/5.0.3+20230115/google_datapipelines1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-datapipelines1/5.0.3+20230115/google_datapipelines1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -142,25 +142,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-datapi You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-datapipelines1/5.0.3+20230115/google_datapipelines1/client::Delegate) to the -[Method Builder](https://docs.rs/google-datapipelines1/5.0.3+20230115/google_datapipelines1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-datapipelines1/5.0.3+20230115/google_datapipelines1/client::Delegate) to the +[Method Builder](https://docs.rs/google-datapipelines1/5.0.3+20230115/google_datapipelines1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-datapipelines1/5.0.3+20230115/google_datapipelines1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-datapipelines1/5.0.3+20230115/google_datapipelines1/client::RequestValue) and -[decodable](https://docs.rs/google-datapipelines1/5.0.3+20230115/google_datapipelines1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-datapipelines1/5.0.3+20230115/google_datapipelines1/client::RequestValue) and +[decodable](https://docs.rs/google-datapipelines1/5.0.3+20230115/google_datapipelines1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-datapipelines1/5.0.3+20230115/google_datapipelines1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-datapipelines1/5.0.3+20230115/google_datapipelines1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -179,7 +179,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **datapipelines1** library was generated by Sebastian Thiel, and is placed +The **datapipelines1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/datapipelines1/src/api.rs b/gen/datapipelines1/src/api.rs index 1918f3c84a..4093b49961 100644 --- a/gen/datapipelines1/src/api.rs +++ b/gen/datapipelines1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use datapipelines1::{Datapipelines, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/datapipelines1/src/lib.rs b/gen/datapipelines1/src/lib.rs index fef130e6ff..b1748ab121 100644 --- a/gen/datapipelines1/src/lib.rs +++ b/gen/datapipelines1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/datapipelines1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Datapipelines) ... +//! Handle the following *Resources* with ease from the central [hub](Datapipelines) ... //! //! * projects //! * [*locations pipelines create*](api::ProjectLocationPipelineCreateCall), [*locations pipelines delete*](api::ProjectLocationPipelineDeleteCall), [*locations pipelines get*](api::ProjectLocationPipelineGetCall), [*locations pipelines jobs list*](api::ProjectLocationPipelineJobListCall), [*locations pipelines list*](api::ProjectLocationPipelineListCall), [*locations pipelines patch*](api::ProjectLocationPipelinePatchCall), [*locations pipelines run*](api::ProjectLocationPipelineRunCall) and [*locations pipelines stop*](api::ProjectLocationPipelineStopCall) @@ -53,8 +53,8 @@ //! let r = hub.projects().locations_pipelines_stop(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -83,12 +83,12 @@ //! use std::default::Default; //! use datapipelines1::{Datapipelines, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -130,10 +130,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -143,25 +143,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/dataplex1/README.md b/gen/dataplex1/README.md index 63a828dfa8..5614834783 100644 --- a/gen/dataplex1/README.md +++ b/gen/dataplex1/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Dataplex* *v1* API can be found at the [official documentation site](https://cloud.google.com/dataplex/docs). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/CloudDataplex) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/CloudDataplex) ... * projects * [*locations data attribute bindings create*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationDataAttributeBindingCreateCall), [*locations data attribute bindings delete*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationDataAttributeBindingDeleteCall), [*locations data attribute bindings get*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationDataAttributeBindingGetCall), [*locations data attribute bindings get iam policy*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationDataAttributeBindingGetIamPolicyCall), [*locations data attribute bindings list*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationDataAttributeBindingListCall), [*locations data attribute bindings patch*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationDataAttributeBindingPatchCall), [*locations data attribute bindings set iam policy*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationDataAttributeBindingSetIamPolicyCall), [*locations data attribute bindings test iam permissions*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationDataAttributeBindingTestIamPermissionCall), [*locations data scans create*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationDataScanCreateCall), [*locations data scans delete*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationDataScanDeleteCall), [*locations data scans get*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationDataScanGetCall), [*locations data scans get iam policy*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationDataScanGetIamPolicyCall), [*locations data scans jobs get*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationDataScanJobGetCall), [*locations data scans jobs list*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationDataScanJobListCall), [*locations data scans list*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationDataScanListCall), [*locations data scans patch*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationDataScanPatchCall), [*locations data scans run*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationDataScanRunCall), [*locations data scans set iam policy*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationDataScanSetIamPolicyCall), [*locations data scans test iam permissions*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationDataScanTestIamPermissionCall), [*locations data taxonomies attributes create*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationDataTaxonomyAttributeCreateCall), [*locations data taxonomies attributes delete*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationDataTaxonomyAttributeDeleteCall), [*locations data taxonomies attributes get*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationDataTaxonomyAttributeGetCall), [*locations data taxonomies attributes get iam policy*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationDataTaxonomyAttributeGetIamPolicyCall), [*locations data taxonomies attributes list*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationDataTaxonomyAttributeListCall), [*locations data taxonomies attributes patch*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationDataTaxonomyAttributePatchCall), [*locations data taxonomies attributes set iam policy*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationDataTaxonomyAttributeSetIamPolicyCall), [*locations data taxonomies attributes test iam permissions*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationDataTaxonomyAttributeTestIamPermissionCall), [*locations data taxonomies create*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationDataTaxonomyCreateCall), [*locations data taxonomies delete*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationDataTaxonomyDeleteCall), [*locations data taxonomies get*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationDataTaxonomyGetCall), [*locations data taxonomies get iam policy*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationDataTaxonomyGetIamPolicyCall), [*locations data taxonomies list*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationDataTaxonomyListCall), [*locations data taxonomies patch*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationDataTaxonomyPatchCall), [*locations data taxonomies set iam policy*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationDataTaxonomySetIamPolicyCall), [*locations data taxonomies test iam permissions*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationDataTaxonomyTestIamPermissionCall), [*locations get*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationGetCall), [*locations lakes actions list*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeActionListCall), [*locations lakes content create*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeContentCreateCall), [*locations lakes content delete*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeContentDeleteCall), [*locations lakes content get*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeContentGetCall), [*locations lakes content get iam policy*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeContentGetIamPolicyCall), [*locations lakes content list*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeContentListCall), [*locations lakes content patch*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeContentPatchCall), [*locations lakes content set iam policy*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeContentSetIamPolicyCall), [*locations lakes content test iam permissions*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeContentTestIamPermissionCall), [*locations lakes contentitems create*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeContentitemCreateCall), [*locations lakes contentitems delete*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeContentitemDeleteCall), [*locations lakes contentitems get*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeContentitemGetCall), [*locations lakes contentitems get iam policy*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeContentitemGetIamPolicyCall), [*locations lakes contentitems list*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeContentitemListCall), [*locations lakes contentitems patch*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeContentitemPatchCall), [*locations lakes contentitems set iam policy*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeContentitemSetIamPolicyCall), [*locations lakes contentitems test iam permissions*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeContentitemTestIamPermissionCall), [*locations lakes create*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeCreateCall), [*locations lakes delete*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeDeleteCall), [*locations lakes environments create*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeEnvironmentCreateCall), [*locations lakes environments delete*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeEnvironmentDeleteCall), [*locations lakes environments get*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeEnvironmentGetCall), [*locations lakes environments get iam policy*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeEnvironmentGetIamPolicyCall), [*locations lakes environments list*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeEnvironmentListCall), [*locations lakes environments patch*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeEnvironmentPatchCall), [*locations lakes environments sessions list*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeEnvironmentSessionListCall), [*locations lakes environments set iam policy*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeEnvironmentSetIamPolicyCall), [*locations lakes environments test iam permissions*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeEnvironmentTestIamPermissionCall), [*locations lakes get*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeGetCall), [*locations lakes get iam policy*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeGetIamPolicyCall), [*locations lakes list*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeListCall), [*locations lakes patch*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakePatchCall), [*locations lakes set iam policy*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeSetIamPolicyCall), [*locations lakes tasks create*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeTaskCreateCall), [*locations lakes tasks delete*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeTaskDeleteCall), [*locations lakes tasks get*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeTaskGetCall), [*locations lakes tasks get iam policy*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeTaskGetIamPolicyCall), [*locations lakes tasks jobs cancel*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeTaskJobCancelCall), [*locations lakes tasks jobs get*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeTaskJobGetCall), [*locations lakes tasks jobs list*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeTaskJobListCall), [*locations lakes tasks list*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeTaskListCall), [*locations lakes tasks patch*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeTaskPatchCall), [*locations lakes tasks run*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeTaskRunCall), [*locations lakes tasks set iam policy*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeTaskSetIamPolicyCall), [*locations lakes tasks test iam permissions*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeTaskTestIamPermissionCall), [*locations lakes test iam permissions*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeTestIamPermissionCall), [*locations lakes zones actions list*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeZoneActionListCall), [*locations lakes zones assets actions list*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeZoneAssetActionListCall), [*locations lakes zones assets create*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeZoneAssetCreateCall), [*locations lakes zones assets delete*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeZoneAssetDeleteCall), [*locations lakes zones assets get*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeZoneAssetGetCall), [*locations lakes zones assets get iam policy*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeZoneAssetGetIamPolicyCall), [*locations lakes zones assets list*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeZoneAssetListCall), [*locations lakes zones assets patch*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeZoneAssetPatchCall), [*locations lakes zones assets set iam policy*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeZoneAssetSetIamPolicyCall), [*locations lakes zones assets test iam permissions*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeZoneAssetTestIamPermissionCall), [*locations lakes zones create*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeZoneCreateCall), [*locations lakes zones delete*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeZoneDeleteCall), [*locations lakes zones entities create*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeZoneEntityCreateCall), [*locations lakes zones entities delete*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeZoneEntityDeleteCall), [*locations lakes zones entities get*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeZoneEntityGetCall), [*locations lakes zones entities list*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeZoneEntityListCall), [*locations lakes zones entities partitions create*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeZoneEntityPartitionCreateCall), [*locations lakes zones entities partitions delete*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeZoneEntityPartitionDeleteCall), [*locations lakes zones entities partitions get*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeZoneEntityPartitionGetCall), [*locations lakes zones entities partitions list*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeZoneEntityPartitionListCall), [*locations lakes zones entities update*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeZoneEntityUpdateCall), [*locations lakes zones get*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeZoneGetCall), [*locations lakes zones get iam policy*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeZoneGetIamPolicyCall), [*locations lakes zones list*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeZoneListCall), [*locations lakes zones patch*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeZonePatchCall), [*locations lakes zones set iam policy*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeZoneSetIamPolicyCall), [*locations lakes zones test iam permissions*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationLakeZoneTestIamPermissionCall), [*locations list*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationListCall), [*locations operations cancel*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationOperationCancelCall), [*locations operations delete*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationOperationDeleteCall), [*locations operations get*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationOperationGetCall) and [*locations operations list*](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/api::ProjectLocationOperationListCall) @@ -77,8 +77,8 @@ let r = hub.projects().locations_lakes_patch(...).doit().await let r = hub.projects().locations_operations_get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -106,12 +106,12 @@ use dataplex1::{Result, Error}; use std::default::Default; use dataplex1::{CloudDataplex, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -154,10 +154,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -167,25 +167,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-datapl You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/client::Delegate) to the -[Method Builder](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/client::Delegate) to the +[Method Builder](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/client::RequestValue) and -[decodable](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/client::RequestValue) and +[decodable](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-dataplex1/5.0.3+20230120/google_dataplex1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -204,7 +204,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **dataplex1** library was generated by Sebastian Thiel, and is placed +The **dataplex1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/dataplex1/src/api.rs b/gen/dataplex1/src/api.rs index e83fed0537..0b10fef092 100644 --- a/gen/dataplex1/src/api.rs +++ b/gen/dataplex1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use dataplex1::{CloudDataplex, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/dataplex1/src/lib.rs b/gen/dataplex1/src/lib.rs index d0fe68cc72..09c5ba4247 100644 --- a/gen/dataplex1/src/lib.rs +++ b/gen/dataplex1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/dataplex1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudDataplex) ... +//! Handle the following *Resources* with ease from the central [hub](CloudDataplex) ... //! //! * projects //! * [*locations data attribute bindings create*](api::ProjectLocationDataAttributeBindingCreateCall), [*locations data attribute bindings delete*](api::ProjectLocationDataAttributeBindingDeleteCall), [*locations data attribute bindings get*](api::ProjectLocationDataAttributeBindingGetCall), [*locations data attribute bindings get iam policy*](api::ProjectLocationDataAttributeBindingGetIamPolicyCall), [*locations data attribute bindings list*](api::ProjectLocationDataAttributeBindingListCall), [*locations data attribute bindings patch*](api::ProjectLocationDataAttributeBindingPatchCall), [*locations data attribute bindings set iam policy*](api::ProjectLocationDataAttributeBindingSetIamPolicyCall), [*locations data attribute bindings test iam permissions*](api::ProjectLocationDataAttributeBindingTestIamPermissionCall), [*locations data scans create*](api::ProjectLocationDataScanCreateCall), [*locations data scans delete*](api::ProjectLocationDataScanDeleteCall), [*locations data scans get*](api::ProjectLocationDataScanGetCall), [*locations data scans get iam policy*](api::ProjectLocationDataScanGetIamPolicyCall), [*locations data scans jobs get*](api::ProjectLocationDataScanJobGetCall), [*locations data scans jobs list*](api::ProjectLocationDataScanJobListCall), [*locations data scans list*](api::ProjectLocationDataScanListCall), [*locations data scans patch*](api::ProjectLocationDataScanPatchCall), [*locations data scans run*](api::ProjectLocationDataScanRunCall), [*locations data scans set iam policy*](api::ProjectLocationDataScanSetIamPolicyCall), [*locations data scans test iam permissions*](api::ProjectLocationDataScanTestIamPermissionCall), [*locations data taxonomies attributes create*](api::ProjectLocationDataTaxonomyAttributeCreateCall), [*locations data taxonomies attributes delete*](api::ProjectLocationDataTaxonomyAttributeDeleteCall), [*locations data taxonomies attributes get*](api::ProjectLocationDataTaxonomyAttributeGetCall), [*locations data taxonomies attributes get iam policy*](api::ProjectLocationDataTaxonomyAttributeGetIamPolicyCall), [*locations data taxonomies attributes list*](api::ProjectLocationDataTaxonomyAttributeListCall), [*locations data taxonomies attributes patch*](api::ProjectLocationDataTaxonomyAttributePatchCall), [*locations data taxonomies attributes set iam policy*](api::ProjectLocationDataTaxonomyAttributeSetIamPolicyCall), [*locations data taxonomies attributes test iam permissions*](api::ProjectLocationDataTaxonomyAttributeTestIamPermissionCall), [*locations data taxonomies create*](api::ProjectLocationDataTaxonomyCreateCall), [*locations data taxonomies delete*](api::ProjectLocationDataTaxonomyDeleteCall), [*locations data taxonomies get*](api::ProjectLocationDataTaxonomyGetCall), [*locations data taxonomies get iam policy*](api::ProjectLocationDataTaxonomyGetIamPolicyCall), [*locations data taxonomies list*](api::ProjectLocationDataTaxonomyListCall), [*locations data taxonomies patch*](api::ProjectLocationDataTaxonomyPatchCall), [*locations data taxonomies set iam policy*](api::ProjectLocationDataTaxonomySetIamPolicyCall), [*locations data taxonomies test iam permissions*](api::ProjectLocationDataTaxonomyTestIamPermissionCall), [*locations get*](api::ProjectLocationGetCall), [*locations lakes actions list*](api::ProjectLocationLakeActionListCall), [*locations lakes content create*](api::ProjectLocationLakeContentCreateCall), [*locations lakes content delete*](api::ProjectLocationLakeContentDeleteCall), [*locations lakes content get*](api::ProjectLocationLakeContentGetCall), [*locations lakes content get iam policy*](api::ProjectLocationLakeContentGetIamPolicyCall), [*locations lakes content list*](api::ProjectLocationLakeContentListCall), [*locations lakes content patch*](api::ProjectLocationLakeContentPatchCall), [*locations lakes content set iam policy*](api::ProjectLocationLakeContentSetIamPolicyCall), [*locations lakes content test iam permissions*](api::ProjectLocationLakeContentTestIamPermissionCall), [*locations lakes contentitems create*](api::ProjectLocationLakeContentitemCreateCall), [*locations lakes contentitems delete*](api::ProjectLocationLakeContentitemDeleteCall), [*locations lakes contentitems get*](api::ProjectLocationLakeContentitemGetCall), [*locations lakes contentitems get iam policy*](api::ProjectLocationLakeContentitemGetIamPolicyCall), [*locations lakes contentitems list*](api::ProjectLocationLakeContentitemListCall), [*locations lakes contentitems patch*](api::ProjectLocationLakeContentitemPatchCall), [*locations lakes contentitems set iam policy*](api::ProjectLocationLakeContentitemSetIamPolicyCall), [*locations lakes contentitems test iam permissions*](api::ProjectLocationLakeContentitemTestIamPermissionCall), [*locations lakes create*](api::ProjectLocationLakeCreateCall), [*locations lakes delete*](api::ProjectLocationLakeDeleteCall), [*locations lakes environments create*](api::ProjectLocationLakeEnvironmentCreateCall), [*locations lakes environments delete*](api::ProjectLocationLakeEnvironmentDeleteCall), [*locations lakes environments get*](api::ProjectLocationLakeEnvironmentGetCall), [*locations lakes environments get iam policy*](api::ProjectLocationLakeEnvironmentGetIamPolicyCall), [*locations lakes environments list*](api::ProjectLocationLakeEnvironmentListCall), [*locations lakes environments patch*](api::ProjectLocationLakeEnvironmentPatchCall), [*locations lakes environments sessions list*](api::ProjectLocationLakeEnvironmentSessionListCall), [*locations lakes environments set iam policy*](api::ProjectLocationLakeEnvironmentSetIamPolicyCall), [*locations lakes environments test iam permissions*](api::ProjectLocationLakeEnvironmentTestIamPermissionCall), [*locations lakes get*](api::ProjectLocationLakeGetCall), [*locations lakes get iam policy*](api::ProjectLocationLakeGetIamPolicyCall), [*locations lakes list*](api::ProjectLocationLakeListCall), [*locations lakes patch*](api::ProjectLocationLakePatchCall), [*locations lakes set iam policy*](api::ProjectLocationLakeSetIamPolicyCall), [*locations lakes tasks create*](api::ProjectLocationLakeTaskCreateCall), [*locations lakes tasks delete*](api::ProjectLocationLakeTaskDeleteCall), [*locations lakes tasks get*](api::ProjectLocationLakeTaskGetCall), [*locations lakes tasks get iam policy*](api::ProjectLocationLakeTaskGetIamPolicyCall), [*locations lakes tasks jobs cancel*](api::ProjectLocationLakeTaskJobCancelCall), [*locations lakes tasks jobs get*](api::ProjectLocationLakeTaskJobGetCall), [*locations lakes tasks jobs list*](api::ProjectLocationLakeTaskJobListCall), [*locations lakes tasks list*](api::ProjectLocationLakeTaskListCall), [*locations lakes tasks patch*](api::ProjectLocationLakeTaskPatchCall), [*locations lakes tasks run*](api::ProjectLocationLakeTaskRunCall), [*locations lakes tasks set iam policy*](api::ProjectLocationLakeTaskSetIamPolicyCall), [*locations lakes tasks test iam permissions*](api::ProjectLocationLakeTaskTestIamPermissionCall), [*locations lakes test iam permissions*](api::ProjectLocationLakeTestIamPermissionCall), [*locations lakes zones actions list*](api::ProjectLocationLakeZoneActionListCall), [*locations lakes zones assets actions list*](api::ProjectLocationLakeZoneAssetActionListCall), [*locations lakes zones assets create*](api::ProjectLocationLakeZoneAssetCreateCall), [*locations lakes zones assets delete*](api::ProjectLocationLakeZoneAssetDeleteCall), [*locations lakes zones assets get*](api::ProjectLocationLakeZoneAssetGetCall), [*locations lakes zones assets get iam policy*](api::ProjectLocationLakeZoneAssetGetIamPolicyCall), [*locations lakes zones assets list*](api::ProjectLocationLakeZoneAssetListCall), [*locations lakes zones assets patch*](api::ProjectLocationLakeZoneAssetPatchCall), [*locations lakes zones assets set iam policy*](api::ProjectLocationLakeZoneAssetSetIamPolicyCall), [*locations lakes zones assets test iam permissions*](api::ProjectLocationLakeZoneAssetTestIamPermissionCall), [*locations lakes zones create*](api::ProjectLocationLakeZoneCreateCall), [*locations lakes zones delete*](api::ProjectLocationLakeZoneDeleteCall), [*locations lakes zones entities create*](api::ProjectLocationLakeZoneEntityCreateCall), [*locations lakes zones entities delete*](api::ProjectLocationLakeZoneEntityDeleteCall), [*locations lakes zones entities get*](api::ProjectLocationLakeZoneEntityGetCall), [*locations lakes zones entities list*](api::ProjectLocationLakeZoneEntityListCall), [*locations lakes zones entities partitions create*](api::ProjectLocationLakeZoneEntityPartitionCreateCall), [*locations lakes zones entities partitions delete*](api::ProjectLocationLakeZoneEntityPartitionDeleteCall), [*locations lakes zones entities partitions get*](api::ProjectLocationLakeZoneEntityPartitionGetCall), [*locations lakes zones entities partitions list*](api::ProjectLocationLakeZoneEntityPartitionListCall), [*locations lakes zones entities update*](api::ProjectLocationLakeZoneEntityUpdateCall), [*locations lakes zones get*](api::ProjectLocationLakeZoneGetCall), [*locations lakes zones get iam policy*](api::ProjectLocationLakeZoneGetIamPolicyCall), [*locations lakes zones list*](api::ProjectLocationLakeZoneListCall), [*locations lakes zones patch*](api::ProjectLocationLakeZonePatchCall), [*locations lakes zones set iam policy*](api::ProjectLocationLakeZoneSetIamPolicyCall), [*locations lakes zones test iam permissions*](api::ProjectLocationLakeZoneTestIamPermissionCall), [*locations list*](api::ProjectLocationListCall), [*locations operations cancel*](api::ProjectLocationOperationCancelCall), [*locations operations delete*](api::ProjectLocationOperationDeleteCall), [*locations operations get*](api::ProjectLocationOperationGetCall) and [*locations operations list*](api::ProjectLocationOperationListCall) @@ -77,8 +77,8 @@ //! let r = hub.projects().locations_operations_get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -107,12 +107,12 @@ //! use std::default::Default; //! use dataplex1::{CloudDataplex, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -155,10 +155,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -168,25 +168,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/dataproc1/README.md b/gen/dataproc1/README.md index ba8e0d049a..f237ce0afe 100644 --- a/gen/dataproc1/README.md +++ b/gen/dataproc1/README.md @@ -11,7 +11,7 @@ Everything else about the *Dataproc* *v1* API can be found at the [official documentation site](https://cloud.google.com/dataproc/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/Dataproc) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/Dataproc) ... * projects * [*locations autoscaling policies create*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectLocationAutoscalingPolicyCreateCall), [*locations autoscaling policies delete*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectLocationAutoscalingPolicyDeleteCall), [*locations autoscaling policies get*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectLocationAutoscalingPolicyGetCall), [*locations autoscaling policies get iam policy*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectLocationAutoscalingPolicyGetIamPolicyCall), [*locations autoscaling policies list*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectLocationAutoscalingPolicyListCall), [*locations autoscaling policies set iam policy*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectLocationAutoscalingPolicySetIamPolicyCall), [*locations autoscaling policies test iam permissions*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectLocationAutoscalingPolicyTestIamPermissionCall), [*locations autoscaling policies update*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectLocationAutoscalingPolicyUpdateCall), [*locations batches create*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectLocationBatchCreateCall), [*locations batches delete*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectLocationBatchDeleteCall), [*locations batches get*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectLocationBatchGetCall), [*locations batches list*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectLocationBatchListCall), [*locations operations cancel*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectLocationOperationCancelCall), [*locations operations delete*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectLocationOperationDeleteCall), [*locations operations get*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectLocationOperationGetCall), [*locations operations list*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectLocationOperationListCall), [*locations workflow templates create*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectLocationWorkflowTemplateCreateCall), [*locations workflow templates delete*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectLocationWorkflowTemplateDeleteCall), [*locations workflow templates get*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectLocationWorkflowTemplateGetCall), [*locations workflow templates get iam policy*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectLocationWorkflowTemplateGetIamPolicyCall), [*locations workflow templates instantiate*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectLocationWorkflowTemplateInstantiateCall), [*locations workflow templates instantiate inline*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectLocationWorkflowTemplateInstantiateInlineCall), [*locations workflow templates list*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectLocationWorkflowTemplateListCall), [*locations workflow templates set iam policy*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectLocationWorkflowTemplateSetIamPolicyCall), [*locations workflow templates test iam permissions*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectLocationWorkflowTemplateTestIamPermissionCall), [*locations workflow templates update*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectLocationWorkflowTemplateUpdateCall), [*regions autoscaling policies create*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionAutoscalingPolicyCreateCall), [*regions autoscaling policies delete*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionAutoscalingPolicyDeleteCall), [*regions autoscaling policies get*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionAutoscalingPolicyGetCall), [*regions autoscaling policies get iam policy*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionAutoscalingPolicyGetIamPolicyCall), [*regions autoscaling policies list*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionAutoscalingPolicyListCall), [*regions autoscaling policies set iam policy*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionAutoscalingPolicySetIamPolicyCall), [*regions autoscaling policies test iam permissions*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionAutoscalingPolicyTestIamPermissionCall), [*regions autoscaling policies update*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionAutoscalingPolicyUpdateCall), [*regions clusters create*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionClusterCreateCall), [*regions clusters delete*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionClusterDeleteCall), [*regions clusters diagnose*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionClusterDiagnoseCall), [*regions clusters get*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionClusterGetCall), [*regions clusters get iam policy*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionClusterGetIamPolicyCall), [*regions clusters inject credentials*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionClusterInjectCredentialCall), [*regions clusters list*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionClusterListCall), [*regions clusters node groups create*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionClusterNodeGroupCreateCall), [*regions clusters node groups get*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionClusterNodeGroupGetCall), [*regions clusters node groups resize*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionClusterNodeGroupResizeCall), [*regions clusters patch*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionClusterPatchCall), [*regions clusters repair*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionClusterRepairCall), [*regions clusters set iam policy*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionClusterSetIamPolicyCall), [*regions clusters start*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionClusterStartCall), [*regions clusters stop*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionClusterStopCall), [*regions clusters test iam permissions*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionClusterTestIamPermissionCall), [*regions jobs cancel*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionJobCancelCall), [*regions jobs delete*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionJobDeleteCall), [*regions jobs get*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionJobGetCall), [*regions jobs get iam policy*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionJobGetIamPolicyCall), [*regions jobs list*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionJobListCall), [*regions jobs patch*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionJobPatchCall), [*regions jobs set iam policy*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionJobSetIamPolicyCall), [*regions jobs submit*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionJobSubmitCall), [*regions jobs submit as operation*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionJobSubmitAsOperationCall), [*regions jobs test iam permissions*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionJobTestIamPermissionCall), [*regions operations cancel*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionOperationCancelCall), [*regions operations delete*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionOperationDeleteCall), [*regions operations get*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionOperationGetCall), [*regions operations get iam policy*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionOperationGetIamPolicyCall), [*regions operations list*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionOperationListCall), [*regions operations set iam policy*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionOperationSetIamPolicyCall), [*regions operations test iam permissions*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionOperationTestIamPermissionCall), [*regions workflow templates create*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionWorkflowTemplateCreateCall), [*regions workflow templates delete*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionWorkflowTemplateDeleteCall), [*regions workflow templates get*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionWorkflowTemplateGetCall), [*regions workflow templates get iam policy*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionWorkflowTemplateGetIamPolicyCall), [*regions workflow templates instantiate*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionWorkflowTemplateInstantiateCall), [*regions workflow templates instantiate inline*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionWorkflowTemplateInstantiateInlineCall), [*regions workflow templates list*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionWorkflowTemplateListCall), [*regions workflow templates set iam policy*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionWorkflowTemplateSetIamPolicyCall), [*regions workflow templates test iam permissions*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionWorkflowTemplateTestIamPermissionCall) and [*regions workflow templates update*](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/api::ProjectRegionWorkflowTemplateUpdateCall) @@ -67,8 +67,8 @@ let r = hub.projects().regions_workflow_templates_instantiate(...).doit().await let r = hub.projects().regions_workflow_templates_instantiate_inline(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -96,12 +96,12 @@ use dataproc1::{Result, Error}; use std::default::Default; use dataproc1::{Dataproc, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -145,10 +145,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -158,25 +158,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-datapr You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/client::Delegate) to the -[Method Builder](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/client::Delegate) to the +[Method Builder](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/client::RequestValue) and -[decodable](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/client::RequestValue) and +[decodable](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-dataproc1/5.0.3+20230103/google_dataproc1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -195,7 +195,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **dataproc1** library was generated by Sebastian Thiel, and is placed +The **dataproc1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/dataproc1/src/api.rs b/gen/dataproc1/src/api.rs index 4f8d5a3ec7..42b82c77f2 100644 --- a/gen/dataproc1/src/api.rs +++ b/gen/dataproc1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use dataproc1::{Dataproc, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/dataproc1/src/lib.rs b/gen/dataproc1/src/lib.rs index add75affdf..52edd9cf5c 100644 --- a/gen/dataproc1/src/lib.rs +++ b/gen/dataproc1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/dataproc1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Dataproc) ... +//! Handle the following *Resources* with ease from the central [hub](Dataproc) ... //! //! * projects //! * [*locations autoscaling policies create*](api::ProjectLocationAutoscalingPolicyCreateCall), [*locations autoscaling policies delete*](api::ProjectLocationAutoscalingPolicyDeleteCall), [*locations autoscaling policies get*](api::ProjectLocationAutoscalingPolicyGetCall), [*locations autoscaling policies get iam policy*](api::ProjectLocationAutoscalingPolicyGetIamPolicyCall), [*locations autoscaling policies list*](api::ProjectLocationAutoscalingPolicyListCall), [*locations autoscaling policies set iam policy*](api::ProjectLocationAutoscalingPolicySetIamPolicyCall), [*locations autoscaling policies test iam permissions*](api::ProjectLocationAutoscalingPolicyTestIamPermissionCall), [*locations autoscaling policies update*](api::ProjectLocationAutoscalingPolicyUpdateCall), [*locations batches create*](api::ProjectLocationBatchCreateCall), [*locations batches delete*](api::ProjectLocationBatchDeleteCall), [*locations batches get*](api::ProjectLocationBatchGetCall), [*locations batches list*](api::ProjectLocationBatchListCall), [*locations operations cancel*](api::ProjectLocationOperationCancelCall), [*locations operations delete*](api::ProjectLocationOperationDeleteCall), [*locations operations get*](api::ProjectLocationOperationGetCall), [*locations operations list*](api::ProjectLocationOperationListCall), [*locations workflow templates create*](api::ProjectLocationWorkflowTemplateCreateCall), [*locations workflow templates delete*](api::ProjectLocationWorkflowTemplateDeleteCall), [*locations workflow templates get*](api::ProjectLocationWorkflowTemplateGetCall), [*locations workflow templates get iam policy*](api::ProjectLocationWorkflowTemplateGetIamPolicyCall), [*locations workflow templates instantiate*](api::ProjectLocationWorkflowTemplateInstantiateCall), [*locations workflow templates instantiate inline*](api::ProjectLocationWorkflowTemplateInstantiateInlineCall), [*locations workflow templates list*](api::ProjectLocationWorkflowTemplateListCall), [*locations workflow templates set iam policy*](api::ProjectLocationWorkflowTemplateSetIamPolicyCall), [*locations workflow templates test iam permissions*](api::ProjectLocationWorkflowTemplateTestIamPermissionCall), [*locations workflow templates update*](api::ProjectLocationWorkflowTemplateUpdateCall), [*regions autoscaling policies create*](api::ProjectRegionAutoscalingPolicyCreateCall), [*regions autoscaling policies delete*](api::ProjectRegionAutoscalingPolicyDeleteCall), [*regions autoscaling policies get*](api::ProjectRegionAutoscalingPolicyGetCall), [*regions autoscaling policies get iam policy*](api::ProjectRegionAutoscalingPolicyGetIamPolicyCall), [*regions autoscaling policies list*](api::ProjectRegionAutoscalingPolicyListCall), [*regions autoscaling policies set iam policy*](api::ProjectRegionAutoscalingPolicySetIamPolicyCall), [*regions autoscaling policies test iam permissions*](api::ProjectRegionAutoscalingPolicyTestIamPermissionCall), [*regions autoscaling policies update*](api::ProjectRegionAutoscalingPolicyUpdateCall), [*regions clusters create*](api::ProjectRegionClusterCreateCall), [*regions clusters delete*](api::ProjectRegionClusterDeleteCall), [*regions clusters diagnose*](api::ProjectRegionClusterDiagnoseCall), [*regions clusters get*](api::ProjectRegionClusterGetCall), [*regions clusters get iam policy*](api::ProjectRegionClusterGetIamPolicyCall), [*regions clusters inject credentials*](api::ProjectRegionClusterInjectCredentialCall), [*regions clusters list*](api::ProjectRegionClusterListCall), [*regions clusters node groups create*](api::ProjectRegionClusterNodeGroupCreateCall), [*regions clusters node groups get*](api::ProjectRegionClusterNodeGroupGetCall), [*regions clusters node groups resize*](api::ProjectRegionClusterNodeGroupResizeCall), [*regions clusters patch*](api::ProjectRegionClusterPatchCall), [*regions clusters repair*](api::ProjectRegionClusterRepairCall), [*regions clusters set iam policy*](api::ProjectRegionClusterSetIamPolicyCall), [*regions clusters start*](api::ProjectRegionClusterStartCall), [*regions clusters stop*](api::ProjectRegionClusterStopCall), [*regions clusters test iam permissions*](api::ProjectRegionClusterTestIamPermissionCall), [*regions jobs cancel*](api::ProjectRegionJobCancelCall), [*regions jobs delete*](api::ProjectRegionJobDeleteCall), [*regions jobs get*](api::ProjectRegionJobGetCall), [*regions jobs get iam policy*](api::ProjectRegionJobGetIamPolicyCall), [*regions jobs list*](api::ProjectRegionJobListCall), [*regions jobs patch*](api::ProjectRegionJobPatchCall), [*regions jobs set iam policy*](api::ProjectRegionJobSetIamPolicyCall), [*regions jobs submit*](api::ProjectRegionJobSubmitCall), [*regions jobs submit as operation*](api::ProjectRegionJobSubmitAsOperationCall), [*regions jobs test iam permissions*](api::ProjectRegionJobTestIamPermissionCall), [*regions operations cancel*](api::ProjectRegionOperationCancelCall), [*regions operations delete*](api::ProjectRegionOperationDeleteCall), [*regions operations get*](api::ProjectRegionOperationGetCall), [*regions operations get iam policy*](api::ProjectRegionOperationGetIamPolicyCall), [*regions operations list*](api::ProjectRegionOperationListCall), [*regions operations set iam policy*](api::ProjectRegionOperationSetIamPolicyCall), [*regions operations test iam permissions*](api::ProjectRegionOperationTestIamPermissionCall), [*regions workflow templates create*](api::ProjectRegionWorkflowTemplateCreateCall), [*regions workflow templates delete*](api::ProjectRegionWorkflowTemplateDeleteCall), [*regions workflow templates get*](api::ProjectRegionWorkflowTemplateGetCall), [*regions workflow templates get iam policy*](api::ProjectRegionWorkflowTemplateGetIamPolicyCall), [*regions workflow templates instantiate*](api::ProjectRegionWorkflowTemplateInstantiateCall), [*regions workflow templates instantiate inline*](api::ProjectRegionWorkflowTemplateInstantiateInlineCall), [*regions workflow templates list*](api::ProjectRegionWorkflowTemplateListCall), [*regions workflow templates set iam policy*](api::ProjectRegionWorkflowTemplateSetIamPolicyCall), [*regions workflow templates test iam permissions*](api::ProjectRegionWorkflowTemplateTestIamPermissionCall) and [*regions workflow templates update*](api::ProjectRegionWorkflowTemplateUpdateCall) @@ -67,8 +67,8 @@ //! let r = hub.projects().regions_workflow_templates_instantiate_inline(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -97,12 +97,12 @@ //! use std::default::Default; //! use dataproc1::{Dataproc, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -146,10 +146,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -159,25 +159,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/datastore1/README.md b/gen/datastore1/README.md index 6fa3497e90..ffbe6e2d90 100644 --- a/gen/datastore1/README.md +++ b/gen/datastore1/README.md @@ -11,7 +11,7 @@ Everything else about the *datastore* *v1* API can be found at the [official documentation site](https://cloud.google.com/datastore/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-datastore1/5.0.3+20230118/google_datastore1/Datastore) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-datastore1/5.0.3+20230118/google_datastore1/Datastore) ... * projects * [*allocate ids*](https://docs.rs/google-datastore1/5.0.3+20230118/google_datastore1/api::ProjectAllocateIdCall), [*begin transaction*](https://docs.rs/google-datastore1/5.0.3+20230118/google_datastore1/api::ProjectBeginTransactionCall), [*commit*](https://docs.rs/google-datastore1/5.0.3+20230118/google_datastore1/api::ProjectCommitCall), [*export*](https://docs.rs/google-datastore1/5.0.3+20230118/google_datastore1/api::ProjectExportCall), [*import*](https://docs.rs/google-datastore1/5.0.3+20230118/google_datastore1/api::ProjectImportCall), [*indexes create*](https://docs.rs/google-datastore1/5.0.3+20230118/google_datastore1/api::ProjectIndexCreateCall), [*indexes delete*](https://docs.rs/google-datastore1/5.0.3+20230118/google_datastore1/api::ProjectIndexDeleteCall), [*indexes get*](https://docs.rs/google-datastore1/5.0.3+20230118/google_datastore1/api::ProjectIndexGetCall), [*indexes list*](https://docs.rs/google-datastore1/5.0.3+20230118/google_datastore1/api::ProjectIndexListCall), [*lookup*](https://docs.rs/google-datastore1/5.0.3+20230118/google_datastore1/api::ProjectLookupCall), [*operations cancel*](https://docs.rs/google-datastore1/5.0.3+20230118/google_datastore1/api::ProjectOperationCancelCall), [*operations delete*](https://docs.rs/google-datastore1/5.0.3+20230118/google_datastore1/api::ProjectOperationDeleteCall), [*operations get*](https://docs.rs/google-datastore1/5.0.3+20230118/google_datastore1/api::ProjectOperationGetCall), [*operations list*](https://docs.rs/google-datastore1/5.0.3+20230118/google_datastore1/api::ProjectOperationListCall), [*reserve ids*](https://docs.rs/google-datastore1/5.0.3+20230118/google_datastore1/api::ProjectReserveIdCall), [*rollback*](https://docs.rs/google-datastore1/5.0.3+20230118/google_datastore1/api::ProjectRollbackCall), [*run aggregation query*](https://docs.rs/google-datastore1/5.0.3+20230118/google_datastore1/api::ProjectRunAggregationQueryCall) and [*run query*](https://docs.rs/google-datastore1/5.0.3+20230118/google_datastore1/api::ProjectRunQueryCall) @@ -54,8 +54,8 @@ let r = hub.projects().export(...).doit().await let r = hub.projects().import(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -83,12 +83,12 @@ use datastore1::{Result, Error}; use std::default::Default; use datastore1::{Datastore, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -129,10 +129,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-datastore1/5.0.3+20230118/google_datastore1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-datastore1/5.0.3+20230118/google_datastore1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -142,25 +142,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-datast You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-datastore1/5.0.3+20230118/google_datastore1/client::Delegate) to the -[Method Builder](https://docs.rs/google-datastore1/5.0.3+20230118/google_datastore1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-datastore1/5.0.3+20230118/google_datastore1/client::Delegate) to the +[Method Builder](https://docs.rs/google-datastore1/5.0.3+20230118/google_datastore1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-datastore1/5.0.3+20230118/google_datastore1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-datastore1/5.0.3+20230118/google_datastore1/client::RequestValue) and -[decodable](https://docs.rs/google-datastore1/5.0.3+20230118/google_datastore1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-datastore1/5.0.3+20230118/google_datastore1/client::RequestValue) and +[decodable](https://docs.rs/google-datastore1/5.0.3+20230118/google_datastore1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-datastore1/5.0.3+20230118/google_datastore1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-datastore1/5.0.3+20230118/google_datastore1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -179,7 +179,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **datastore1** library was generated by Sebastian Thiel, and is placed +The **datastore1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/datastore1/src/api.rs b/gen/datastore1/src/api.rs index 3e57f4f511..538b18a88b 100644 --- a/gen/datastore1/src/api.rs +++ b/gen/datastore1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use datastore1::{Datastore, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/datastore1/src/lib.rs b/gen/datastore1/src/lib.rs index 849af21fc3..533515c122 100644 --- a/gen/datastore1/src/lib.rs +++ b/gen/datastore1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/datastore1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Datastore) ... +//! Handle the following *Resources* with ease from the central [hub](Datastore) ... //! //! * projects //! * [*allocate ids*](api::ProjectAllocateIdCall), [*begin transaction*](api::ProjectBeginTransactionCall), [*commit*](api::ProjectCommitCall), [*export*](api::ProjectExportCall), [*import*](api::ProjectImportCall), [*indexes create*](api::ProjectIndexCreateCall), [*indexes delete*](api::ProjectIndexDeleteCall), [*indexes get*](api::ProjectIndexGetCall), [*indexes list*](api::ProjectIndexListCall), [*lookup*](api::ProjectLookupCall), [*operations cancel*](api::ProjectOperationCancelCall), [*operations delete*](api::ProjectOperationDeleteCall), [*operations get*](api::ProjectOperationGetCall), [*operations list*](api::ProjectOperationListCall), [*reserve ids*](api::ProjectReserveIdCall), [*rollback*](api::ProjectRollbackCall), [*run aggregation query*](api::ProjectRunAggregationQueryCall) and [*run query*](api::ProjectRunQueryCall) @@ -54,8 +54,8 @@ //! let r = hub.projects().import(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -84,12 +84,12 @@ //! use std::default::Default; //! use datastore1::{Datastore, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -130,10 +130,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -143,25 +143,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/datastore1_beta3/README.md b/gen/datastore1_beta3/README.md index 3e88907c55..f50f1f3f36 100644 --- a/gen/datastore1_beta3/README.md +++ b/gen/datastore1_beta3/README.md @@ -11,7 +11,7 @@ Everything else about the *datastore* *v1_beta3* API can be found at the [official documentation site](https://cloud.google.com/datastore/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-datastore1_beta3/5.0.3+20230118/google_datastore1_beta3/Datastore) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-datastore1_beta3/5.0.3+20230118/google_datastore1_beta3/Datastore) ... * projects * [*allocate ids*](https://docs.rs/google-datastore1_beta3/5.0.3+20230118/google_datastore1_beta3/api::ProjectAllocateIdCall), [*begin transaction*](https://docs.rs/google-datastore1_beta3/5.0.3+20230118/google_datastore1_beta3/api::ProjectBeginTransactionCall), [*commit*](https://docs.rs/google-datastore1_beta3/5.0.3+20230118/google_datastore1_beta3/api::ProjectCommitCall), [*lookup*](https://docs.rs/google-datastore1_beta3/5.0.3+20230118/google_datastore1_beta3/api::ProjectLookupCall), [*reserve ids*](https://docs.rs/google-datastore1_beta3/5.0.3+20230118/google_datastore1_beta3/api::ProjectReserveIdCall), [*rollback*](https://docs.rs/google-datastore1_beta3/5.0.3+20230118/google_datastore1_beta3/api::ProjectRollbackCall), [*run aggregation query*](https://docs.rs/google-datastore1_beta3/5.0.3+20230118/google_datastore1_beta3/api::ProjectRunAggregationQueryCall) and [*run query*](https://docs.rs/google-datastore1_beta3/5.0.3+20230118/google_datastore1_beta3/api::ProjectRunQueryCall) @@ -50,8 +50,8 @@ Or specifically ... let r = hub.projects().lookup(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -79,12 +79,12 @@ use datastore1_beta3::{Result, Error}; use std::default::Default; use datastore1_beta3::{Datastore, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -125,10 +125,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-datastore1_beta3/5.0.3+20230118/google_datastore1_beta3/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-datastore1_beta3/5.0.3+20230118/google_datastore1_beta3/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -138,25 +138,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-datast You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-datastore1_beta3/5.0.3+20230118/google_datastore1_beta3/client::Delegate) to the -[Method Builder](https://docs.rs/google-datastore1_beta3/5.0.3+20230118/google_datastore1_beta3/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-datastore1_beta3/5.0.3+20230118/google_datastore1_beta3/client::Delegate) to the +[Method Builder](https://docs.rs/google-datastore1_beta3/5.0.3+20230118/google_datastore1_beta3/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-datastore1_beta3/5.0.3+20230118/google_datastore1_beta3/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-datastore1_beta3/5.0.3+20230118/google_datastore1_beta3/client::RequestValue) and -[decodable](https://docs.rs/google-datastore1_beta3/5.0.3+20230118/google_datastore1_beta3/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-datastore1_beta3/5.0.3+20230118/google_datastore1_beta3/client::RequestValue) and +[decodable](https://docs.rs/google-datastore1_beta3/5.0.3+20230118/google_datastore1_beta3/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-datastore1_beta3/5.0.3+20230118/google_datastore1_beta3/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-datastore1_beta3/5.0.3+20230118/google_datastore1_beta3/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -175,7 +175,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **datastore1_beta3** library was generated by Sebastian Thiel, and is placed +The **datastore1_beta3** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/datastore1_beta3/src/api.rs b/gen/datastore1_beta3/src/api.rs index 3f4b8246b0..d47123110e 100644 --- a/gen/datastore1_beta3/src/api.rs +++ b/gen/datastore1_beta3/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use datastore1_beta3::{Datastore, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/datastore1_beta3/src/lib.rs b/gen/datastore1_beta3/src/lib.rs index 550dc440e8..64a5af1b30 100644 --- a/gen/datastore1_beta3/src/lib.rs +++ b/gen/datastore1_beta3/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/datastore1_beta3). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Datastore) ... +//! Handle the following *Resources* with ease from the central [hub](Datastore) ... //! //! * projects //! * [*allocate ids*](api::ProjectAllocateIdCall), [*begin transaction*](api::ProjectBeginTransactionCall), [*commit*](api::ProjectCommitCall), [*lookup*](api::ProjectLookupCall), [*reserve ids*](api::ProjectReserveIdCall), [*rollback*](api::ProjectRollbackCall), [*run aggregation query*](api::ProjectRunAggregationQueryCall) and [*run query*](api::ProjectRunQueryCall) @@ -50,8 +50,8 @@ //! let r = hub.projects().lookup(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -80,12 +80,12 @@ //! use std::default::Default; //! use datastore1_beta3::{Datastore, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -126,10 +126,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -139,25 +139,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/datastream1/README.md b/gen/datastream1/README.md index 05c35947e9..4c1e13b5ab 100644 --- a/gen/datastream1/README.md +++ b/gen/datastream1/README.md @@ -11,7 +11,7 @@ Everything else about the *Datastream* *v1* API can be found at the [official documentation site](https://cloud.google.com/datastream/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-datastream1/5.0.3+20230111/google_datastream1/Datastream) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-datastream1/5.0.3+20230111/google_datastream1/Datastream) ... * projects * [*locations connection profiles create*](https://docs.rs/google-datastream1/5.0.3+20230111/google_datastream1/api::ProjectLocationConnectionProfileCreateCall), [*locations connection profiles delete*](https://docs.rs/google-datastream1/5.0.3+20230111/google_datastream1/api::ProjectLocationConnectionProfileDeleteCall), [*locations connection profiles discover*](https://docs.rs/google-datastream1/5.0.3+20230111/google_datastream1/api::ProjectLocationConnectionProfileDiscoverCall), [*locations connection profiles get*](https://docs.rs/google-datastream1/5.0.3+20230111/google_datastream1/api::ProjectLocationConnectionProfileGetCall), [*locations connection profiles list*](https://docs.rs/google-datastream1/5.0.3+20230111/google_datastream1/api::ProjectLocationConnectionProfileListCall), [*locations connection profiles patch*](https://docs.rs/google-datastream1/5.0.3+20230111/google_datastream1/api::ProjectLocationConnectionProfilePatchCall), [*locations fetch static ips*](https://docs.rs/google-datastream1/5.0.3+20230111/google_datastream1/api::ProjectLocationFetchStaticIpCall), [*locations get*](https://docs.rs/google-datastream1/5.0.3+20230111/google_datastream1/api::ProjectLocationGetCall), [*locations list*](https://docs.rs/google-datastream1/5.0.3+20230111/google_datastream1/api::ProjectLocationListCall), [*locations operations cancel*](https://docs.rs/google-datastream1/5.0.3+20230111/google_datastream1/api::ProjectLocationOperationCancelCall), [*locations operations delete*](https://docs.rs/google-datastream1/5.0.3+20230111/google_datastream1/api::ProjectLocationOperationDeleteCall), [*locations operations get*](https://docs.rs/google-datastream1/5.0.3+20230111/google_datastream1/api::ProjectLocationOperationGetCall), [*locations operations list*](https://docs.rs/google-datastream1/5.0.3+20230111/google_datastream1/api::ProjectLocationOperationListCall), [*locations private connections create*](https://docs.rs/google-datastream1/5.0.3+20230111/google_datastream1/api::ProjectLocationPrivateConnectionCreateCall), [*locations private connections delete*](https://docs.rs/google-datastream1/5.0.3+20230111/google_datastream1/api::ProjectLocationPrivateConnectionDeleteCall), [*locations private connections get*](https://docs.rs/google-datastream1/5.0.3+20230111/google_datastream1/api::ProjectLocationPrivateConnectionGetCall), [*locations private connections list*](https://docs.rs/google-datastream1/5.0.3+20230111/google_datastream1/api::ProjectLocationPrivateConnectionListCall), [*locations private connections routes create*](https://docs.rs/google-datastream1/5.0.3+20230111/google_datastream1/api::ProjectLocationPrivateConnectionRouteCreateCall), [*locations private connections routes delete*](https://docs.rs/google-datastream1/5.0.3+20230111/google_datastream1/api::ProjectLocationPrivateConnectionRouteDeleteCall), [*locations private connections routes get*](https://docs.rs/google-datastream1/5.0.3+20230111/google_datastream1/api::ProjectLocationPrivateConnectionRouteGetCall), [*locations private connections routes list*](https://docs.rs/google-datastream1/5.0.3+20230111/google_datastream1/api::ProjectLocationPrivateConnectionRouteListCall), [*locations streams create*](https://docs.rs/google-datastream1/5.0.3+20230111/google_datastream1/api::ProjectLocationStreamCreateCall), [*locations streams delete*](https://docs.rs/google-datastream1/5.0.3+20230111/google_datastream1/api::ProjectLocationStreamDeleteCall), [*locations streams get*](https://docs.rs/google-datastream1/5.0.3+20230111/google_datastream1/api::ProjectLocationStreamGetCall), [*locations streams list*](https://docs.rs/google-datastream1/5.0.3+20230111/google_datastream1/api::ProjectLocationStreamListCall), [*locations streams objects get*](https://docs.rs/google-datastream1/5.0.3+20230111/google_datastream1/api::ProjectLocationStreamObjectGetCall), [*locations streams objects list*](https://docs.rs/google-datastream1/5.0.3+20230111/google_datastream1/api::ProjectLocationStreamObjectListCall), [*locations streams objects lookup*](https://docs.rs/google-datastream1/5.0.3+20230111/google_datastream1/api::ProjectLocationStreamObjectLookupCall), [*locations streams objects start backfill job*](https://docs.rs/google-datastream1/5.0.3+20230111/google_datastream1/api::ProjectLocationStreamObjectStartBackfillJobCall), [*locations streams objects stop backfill job*](https://docs.rs/google-datastream1/5.0.3+20230111/google_datastream1/api::ProjectLocationStreamObjectStopBackfillJobCall) and [*locations streams patch*](https://docs.rs/google-datastream1/5.0.3+20230111/google_datastream1/api::ProjectLocationStreamPatchCall) @@ -60,8 +60,8 @@ let r = hub.projects().locations_streams_delete(...).doit().await let r = hub.projects().locations_streams_patch(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -89,12 +89,12 @@ use datastream1::{Result, Error}; use std::default::Default; use datastream1::{Datastream, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -139,10 +139,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-datastream1/5.0.3+20230111/google_datastream1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-datastream1/5.0.3+20230111/google_datastream1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -152,25 +152,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-datast You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-datastream1/5.0.3+20230111/google_datastream1/client::Delegate) to the -[Method Builder](https://docs.rs/google-datastream1/5.0.3+20230111/google_datastream1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-datastream1/5.0.3+20230111/google_datastream1/client::Delegate) to the +[Method Builder](https://docs.rs/google-datastream1/5.0.3+20230111/google_datastream1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-datastream1/5.0.3+20230111/google_datastream1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-datastream1/5.0.3+20230111/google_datastream1/client::RequestValue) and -[decodable](https://docs.rs/google-datastream1/5.0.3+20230111/google_datastream1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-datastream1/5.0.3+20230111/google_datastream1/client::RequestValue) and +[decodable](https://docs.rs/google-datastream1/5.0.3+20230111/google_datastream1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-datastream1/5.0.3+20230111/google_datastream1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-datastream1/5.0.3+20230111/google_datastream1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -189,7 +189,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **datastream1** library was generated by Sebastian Thiel, and is placed +The **datastream1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/datastream1/src/api.rs b/gen/datastream1/src/api.rs index 060031e080..ebcb0a3c4d 100644 --- a/gen/datastream1/src/api.rs +++ b/gen/datastream1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use datastream1::{Datastream, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/datastream1/src/lib.rs b/gen/datastream1/src/lib.rs index 1df3751537..572a7b48c4 100644 --- a/gen/datastream1/src/lib.rs +++ b/gen/datastream1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/datastream1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Datastream) ... +//! Handle the following *Resources* with ease from the central [hub](Datastream) ... //! //! * projects //! * [*locations connection profiles create*](api::ProjectLocationConnectionProfileCreateCall), [*locations connection profiles delete*](api::ProjectLocationConnectionProfileDeleteCall), [*locations connection profiles discover*](api::ProjectLocationConnectionProfileDiscoverCall), [*locations connection profiles get*](api::ProjectLocationConnectionProfileGetCall), [*locations connection profiles list*](api::ProjectLocationConnectionProfileListCall), [*locations connection profiles patch*](api::ProjectLocationConnectionProfilePatchCall), [*locations fetch static ips*](api::ProjectLocationFetchStaticIpCall), [*locations get*](api::ProjectLocationGetCall), [*locations list*](api::ProjectLocationListCall), [*locations operations cancel*](api::ProjectLocationOperationCancelCall), [*locations operations delete*](api::ProjectLocationOperationDeleteCall), [*locations operations get*](api::ProjectLocationOperationGetCall), [*locations operations list*](api::ProjectLocationOperationListCall), [*locations private connections create*](api::ProjectLocationPrivateConnectionCreateCall), [*locations private connections delete*](api::ProjectLocationPrivateConnectionDeleteCall), [*locations private connections get*](api::ProjectLocationPrivateConnectionGetCall), [*locations private connections list*](api::ProjectLocationPrivateConnectionListCall), [*locations private connections routes create*](api::ProjectLocationPrivateConnectionRouteCreateCall), [*locations private connections routes delete*](api::ProjectLocationPrivateConnectionRouteDeleteCall), [*locations private connections routes get*](api::ProjectLocationPrivateConnectionRouteGetCall), [*locations private connections routes list*](api::ProjectLocationPrivateConnectionRouteListCall), [*locations streams create*](api::ProjectLocationStreamCreateCall), [*locations streams delete*](api::ProjectLocationStreamDeleteCall), [*locations streams get*](api::ProjectLocationStreamGetCall), [*locations streams list*](api::ProjectLocationStreamListCall), [*locations streams objects get*](api::ProjectLocationStreamObjectGetCall), [*locations streams objects list*](api::ProjectLocationStreamObjectListCall), [*locations streams objects lookup*](api::ProjectLocationStreamObjectLookupCall), [*locations streams objects start backfill job*](api::ProjectLocationStreamObjectStartBackfillJobCall), [*locations streams objects stop backfill job*](api::ProjectLocationStreamObjectStopBackfillJobCall) and [*locations streams patch*](api::ProjectLocationStreamPatchCall) @@ -60,8 +60,8 @@ //! let r = hub.projects().locations_streams_patch(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -90,12 +90,12 @@ //! use std::default::Default; //! use datastream1::{Datastream, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -140,10 +140,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -153,25 +153,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/deploymentmanager2/README.md b/gen/deploymentmanager2/README.md index de3694d830..949c6f57cb 100644 --- a/gen/deploymentmanager2/README.md +++ b/gen/deploymentmanager2/README.md @@ -11,7 +11,7 @@ Everything else about the *Deployment Manager* *v2* API can be found at the [official documentation site](https://cloud.google.com/deployment-manager). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-deploymentmanager2/5.0.3+20221208/google_deploymentmanager2/DeploymentManager) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-deploymentmanager2/5.0.3+20221208/google_deploymentmanager2/DeploymentManager) ... * [deployments](https://docs.rs/google-deploymentmanager2/5.0.3+20221208/google_deploymentmanager2/api::Deployment) * [*cancel preview*](https://docs.rs/google-deploymentmanager2/5.0.3+20221208/google_deploymentmanager2/api::DeploymentCancelPreviewCall), [*delete*](https://docs.rs/google-deploymentmanager2/5.0.3+20221208/google_deploymentmanager2/api::DeploymentDeleteCall), [*get*](https://docs.rs/google-deploymentmanager2/5.0.3+20221208/google_deploymentmanager2/api::DeploymentGetCall), [*get iam policy*](https://docs.rs/google-deploymentmanager2/5.0.3+20221208/google_deploymentmanager2/api::DeploymentGetIamPolicyCall), [*insert*](https://docs.rs/google-deploymentmanager2/5.0.3+20221208/google_deploymentmanager2/api::DeploymentInsertCall), [*list*](https://docs.rs/google-deploymentmanager2/5.0.3+20221208/google_deploymentmanager2/api::DeploymentListCall), [*patch*](https://docs.rs/google-deploymentmanager2/5.0.3+20221208/google_deploymentmanager2/api::DeploymentPatchCall), [*set iam policy*](https://docs.rs/google-deploymentmanager2/5.0.3+20221208/google_deploymentmanager2/api::DeploymentSetIamPolicyCall), [*stop*](https://docs.rs/google-deploymentmanager2/5.0.3+20221208/google_deploymentmanager2/api::DeploymentStopCall), [*test iam permissions*](https://docs.rs/google-deploymentmanager2/5.0.3+20221208/google_deploymentmanager2/api::DeploymentTestIamPermissionCall) and [*update*](https://docs.rs/google-deploymentmanager2/5.0.3+20221208/google_deploymentmanager2/api::DeploymentUpdateCall) @@ -68,8 +68,8 @@ let r = hub.deployments().test_iam_permissions(...).doit().await let r = hub.deployments().update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -97,12 +97,12 @@ use deploymentmanager2::{Result, Error}; use std::default::Default; use deploymentmanager2::{DeploymentManager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -146,10 +146,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-deploymentmanager2/5.0.3+20221208/google_deploymentmanager2/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-deploymentmanager2/5.0.3+20221208/google_deploymentmanager2/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -159,25 +159,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-deploy You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-deploymentmanager2/5.0.3+20221208/google_deploymentmanager2/client::Delegate) to the -[Method Builder](https://docs.rs/google-deploymentmanager2/5.0.3+20221208/google_deploymentmanager2/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-deploymentmanager2/5.0.3+20221208/google_deploymentmanager2/client::Delegate) to the +[Method Builder](https://docs.rs/google-deploymentmanager2/5.0.3+20221208/google_deploymentmanager2/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-deploymentmanager2/5.0.3+20221208/google_deploymentmanager2/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-deploymentmanager2/5.0.3+20221208/google_deploymentmanager2/client::RequestValue) and -[decodable](https://docs.rs/google-deploymentmanager2/5.0.3+20221208/google_deploymentmanager2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-deploymentmanager2/5.0.3+20221208/google_deploymentmanager2/client::RequestValue) and +[decodable](https://docs.rs/google-deploymentmanager2/5.0.3+20221208/google_deploymentmanager2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-deploymentmanager2/5.0.3+20221208/google_deploymentmanager2/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-deploymentmanager2/5.0.3+20221208/google_deploymentmanager2/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -196,7 +196,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **deploymentmanager2** library was generated by Sebastian Thiel, and is placed +The **deploymentmanager2** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/deploymentmanager2/src/api.rs b/gen/deploymentmanager2/src/api.rs index bdaf57703c..0d02673d46 100644 --- a/gen/deploymentmanager2/src/api.rs +++ b/gen/deploymentmanager2/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -77,12 +77,12 @@ impl Default for Scope { /// use std::default::Default; /// use deploymentmanager2::{DeploymentManager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/deploymentmanager2/src/lib.rs b/gen/deploymentmanager2/src/lib.rs index 070451f8c3..57dce55739 100644 --- a/gen/deploymentmanager2/src/lib.rs +++ b/gen/deploymentmanager2/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/deploymentmanager2). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](DeploymentManager) ... +//! Handle the following *Resources* with ease from the central [hub](DeploymentManager) ... //! //! * [deployments](api::Deployment) //! * [*cancel preview*](api::DeploymentCancelPreviewCall), [*delete*](api::DeploymentDeleteCall), [*get*](api::DeploymentGetCall), [*get iam policy*](api::DeploymentGetIamPolicyCall), [*insert*](api::DeploymentInsertCall), [*list*](api::DeploymentListCall), [*patch*](api::DeploymentPatchCall), [*set iam policy*](api::DeploymentSetIamPolicyCall), [*stop*](api::DeploymentStopCall), [*test iam permissions*](api::DeploymentTestIamPermissionCall) and [*update*](api::DeploymentUpdateCall) @@ -68,8 +68,8 @@ //! let r = hub.deployments().update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -98,12 +98,12 @@ //! use std::default::Default; //! use deploymentmanager2::{DeploymentManager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -147,10 +147,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -160,25 +160,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/deploymentmanager2_beta2/README.md b/gen/deploymentmanager2_beta2/README.md index 79d2563a1d..700f1df813 100644 --- a/gen/deploymentmanager2_beta2/README.md +++ b/gen/deploymentmanager2_beta2/README.md @@ -11,7 +11,7 @@ Everything else about the *Deployment Manager* *v2_beta2* API can be found at th [official documentation site](https://developers.google.com/deployment-manager/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-deploymentmanager2_beta2/5.0.3+20160201/google_deploymentmanager2_beta2/DeploymentManager) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-deploymentmanager2_beta2/5.0.3+20160201/google_deploymentmanager2_beta2/DeploymentManager) ... * [deployments](https://docs.rs/google-deploymentmanager2_beta2/5.0.3+20160201/google_deploymentmanager2_beta2/api::Deployment) * [*delete*](https://docs.rs/google-deploymentmanager2_beta2/5.0.3+20160201/google_deploymentmanager2_beta2/api::DeploymentDeleteCall), [*get*](https://docs.rs/google-deploymentmanager2_beta2/5.0.3+20160201/google_deploymentmanager2_beta2/api::DeploymentGetCall), [*insert*](https://docs.rs/google-deploymentmanager2_beta2/5.0.3+20160201/google_deploymentmanager2_beta2/api::DeploymentInsertCall), [*list*](https://docs.rs/google-deploymentmanager2_beta2/5.0.3+20160201/google_deploymentmanager2_beta2/api::DeploymentListCall), [*patch*](https://docs.rs/google-deploymentmanager2_beta2/5.0.3+20160201/google_deploymentmanager2_beta2/api::DeploymentPatchCall) and [*update*](https://docs.rs/google-deploymentmanager2_beta2/5.0.3+20160201/google_deploymentmanager2_beta2/api::DeploymentUpdateCall) @@ -63,8 +63,8 @@ let r = hub.operations().get(...).doit().await let r = hub.operations().list(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -92,12 +92,12 @@ use deploymentmanager2_beta2::{Result, Error}; use std::default::Default; use deploymentmanager2_beta2::{DeploymentManager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -141,10 +141,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-deploymentmanager2_beta2/5.0.3+20160201/google_deploymentmanager2_beta2/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-deploymentmanager2_beta2/5.0.3+20160201/google_deploymentmanager2_beta2/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -154,25 +154,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-deploy You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-deploymentmanager2_beta2/5.0.3+20160201/google_deploymentmanager2_beta2/client::Delegate) to the -[Method Builder](https://docs.rs/google-deploymentmanager2_beta2/5.0.3+20160201/google_deploymentmanager2_beta2/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-deploymentmanager2_beta2/5.0.3+20160201/google_deploymentmanager2_beta2/client::Delegate) to the +[Method Builder](https://docs.rs/google-deploymentmanager2_beta2/5.0.3+20160201/google_deploymentmanager2_beta2/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-deploymentmanager2_beta2/5.0.3+20160201/google_deploymentmanager2_beta2/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-deploymentmanager2_beta2/5.0.3+20160201/google_deploymentmanager2_beta2/client::RequestValue) and -[decodable](https://docs.rs/google-deploymentmanager2_beta2/5.0.3+20160201/google_deploymentmanager2_beta2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-deploymentmanager2_beta2/5.0.3+20160201/google_deploymentmanager2_beta2/client::RequestValue) and +[decodable](https://docs.rs/google-deploymentmanager2_beta2/5.0.3+20160201/google_deploymentmanager2_beta2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-deploymentmanager2_beta2/5.0.3+20160201/google_deploymentmanager2_beta2/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-deploymentmanager2_beta2/5.0.3+20160201/google_deploymentmanager2_beta2/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -191,7 +191,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **deploymentmanager2_beta2** library was generated by Sebastian Thiel, and is placed +The **deploymentmanager2_beta2** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/deploymentmanager2_beta2/src/api.rs b/gen/deploymentmanager2_beta2/src/api.rs index 218ba99ed2..001ee04d62 100644 --- a/gen/deploymentmanager2_beta2/src/api.rs +++ b/gen/deploymentmanager2_beta2/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your data across Google Cloud Platform services CloudPlatform, @@ -77,12 +77,12 @@ impl Default for Scope { /// use std::default::Default; /// use deploymentmanager2_beta2::{DeploymentManager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/deploymentmanager2_beta2/src/lib.rs b/gen/deploymentmanager2_beta2/src/lib.rs index 68c147bc2e..e3d1635f33 100644 --- a/gen/deploymentmanager2_beta2/src/lib.rs +++ b/gen/deploymentmanager2_beta2/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/deploymentmanager2_beta2). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](DeploymentManager) ... +//! Handle the following *Resources* with ease from the central [hub](DeploymentManager) ... //! //! * [deployments](api::Deployment) //! * [*delete*](api::DeploymentDeleteCall), [*get*](api::DeploymentGetCall), [*insert*](api::DeploymentInsertCall), [*list*](api::DeploymentListCall), [*patch*](api::DeploymentPatchCall) and [*update*](api::DeploymentUpdateCall) @@ -63,8 +63,8 @@ //! let r = hub.operations().list(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -93,12 +93,12 @@ //! use std::default::Default; //! use deploymentmanager2_beta2::{DeploymentManager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -142,10 +142,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -155,25 +155,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/dfareporting2d8/README.md b/gen/dfareporting2d8/README.md index 7e7b52e069..79c083c0da 100644 --- a/gen/dfareporting2d8/README.md +++ b/gen/dfareporting2d8/README.md @@ -11,7 +11,7 @@ Everything else about the *dfareporting* *v2d8* API can be found at the [official documentation site](https://developers.google.com/doubleclick-advertisers/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-dfareporting2d8/5.0.3+20180830/google_dfareporting2d8/Dfareporting) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-dfareporting2d8/5.0.3+20180830/google_dfareporting2d8/Dfareporting) ... * [account active ad summaries](https://docs.rs/google-dfareporting2d8/5.0.3+20180830/google_dfareporting2d8/api::AccountActiveAdSummary) * [*get*](https://docs.rs/google-dfareporting2d8/5.0.3+20180830/google_dfareporting2d8/api::AccountActiveAdSummaryGetCall) @@ -186,8 +186,8 @@ let r = hub.reports().run(...).doit().await let r = hub.reports().update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -214,12 +214,12 @@ use dfareporting2d8::{Result, Error}; use std::default::Default; use dfareporting2d8::{Dfareporting, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -259,10 +259,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-dfareporting2d8/5.0.3+20180830/google_dfareporting2d8/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-dfareporting2d8/5.0.3+20180830/google_dfareporting2d8/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -272,25 +272,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-dfarep You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-dfareporting2d8/5.0.3+20180830/google_dfareporting2d8/client::Delegate) to the -[Method Builder](https://docs.rs/google-dfareporting2d8/5.0.3+20180830/google_dfareporting2d8/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-dfareporting2d8/5.0.3+20180830/google_dfareporting2d8/client::Delegate) to the +[Method Builder](https://docs.rs/google-dfareporting2d8/5.0.3+20180830/google_dfareporting2d8/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-dfareporting2d8/5.0.3+20180830/google_dfareporting2d8/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-dfareporting2d8/5.0.3+20180830/google_dfareporting2d8/client::RequestValue) and -[decodable](https://docs.rs/google-dfareporting2d8/5.0.3+20180830/google_dfareporting2d8/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-dfareporting2d8/5.0.3+20180830/google_dfareporting2d8/client::RequestValue) and +[decodable](https://docs.rs/google-dfareporting2d8/5.0.3+20180830/google_dfareporting2d8/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-dfareporting2d8/5.0.3+20180830/google_dfareporting2d8/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-dfareporting2d8/5.0.3+20180830/google_dfareporting2d8/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -309,7 +309,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **dfareporting2d8** library was generated by Sebastian Thiel, and is placed +The **dfareporting2d8** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/dfareporting2d8/src/api.rs b/gen/dfareporting2d8/src/api.rs index 0ed8a9e31e..e8655f0aad 100644 --- a/gen/dfareporting2d8/src/api.rs +++ b/gen/dfareporting2d8/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// Manage DoubleClick Digital Marketing conversions Ddmconversion, @@ -72,12 +72,12 @@ impl Default for Scope { /// use std::default::Default; /// use dfareporting2d8::{Dfareporting, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/dfareporting2d8/src/lib.rs b/gen/dfareporting2d8/src/lib.rs index dacbff3847..824550d383 100644 --- a/gen/dfareporting2d8/src/lib.rs +++ b/gen/dfareporting2d8/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/dfareporting2d8). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Dfareporting) ... +//! Handle the following *Resources* with ease from the central [hub](Dfareporting) ... //! //! * [account active ad summaries](api::AccountActiveAdSummary) //! * [*get*](api::AccountActiveAdSummaryGetCall) @@ -186,8 +186,8 @@ //! let r = hub.reports().update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -215,12 +215,12 @@ //! use std::default::Default; //! use dfareporting2d8::{Dfareporting, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -260,10 +260,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -273,25 +273,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/dfareporting3/README.md b/gen/dfareporting3/README.md index f4aae95c00..e668da85e0 100644 --- a/gen/dfareporting3/README.md +++ b/gen/dfareporting3/README.md @@ -11,7 +11,7 @@ Everything else about the *dfareporting* *v3* API can be found at the [official documentation site](https://developers.google.com/doubleclick-advertisers/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-dfareporting3/5.0.3+20180830/google_dfareporting3/Dfareporting) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-dfareporting3/5.0.3+20180830/google_dfareporting3/Dfareporting) ... * [account active ad summaries](https://docs.rs/google-dfareporting3/5.0.3+20180830/google_dfareporting3/api::AccountActiveAdSummary) * [*get*](https://docs.rs/google-dfareporting3/5.0.3+20180830/google_dfareporting3/api::AccountActiveAdSummaryGetCall) @@ -186,8 +186,8 @@ let r = hub.reports().run(...).doit().await let r = hub.reports().update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -214,12 +214,12 @@ use dfareporting3::{Result, Error}; use std::default::Default; use dfareporting3::{Dfareporting, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -259,10 +259,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-dfareporting3/5.0.3+20180830/google_dfareporting3/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-dfareporting3/5.0.3+20180830/google_dfareporting3/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -272,25 +272,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-dfarep You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-dfareporting3/5.0.3+20180830/google_dfareporting3/client::Delegate) to the -[Method Builder](https://docs.rs/google-dfareporting3/5.0.3+20180830/google_dfareporting3/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-dfareporting3/5.0.3+20180830/google_dfareporting3/client::Delegate) to the +[Method Builder](https://docs.rs/google-dfareporting3/5.0.3+20180830/google_dfareporting3/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-dfareporting3/5.0.3+20180830/google_dfareporting3/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-dfareporting3/5.0.3+20180830/google_dfareporting3/client::RequestValue) and -[decodable](https://docs.rs/google-dfareporting3/5.0.3+20180830/google_dfareporting3/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-dfareporting3/5.0.3+20180830/google_dfareporting3/client::RequestValue) and +[decodable](https://docs.rs/google-dfareporting3/5.0.3+20180830/google_dfareporting3/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-dfareporting3/5.0.3+20180830/google_dfareporting3/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-dfareporting3/5.0.3+20180830/google_dfareporting3/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -309,7 +309,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **dfareporting3** library was generated by Sebastian Thiel, and is placed +The **dfareporting3** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/dfareporting3/src/api.rs b/gen/dfareporting3/src/api.rs index b0d448bfeb..80287349da 100644 --- a/gen/dfareporting3/src/api.rs +++ b/gen/dfareporting3/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// Manage DoubleClick Digital Marketing conversions Ddmconversion, @@ -72,12 +72,12 @@ impl Default for Scope { /// use std::default::Default; /// use dfareporting3::{Dfareporting, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/dfareporting3/src/lib.rs b/gen/dfareporting3/src/lib.rs index 6140236255..1dd09d84c9 100644 --- a/gen/dfareporting3/src/lib.rs +++ b/gen/dfareporting3/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/dfareporting3). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Dfareporting) ... +//! Handle the following *Resources* with ease from the central [hub](Dfareporting) ... //! //! * [account active ad summaries](api::AccountActiveAdSummary) //! * [*get*](api::AccountActiveAdSummaryGetCall) @@ -186,8 +186,8 @@ //! let r = hub.reports().update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -215,12 +215,12 @@ //! use std::default::Default; //! use dfareporting3::{Dfareporting, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -260,10 +260,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -273,25 +273,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/dfareporting3d2/README.md b/gen/dfareporting3d2/README.md index fa5e42823d..d611bf938a 100644 --- a/gen/dfareporting3d2/README.md +++ b/gen/dfareporting3d2/README.md @@ -11,7 +11,7 @@ Everything else about the *dfareporting* *v3d2* API can be found at the [official documentation site](https://developers.google.com/doubleclick-advertisers/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-dfareporting3d2/5.0.3+20190531/google_dfareporting3d2/Dfareporting) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-dfareporting3d2/5.0.3+20190531/google_dfareporting3d2/Dfareporting) ... * [account active ad summaries](https://docs.rs/google-dfareporting3d2/5.0.3+20190531/google_dfareporting3d2/api::AccountActiveAdSummary) * [*get*](https://docs.rs/google-dfareporting3d2/5.0.3+20190531/google_dfareporting3d2/api::AccountActiveAdSummaryGetCall) @@ -188,8 +188,8 @@ let r = hub.reports().run(...).doit().await let r = hub.reports().update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -216,12 +216,12 @@ use dfareporting3d2::{Result, Error}; use std::default::Default; use dfareporting3d2::{Dfareporting, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -261,10 +261,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-dfareporting3d2/5.0.3+20190531/google_dfareporting3d2/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-dfareporting3d2/5.0.3+20190531/google_dfareporting3d2/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -274,25 +274,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-dfarep You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-dfareporting3d2/5.0.3+20190531/google_dfareporting3d2/client::Delegate) to the -[Method Builder](https://docs.rs/google-dfareporting3d2/5.0.3+20190531/google_dfareporting3d2/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-dfareporting3d2/5.0.3+20190531/google_dfareporting3d2/client::Delegate) to the +[Method Builder](https://docs.rs/google-dfareporting3d2/5.0.3+20190531/google_dfareporting3d2/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-dfareporting3d2/5.0.3+20190531/google_dfareporting3d2/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-dfareporting3d2/5.0.3+20190531/google_dfareporting3d2/client::RequestValue) and -[decodable](https://docs.rs/google-dfareporting3d2/5.0.3+20190531/google_dfareporting3d2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-dfareporting3d2/5.0.3+20190531/google_dfareporting3d2/client::RequestValue) and +[decodable](https://docs.rs/google-dfareporting3d2/5.0.3+20190531/google_dfareporting3d2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-dfareporting3d2/5.0.3+20190531/google_dfareporting3d2/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-dfareporting3d2/5.0.3+20190531/google_dfareporting3d2/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -311,7 +311,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **dfareporting3d2** library was generated by Sebastian Thiel, and is placed +The **dfareporting3d2** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/dfareporting3d2/src/api.rs b/gen/dfareporting3d2/src/api.rs index 42b34867e4..755109d4de 100644 --- a/gen/dfareporting3d2/src/api.rs +++ b/gen/dfareporting3d2/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// Manage DoubleClick Digital Marketing conversions Ddmconversion, @@ -72,12 +72,12 @@ impl Default for Scope { /// use std::default::Default; /// use dfareporting3d2::{Dfareporting, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/dfareporting3d2/src/lib.rs b/gen/dfareporting3d2/src/lib.rs index d140aa3373..3bc9c5ce06 100644 --- a/gen/dfareporting3d2/src/lib.rs +++ b/gen/dfareporting3d2/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/dfareporting3d2). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Dfareporting) ... +//! Handle the following *Resources* with ease from the central [hub](Dfareporting) ... //! //! * [account active ad summaries](api::AccountActiveAdSummary) //! * [*get*](api::AccountActiveAdSummaryGetCall) @@ -188,8 +188,8 @@ //! let r = hub.reports().update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -217,12 +217,12 @@ //! use std::default::Default; //! use dfareporting3d2::{Dfareporting, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -262,10 +262,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -275,25 +275,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/dfareporting3d3/README.md b/gen/dfareporting3d3/README.md index 4e71a8a712..0268f882ee 100644 --- a/gen/dfareporting3d3/README.md +++ b/gen/dfareporting3d3/README.md @@ -11,7 +11,7 @@ Everything else about the *Dfareporting* *v3d3* API can be found at the [official documentation site](https://developers.google.com/doubleclick-advertisers/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-dfareporting3d3/5.0.3+20220104/google_dfareporting3d3/Dfareporting) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-dfareporting3d3/5.0.3+20220104/google_dfareporting3d3/Dfareporting) ... * [account active ad summaries](https://docs.rs/google-dfareporting3d3/5.0.3+20220104/google_dfareporting3d3/api::AccountActiveAdSummary) * [*get*](https://docs.rs/google-dfareporting3d3/5.0.3+20220104/google_dfareporting3d3/api::AccountActiveAdSummaryGetCall) @@ -186,8 +186,8 @@ let r = hub.reports().run(...).doit().await let r = hub.reports().update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -214,12 +214,12 @@ use dfareporting3d3::{Result, Error}; use std::default::Default; use dfareporting3d3::{Dfareporting, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -259,10 +259,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-dfareporting3d3/5.0.3+20220104/google_dfareporting3d3/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-dfareporting3d3/5.0.3+20220104/google_dfareporting3d3/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -272,25 +272,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-dfarep You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-dfareporting3d3/5.0.3+20220104/google_dfareporting3d3/client::Delegate) to the -[Method Builder](https://docs.rs/google-dfareporting3d3/5.0.3+20220104/google_dfareporting3d3/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-dfareporting3d3/5.0.3+20220104/google_dfareporting3d3/client::Delegate) to the +[Method Builder](https://docs.rs/google-dfareporting3d3/5.0.3+20220104/google_dfareporting3d3/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-dfareporting3d3/5.0.3+20220104/google_dfareporting3d3/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-dfareporting3d3/5.0.3+20220104/google_dfareporting3d3/client::RequestValue) and -[decodable](https://docs.rs/google-dfareporting3d3/5.0.3+20220104/google_dfareporting3d3/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-dfareporting3d3/5.0.3+20220104/google_dfareporting3d3/client::RequestValue) and +[decodable](https://docs.rs/google-dfareporting3d3/5.0.3+20220104/google_dfareporting3d3/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-dfareporting3d3/5.0.3+20220104/google_dfareporting3d3/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-dfareporting3d3/5.0.3+20220104/google_dfareporting3d3/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -309,7 +309,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **dfareporting3d3** library was generated by Sebastian Thiel, and is placed +The **dfareporting3d3** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/dfareporting3d3/src/api.rs b/gen/dfareporting3d3/src/api.rs index 13026b148a..be4b607421 100644 --- a/gen/dfareporting3d3/src/api.rs +++ b/gen/dfareporting3d3/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// Manage DoubleClick Digital Marketing conversions Ddmconversion, @@ -72,12 +72,12 @@ impl Default for Scope { /// use std::default::Default; /// use dfareporting3d3::{Dfareporting, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/dfareporting3d3/src/lib.rs b/gen/dfareporting3d3/src/lib.rs index 102776c2c5..5d3878629b 100644 --- a/gen/dfareporting3d3/src/lib.rs +++ b/gen/dfareporting3d3/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/dfareporting3d3). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Dfareporting) ... +//! Handle the following *Resources* with ease from the central [hub](Dfareporting) ... //! //! * [account active ad summaries](api::AccountActiveAdSummary) //! * [*get*](api::AccountActiveAdSummaryGetCall) @@ -186,8 +186,8 @@ //! let r = hub.reports().update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -215,12 +215,12 @@ //! use std::default::Default; //! use dfareporting3d3::{Dfareporting, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -260,10 +260,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -273,25 +273,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/dfareporting3d4/README.md b/gen/dfareporting3d4/README.md index 20a51bb14c..55f66b3d75 100644 --- a/gen/dfareporting3d4/README.md +++ b/gen/dfareporting3d4/README.md @@ -11,7 +11,7 @@ Everything else about the *Dfareporting* *v3d4* API can be found at the [official documentation site](https://developers.google.com/doubleclick-advertisers/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-dfareporting3d4/5.0.3+20230118/google_dfareporting3d4/Dfareporting) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-dfareporting3d4/5.0.3+20230118/google_dfareporting3d4/Dfareporting) ... * [account active ad summaries](https://docs.rs/google-dfareporting3d4/5.0.3+20230118/google_dfareporting3d4/api::AccountActiveAdSummary) * [*get*](https://docs.rs/google-dfareporting3d4/5.0.3+20230118/google_dfareporting3d4/api::AccountActiveAdSummaryGetCall) @@ -188,8 +188,8 @@ let r = hub.reports().run(...).doit().await let r = hub.reports().update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -216,12 +216,12 @@ use dfareporting3d4::{Result, Error}; use std::default::Default; use dfareporting3d4::{Dfareporting, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -261,10 +261,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-dfareporting3d4/5.0.3+20230118/google_dfareporting3d4/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-dfareporting3d4/5.0.3+20230118/google_dfareporting3d4/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -274,25 +274,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-dfarep You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-dfareporting3d4/5.0.3+20230118/google_dfareporting3d4/client::Delegate) to the -[Method Builder](https://docs.rs/google-dfareporting3d4/5.0.3+20230118/google_dfareporting3d4/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-dfareporting3d4/5.0.3+20230118/google_dfareporting3d4/client::Delegate) to the +[Method Builder](https://docs.rs/google-dfareporting3d4/5.0.3+20230118/google_dfareporting3d4/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-dfareporting3d4/5.0.3+20230118/google_dfareporting3d4/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-dfareporting3d4/5.0.3+20230118/google_dfareporting3d4/client::RequestValue) and -[decodable](https://docs.rs/google-dfareporting3d4/5.0.3+20230118/google_dfareporting3d4/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-dfareporting3d4/5.0.3+20230118/google_dfareporting3d4/client::RequestValue) and +[decodable](https://docs.rs/google-dfareporting3d4/5.0.3+20230118/google_dfareporting3d4/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-dfareporting3d4/5.0.3+20230118/google_dfareporting3d4/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-dfareporting3d4/5.0.3+20230118/google_dfareporting3d4/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -311,7 +311,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **dfareporting3d4** library was generated by Sebastian Thiel, and is placed +The **dfareporting3d4** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/dfareporting3d4/src/api.rs b/gen/dfareporting3d4/src/api.rs index 1172d6d9f4..bea6bac822 100644 --- a/gen/dfareporting3d4/src/api.rs +++ b/gen/dfareporting3d4/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// Manage DoubleClick Digital Marketing conversions Ddmconversion, @@ -72,12 +72,12 @@ impl Default for Scope { /// use std::default::Default; /// use dfareporting3d4::{Dfareporting, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/dfareporting3d4/src/lib.rs b/gen/dfareporting3d4/src/lib.rs index c4e78a8d13..fbeab62485 100644 --- a/gen/dfareporting3d4/src/lib.rs +++ b/gen/dfareporting3d4/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/dfareporting3d4). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Dfareporting) ... +//! Handle the following *Resources* with ease from the central [hub](Dfareporting) ... //! //! * [account active ad summaries](api::AccountActiveAdSummary) //! * [*get*](api::AccountActiveAdSummaryGetCall) @@ -188,8 +188,8 @@ //! let r = hub.reports().update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -217,12 +217,12 @@ //! use std::default::Default; //! use dfareporting3d4::{Dfareporting, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -262,10 +262,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -275,25 +275,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/dfareporting3d5/README.md b/gen/dfareporting3d5/README.md index bf8993f6fb..51fc43cf4a 100644 --- a/gen/dfareporting3d5/README.md +++ b/gen/dfareporting3d5/README.md @@ -11,7 +11,7 @@ Everything else about the *Dfareporting* *v3d5* API can be found at the [official documentation site](https://developers.google.com/doubleclick-advertisers/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-dfareporting3d5/5.0.3+20230118/google_dfareporting3d5/Dfareporting) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-dfareporting3d5/5.0.3+20230118/google_dfareporting3d5/Dfareporting) ... * [account active ad summaries](https://docs.rs/google-dfareporting3d5/5.0.3+20230118/google_dfareporting3d5/api::AccountActiveAdSummary) * [*get*](https://docs.rs/google-dfareporting3d5/5.0.3+20230118/google_dfareporting3d5/api::AccountActiveAdSummaryGetCall) @@ -186,8 +186,8 @@ let r = hub.reports().run(...).doit().await let r = hub.reports().update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -214,12 +214,12 @@ use dfareporting3d5::{Result, Error}; use std::default::Default; use dfareporting3d5::{Dfareporting, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -259,10 +259,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-dfareporting3d5/5.0.3+20230118/google_dfareporting3d5/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-dfareporting3d5/5.0.3+20230118/google_dfareporting3d5/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -272,25 +272,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-dfarep You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-dfareporting3d5/5.0.3+20230118/google_dfareporting3d5/client::Delegate) to the -[Method Builder](https://docs.rs/google-dfareporting3d5/5.0.3+20230118/google_dfareporting3d5/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-dfareporting3d5/5.0.3+20230118/google_dfareporting3d5/client::Delegate) to the +[Method Builder](https://docs.rs/google-dfareporting3d5/5.0.3+20230118/google_dfareporting3d5/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-dfareporting3d5/5.0.3+20230118/google_dfareporting3d5/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-dfareporting3d5/5.0.3+20230118/google_dfareporting3d5/client::RequestValue) and -[decodable](https://docs.rs/google-dfareporting3d5/5.0.3+20230118/google_dfareporting3d5/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-dfareporting3d5/5.0.3+20230118/google_dfareporting3d5/client::RequestValue) and +[decodable](https://docs.rs/google-dfareporting3d5/5.0.3+20230118/google_dfareporting3d5/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-dfareporting3d5/5.0.3+20230118/google_dfareporting3d5/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-dfareporting3d5/5.0.3+20230118/google_dfareporting3d5/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -309,7 +309,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **dfareporting3d5** library was generated by Sebastian Thiel, and is placed +The **dfareporting3d5** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/dfareporting3d5/src/api.rs b/gen/dfareporting3d5/src/api.rs index 49ffd282c4..39656af5df 100644 --- a/gen/dfareporting3d5/src/api.rs +++ b/gen/dfareporting3d5/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// Manage DoubleClick Digital Marketing conversions Ddmconversion, @@ -72,12 +72,12 @@ impl Default for Scope { /// use std::default::Default; /// use dfareporting3d5::{Dfareporting, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/dfareporting3d5/src/lib.rs b/gen/dfareporting3d5/src/lib.rs index 20c7b12c88..ad46439bec 100644 --- a/gen/dfareporting3d5/src/lib.rs +++ b/gen/dfareporting3d5/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/dfareporting3d5). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Dfareporting) ... +//! Handle the following *Resources* with ease from the central [hub](Dfareporting) ... //! //! * [account active ad summaries](api::AccountActiveAdSummary) //! * [*get*](api::AccountActiveAdSummaryGetCall) @@ -186,8 +186,8 @@ //! let r = hub.reports().update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -215,12 +215,12 @@ //! use std::default::Default; //! use dfareporting3d5::{Dfareporting, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -260,10 +260,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -273,25 +273,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/dialogflow2/README.md b/gen/dialogflow2/README.md index 14876c1688..fa97b22547 100644 --- a/gen/dialogflow2/README.md +++ b/gen/dialogflow2/README.md @@ -11,7 +11,7 @@ Everything else about the *Dialogflow* *v2* API can be found at the [official documentation site](https://cloud.google.com/dialogflow/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/Dialogflow) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/Dialogflow) ... * projects * [*agent entity types batch delete*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentEntityTypeBatchDeleteCall), [*agent entity types batch update*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentEntityTypeBatchUpdateCall), [*agent entity types create*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentEntityTypeCreateCall), [*agent entity types delete*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentEntityTypeDeleteCall), [*agent entity types entities batch create*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentEntityTypeEntityBatchCreateCall), [*agent entity types entities batch delete*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentEntityTypeEntityBatchDeleteCall), [*agent entity types entities batch update*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentEntityTypeEntityBatchUpdateCall), [*agent entity types get*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentEntityTypeGetCall), [*agent entity types list*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentEntityTypeListCall), [*agent entity types patch*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentEntityTypePatchCall), [*agent environments create*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentEnvironmentCreateCall), [*agent environments delete*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentEnvironmentDeleteCall), [*agent environments get*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentEnvironmentGetCall), [*agent environments get history*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentEnvironmentGetHistoryCall), [*agent environments intents list*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentEnvironmentIntentListCall), [*agent environments list*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentEnvironmentListCall), [*agent environments patch*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentEnvironmentPatchCall), [*agent environments users sessions contexts create*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentEnvironmentUserSessionContextCreateCall), [*agent environments users sessions contexts delete*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentEnvironmentUserSessionContextDeleteCall), [*agent environments users sessions contexts get*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentEnvironmentUserSessionContextGetCall), [*agent environments users sessions contexts list*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentEnvironmentUserSessionContextListCall), [*agent environments users sessions contexts patch*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentEnvironmentUserSessionContextPatchCall), [*agent environments users sessions delete contexts*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentEnvironmentUserSessionDeleteContextCall), [*agent environments users sessions detect intent*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentEnvironmentUserSessionDetectIntentCall), [*agent environments users sessions entity types create*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentEnvironmentUserSessionEntityTypeCreateCall), [*agent environments users sessions entity types delete*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentEnvironmentUserSessionEntityTypeDeleteCall), [*agent environments users sessions entity types get*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentEnvironmentUserSessionEntityTypeGetCall), [*agent environments users sessions entity types list*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentEnvironmentUserSessionEntityTypeListCall), [*agent environments users sessions entity types patch*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentEnvironmentUserSessionEntityTypePatchCall), [*agent export*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentExportCall), [*agent get fulfillment*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentGetFulfillmentCall), [*agent get validation result*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentGetValidationResultCall), [*agent import*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentImportCall), [*agent intents batch delete*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentIntentBatchDeleteCall), [*agent intents batch update*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentIntentBatchUpdateCall), [*agent intents create*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentIntentCreateCall), [*agent intents delete*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentIntentDeleteCall), [*agent intents get*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentIntentGetCall), [*agent intents list*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentIntentListCall), [*agent intents patch*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentIntentPatchCall), [*agent knowledge bases create*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentKnowledgeBaseCreateCall), [*agent knowledge bases delete*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentKnowledgeBaseDeleteCall), [*agent knowledge bases documents create*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentKnowledgeBaseDocumentCreateCall), [*agent knowledge bases documents delete*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentKnowledgeBaseDocumentDeleteCall), [*agent knowledge bases documents get*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentKnowledgeBaseDocumentGetCall), [*agent knowledge bases documents list*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentKnowledgeBaseDocumentListCall), [*agent knowledge bases documents patch*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentKnowledgeBaseDocumentPatchCall), [*agent knowledge bases documents reload*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentKnowledgeBaseDocumentReloadCall), [*agent knowledge bases get*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentKnowledgeBaseGetCall), [*agent knowledge bases list*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentKnowledgeBaseListCall), [*agent knowledge bases patch*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentKnowledgeBasePatchCall), [*agent restore*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentRestoreCall), [*agent search*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentSearchCall), [*agent sessions contexts create*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentSessionContextCreateCall), [*agent sessions contexts delete*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentSessionContextDeleteCall), [*agent sessions contexts get*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentSessionContextGetCall), [*agent sessions contexts list*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentSessionContextListCall), [*agent sessions contexts patch*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentSessionContextPatchCall), [*agent sessions delete contexts*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentSessionDeleteContextCall), [*agent sessions detect intent*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentSessionDetectIntentCall), [*agent sessions entity types create*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentSessionEntityTypeCreateCall), [*agent sessions entity types delete*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentSessionEntityTypeDeleteCall), [*agent sessions entity types get*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentSessionEntityTypeGetCall), [*agent sessions entity types list*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentSessionEntityTypeListCall), [*agent sessions entity types patch*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentSessionEntityTypePatchCall), [*agent train*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentTrainCall), [*agent update fulfillment*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentUpdateFulfillmentCall), [*agent versions create*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentVersionCreateCall), [*agent versions delete*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentVersionDeleteCall), [*agent versions get*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentVersionGetCall), [*agent versions list*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentVersionListCall), [*agent versions patch*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAgentVersionPatchCall), [*answer records list*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAnswerRecordListCall), [*answer records patch*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectAnswerRecordPatchCall), [*conversation datasets get*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectConversationDatasetGetCall), [*conversation datasets import conversation data*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectConversationDatasetImportConversationDataCall), [*conversation datasets list*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectConversationDatasetListCall), [*conversation models create*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectConversationModelCreateCall), [*conversation models delete*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectConversationModelDeleteCall), [*conversation models deploy*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectConversationModelDeployCall), [*conversation models evaluations get*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectConversationModelEvaluationGetCall), [*conversation models evaluations list*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectConversationModelEvaluationListCall), [*conversation models get*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectConversationModelGetCall), [*conversation models list*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectConversationModelListCall), [*conversation models undeploy*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectConversationModelUndeployCall), [*conversation profiles clear suggestion feature config*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectConversationProfileClearSuggestionFeatureConfigCall), [*conversation profiles create*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectConversationProfileCreateCall), [*conversation profiles delete*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectConversationProfileDeleteCall), [*conversation profiles get*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectConversationProfileGetCall), [*conversation profiles list*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectConversationProfileListCall), [*conversation profiles patch*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectConversationProfilePatchCall), [*conversation profiles set suggestion feature config*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectConversationProfileSetSuggestionFeatureConfigCall), [*conversations complete*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectConversationCompleteCall), [*conversations create*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectConversationCreateCall), [*conversations get*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectConversationGetCall), [*conversations list*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectConversationListCall), [*conversations messages list*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectConversationMessageListCall), [*conversations participants analyze content*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectConversationParticipantAnalyzeContentCall), [*conversations participants create*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectConversationParticipantCreateCall), [*conversations participants get*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectConversationParticipantGetCall), [*conversations participants list*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectConversationParticipantListCall), [*conversations participants patch*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectConversationParticipantPatchCall), [*conversations participants suggestions suggest articles*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectConversationParticipantSuggestionSuggestArticleCall), [*conversations participants suggestions suggest faq answers*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectConversationParticipantSuggestionSuggestFaqAnswerCall), [*conversations participants suggestions suggest smart replies*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectConversationParticipantSuggestionSuggestSmartReplyCall), [*conversations suggestions suggest conversation summary*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectConversationSuggestionSuggestConversationSummaryCall), [*delete agent*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectDeleteAgentCall), [*get agent*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectGetAgentCall), [*knowledge bases create*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectKnowledgeBaseCreateCall), [*knowledge bases delete*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectKnowledgeBaseDeleteCall), [*knowledge bases documents create*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectKnowledgeBaseDocumentCreateCall), [*knowledge bases documents delete*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectKnowledgeBaseDocumentDeleteCall), [*knowledge bases documents export*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectKnowledgeBaseDocumentExportCall), [*knowledge bases documents get*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectKnowledgeBaseDocumentGetCall), [*knowledge bases documents import*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectKnowledgeBaseDocumentImportCall), [*knowledge bases documents list*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectKnowledgeBaseDocumentListCall), [*knowledge bases documents patch*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectKnowledgeBaseDocumentPatchCall), [*knowledge bases documents reload*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectKnowledgeBaseDocumentReloadCall), [*knowledge bases get*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectKnowledgeBaseGetCall), [*knowledge bases list*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectKnowledgeBaseListCall), [*knowledge bases patch*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectKnowledgeBasePatchCall), [*locations agent entity types batch delete*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentEntityTypeBatchDeleteCall), [*locations agent entity types batch update*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentEntityTypeBatchUpdateCall), [*locations agent entity types create*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentEntityTypeCreateCall), [*locations agent entity types delete*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentEntityTypeDeleteCall), [*locations agent entity types entities batch create*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentEntityTypeEntityBatchCreateCall), [*locations agent entity types entities batch delete*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentEntityTypeEntityBatchDeleteCall), [*locations agent entity types entities batch update*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentEntityTypeEntityBatchUpdateCall), [*locations agent entity types get*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentEntityTypeGetCall), [*locations agent entity types list*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentEntityTypeListCall), [*locations agent entity types patch*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentEntityTypePatchCall), [*locations agent environments create*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentEnvironmentCreateCall), [*locations agent environments delete*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentEnvironmentDeleteCall), [*locations agent environments get*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentEnvironmentGetCall), [*locations agent environments get history*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentEnvironmentGetHistoryCall), [*locations agent environments intents list*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentEnvironmentIntentListCall), [*locations agent environments list*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentEnvironmentListCall), [*locations agent environments patch*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentEnvironmentPatchCall), [*locations agent environments users sessions contexts create*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentEnvironmentUserSessionContextCreateCall), [*locations agent environments users sessions contexts delete*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentEnvironmentUserSessionContextDeleteCall), [*locations agent environments users sessions contexts get*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentEnvironmentUserSessionContextGetCall), [*locations agent environments users sessions contexts list*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentEnvironmentUserSessionContextListCall), [*locations agent environments users sessions contexts patch*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentEnvironmentUserSessionContextPatchCall), [*locations agent environments users sessions delete contexts*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentEnvironmentUserSessionDeleteContextCall), [*locations agent environments users sessions detect intent*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentEnvironmentUserSessionDetectIntentCall), [*locations agent environments users sessions entity types create*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentEnvironmentUserSessionEntityTypeCreateCall), [*locations agent environments users sessions entity types delete*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentEnvironmentUserSessionEntityTypeDeleteCall), [*locations agent environments users sessions entity types get*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentEnvironmentUserSessionEntityTypeGetCall), [*locations agent environments users sessions entity types list*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentEnvironmentUserSessionEntityTypeListCall), [*locations agent environments users sessions entity types patch*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentEnvironmentUserSessionEntityTypePatchCall), [*locations agent export*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentExportCall), [*locations agent get fulfillment*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentGetFulfillmentCall), [*locations agent get validation result*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentGetValidationResultCall), [*locations agent import*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentImportCall), [*locations agent intents batch delete*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentIntentBatchDeleteCall), [*locations agent intents batch update*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentIntentBatchUpdateCall), [*locations agent intents create*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentIntentCreateCall), [*locations agent intents delete*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentIntentDeleteCall), [*locations agent intents get*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentIntentGetCall), [*locations agent intents list*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentIntentListCall), [*locations agent intents patch*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentIntentPatchCall), [*locations agent restore*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentRestoreCall), [*locations agent search*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentSearchCall), [*locations agent sessions contexts create*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentSessionContextCreateCall), [*locations agent sessions contexts delete*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentSessionContextDeleteCall), [*locations agent sessions contexts get*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentSessionContextGetCall), [*locations agent sessions contexts list*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentSessionContextListCall), [*locations agent sessions contexts patch*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentSessionContextPatchCall), [*locations agent sessions delete contexts*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentSessionDeleteContextCall), [*locations agent sessions detect intent*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentSessionDetectIntentCall), [*locations agent sessions entity types create*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentSessionEntityTypeCreateCall), [*locations agent sessions entity types delete*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentSessionEntityTypeDeleteCall), [*locations agent sessions entity types get*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentSessionEntityTypeGetCall), [*locations agent sessions entity types list*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentSessionEntityTypeListCall), [*locations agent sessions entity types patch*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentSessionEntityTypePatchCall), [*locations agent train*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentTrainCall), [*locations agent update fulfillment*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentUpdateFulfillmentCall), [*locations agent versions create*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentVersionCreateCall), [*locations agent versions delete*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentVersionDeleteCall), [*locations agent versions get*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentVersionGetCall), [*locations agent versions list*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentVersionListCall), [*locations agent versions patch*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAgentVersionPatchCall), [*locations answer records list*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAnswerRecordListCall), [*locations answer records patch*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationAnswerRecordPatchCall), [*locations conversation datasets create*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationConversationDatasetCreateCall), [*locations conversation datasets delete*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationConversationDatasetDeleteCall), [*locations conversation datasets get*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationConversationDatasetGetCall), [*locations conversation datasets import conversation data*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationConversationDatasetImportConversationDataCall), [*locations conversation datasets list*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationConversationDatasetListCall), [*locations conversation models create*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationConversationModelCreateCall), [*locations conversation models delete*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationConversationModelDeleteCall), [*locations conversation models deploy*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationConversationModelDeployCall), [*locations conversation models evaluations create*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationConversationModelEvaluationCreateCall), [*locations conversation models evaluations get*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationConversationModelEvaluationGetCall), [*locations conversation models evaluations list*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationConversationModelEvaluationListCall), [*locations conversation models get*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationConversationModelGetCall), [*locations conversation models list*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationConversationModelListCall), [*locations conversation models undeploy*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationConversationModelUndeployCall), [*locations conversation profiles clear suggestion feature config*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationConversationProfileClearSuggestionFeatureConfigCall), [*locations conversation profiles create*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationConversationProfileCreateCall), [*locations conversation profiles delete*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationConversationProfileDeleteCall), [*locations conversation profiles get*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationConversationProfileGetCall), [*locations conversation profiles list*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationConversationProfileListCall), [*locations conversation profiles patch*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationConversationProfilePatchCall), [*locations conversation profiles set suggestion feature config*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationConversationProfileSetSuggestionFeatureConfigCall), [*locations conversations complete*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationConversationCompleteCall), [*locations conversations create*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationConversationCreateCall), [*locations conversations get*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationConversationGetCall), [*locations conversations list*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationConversationListCall), [*locations conversations messages list*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationConversationMessageListCall), [*locations conversations participants analyze content*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationConversationParticipantAnalyzeContentCall), [*locations conversations participants create*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationConversationParticipantCreateCall), [*locations conversations participants get*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationConversationParticipantGetCall), [*locations conversations participants list*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationConversationParticipantListCall), [*locations conversations participants patch*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationConversationParticipantPatchCall), [*locations conversations participants suggestions suggest articles*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationConversationParticipantSuggestionSuggestArticleCall), [*locations conversations participants suggestions suggest faq answers*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationConversationParticipantSuggestionSuggestFaqAnswerCall), [*locations conversations participants suggestions suggest smart replies*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationConversationParticipantSuggestionSuggestSmartReplyCall), [*locations conversations suggestions suggest conversation summary*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationConversationSuggestionSuggestConversationSummaryCall), [*locations delete agent*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationDeleteAgentCall), [*locations get*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationGetCall), [*locations get agent*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationGetAgentCall), [*locations knowledge bases create*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationKnowledgeBaseCreateCall), [*locations knowledge bases delete*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationKnowledgeBaseDeleteCall), [*locations knowledge bases documents create*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationKnowledgeBaseDocumentCreateCall), [*locations knowledge bases documents delete*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationKnowledgeBaseDocumentDeleteCall), [*locations knowledge bases documents export*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationKnowledgeBaseDocumentExportCall), [*locations knowledge bases documents get*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationKnowledgeBaseDocumentGetCall), [*locations knowledge bases documents import*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationKnowledgeBaseDocumentImportCall), [*locations knowledge bases documents list*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationKnowledgeBaseDocumentListCall), [*locations knowledge bases documents patch*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationKnowledgeBaseDocumentPatchCall), [*locations knowledge bases documents reload*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationKnowledgeBaseDocumentReloadCall), [*locations knowledge bases get*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationKnowledgeBaseGetCall), [*locations knowledge bases list*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationKnowledgeBaseListCall), [*locations knowledge bases patch*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationKnowledgeBasePatchCall), [*locations list*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationListCall), [*locations operations cancel*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationOperationCancelCall), [*locations operations get*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationOperationGetCall), [*locations operations list*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationOperationListCall), [*locations set agent*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectLocationSetAgentCall), [*operations cancel*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectOperationCancelCall), [*operations get*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectOperationGetCall), [*operations list*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectOperationListCall) and [*set agent*](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/api::ProjectSetAgentCall) @@ -106,8 +106,8 @@ let r = hub.projects().locations_operations_get(...).doit().await let r = hub.projects().operations_get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -135,12 +135,12 @@ use dialogflow2::{Result, Error}; use std::default::Default; use dialogflow2::{Dialogflow, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -182,10 +182,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -195,25 +195,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-dialog You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/client::Delegate) to the -[Method Builder](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/client::Delegate) to the +[Method Builder](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/client::RequestValue) and -[decodable](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/client::RequestValue) and +[decodable](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-dialogflow2/5.0.3+20230110/google_dialogflow2/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -232,7 +232,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **dialogflow2** library was generated by Sebastian Thiel, and is placed +The **dialogflow2** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/dialogflow2/src/api.rs b/gen/dialogflow2/src/api.rs index d0702a0042..230ef79d4c 100644 --- a/gen/dialogflow2/src/api.rs +++ b/gen/dialogflow2/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use dialogflow2::{Dialogflow, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/dialogflow2/src/lib.rs b/gen/dialogflow2/src/lib.rs index 990ed427d0..e0d8fa430c 100644 --- a/gen/dialogflow2/src/lib.rs +++ b/gen/dialogflow2/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/dialogflow2). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Dialogflow) ... +//! Handle the following *Resources* with ease from the central [hub](Dialogflow) ... //! //! * projects //! * [*agent entity types batch delete*](api::ProjectAgentEntityTypeBatchDeleteCall), [*agent entity types batch update*](api::ProjectAgentEntityTypeBatchUpdateCall), [*agent entity types create*](api::ProjectAgentEntityTypeCreateCall), [*agent entity types delete*](api::ProjectAgentEntityTypeDeleteCall), [*agent entity types entities batch create*](api::ProjectAgentEntityTypeEntityBatchCreateCall), [*agent entity types entities batch delete*](api::ProjectAgentEntityTypeEntityBatchDeleteCall), [*agent entity types entities batch update*](api::ProjectAgentEntityTypeEntityBatchUpdateCall), [*agent entity types get*](api::ProjectAgentEntityTypeGetCall), [*agent entity types list*](api::ProjectAgentEntityTypeListCall), [*agent entity types patch*](api::ProjectAgentEntityTypePatchCall), [*agent environments create*](api::ProjectAgentEnvironmentCreateCall), [*agent environments delete*](api::ProjectAgentEnvironmentDeleteCall), [*agent environments get*](api::ProjectAgentEnvironmentGetCall), [*agent environments get history*](api::ProjectAgentEnvironmentGetHistoryCall), [*agent environments intents list*](api::ProjectAgentEnvironmentIntentListCall), [*agent environments list*](api::ProjectAgentEnvironmentListCall), [*agent environments patch*](api::ProjectAgentEnvironmentPatchCall), [*agent environments users sessions contexts create*](api::ProjectAgentEnvironmentUserSessionContextCreateCall), [*agent environments users sessions contexts delete*](api::ProjectAgentEnvironmentUserSessionContextDeleteCall), [*agent environments users sessions contexts get*](api::ProjectAgentEnvironmentUserSessionContextGetCall), [*agent environments users sessions contexts list*](api::ProjectAgentEnvironmentUserSessionContextListCall), [*agent environments users sessions contexts patch*](api::ProjectAgentEnvironmentUserSessionContextPatchCall), [*agent environments users sessions delete contexts*](api::ProjectAgentEnvironmentUserSessionDeleteContextCall), [*agent environments users sessions detect intent*](api::ProjectAgentEnvironmentUserSessionDetectIntentCall), [*agent environments users sessions entity types create*](api::ProjectAgentEnvironmentUserSessionEntityTypeCreateCall), [*agent environments users sessions entity types delete*](api::ProjectAgentEnvironmentUserSessionEntityTypeDeleteCall), [*agent environments users sessions entity types get*](api::ProjectAgentEnvironmentUserSessionEntityTypeGetCall), [*agent environments users sessions entity types list*](api::ProjectAgentEnvironmentUserSessionEntityTypeListCall), [*agent environments users sessions entity types patch*](api::ProjectAgentEnvironmentUserSessionEntityTypePatchCall), [*agent export*](api::ProjectAgentExportCall), [*agent get fulfillment*](api::ProjectAgentGetFulfillmentCall), [*agent get validation result*](api::ProjectAgentGetValidationResultCall), [*agent import*](api::ProjectAgentImportCall), [*agent intents batch delete*](api::ProjectAgentIntentBatchDeleteCall), [*agent intents batch update*](api::ProjectAgentIntentBatchUpdateCall), [*agent intents create*](api::ProjectAgentIntentCreateCall), [*agent intents delete*](api::ProjectAgentIntentDeleteCall), [*agent intents get*](api::ProjectAgentIntentGetCall), [*agent intents list*](api::ProjectAgentIntentListCall), [*agent intents patch*](api::ProjectAgentIntentPatchCall), [*agent knowledge bases create*](api::ProjectAgentKnowledgeBaseCreateCall), [*agent knowledge bases delete*](api::ProjectAgentKnowledgeBaseDeleteCall), [*agent knowledge bases documents create*](api::ProjectAgentKnowledgeBaseDocumentCreateCall), [*agent knowledge bases documents delete*](api::ProjectAgentKnowledgeBaseDocumentDeleteCall), [*agent knowledge bases documents get*](api::ProjectAgentKnowledgeBaseDocumentGetCall), [*agent knowledge bases documents list*](api::ProjectAgentKnowledgeBaseDocumentListCall), [*agent knowledge bases documents patch*](api::ProjectAgentKnowledgeBaseDocumentPatchCall), [*agent knowledge bases documents reload*](api::ProjectAgentKnowledgeBaseDocumentReloadCall), [*agent knowledge bases get*](api::ProjectAgentKnowledgeBaseGetCall), [*agent knowledge bases list*](api::ProjectAgentKnowledgeBaseListCall), [*agent knowledge bases patch*](api::ProjectAgentKnowledgeBasePatchCall), [*agent restore*](api::ProjectAgentRestoreCall), [*agent search*](api::ProjectAgentSearchCall), [*agent sessions contexts create*](api::ProjectAgentSessionContextCreateCall), [*agent sessions contexts delete*](api::ProjectAgentSessionContextDeleteCall), [*agent sessions contexts get*](api::ProjectAgentSessionContextGetCall), [*agent sessions contexts list*](api::ProjectAgentSessionContextListCall), [*agent sessions contexts patch*](api::ProjectAgentSessionContextPatchCall), [*agent sessions delete contexts*](api::ProjectAgentSessionDeleteContextCall), [*agent sessions detect intent*](api::ProjectAgentSessionDetectIntentCall), [*agent sessions entity types create*](api::ProjectAgentSessionEntityTypeCreateCall), [*agent sessions entity types delete*](api::ProjectAgentSessionEntityTypeDeleteCall), [*agent sessions entity types get*](api::ProjectAgentSessionEntityTypeGetCall), [*agent sessions entity types list*](api::ProjectAgentSessionEntityTypeListCall), [*agent sessions entity types patch*](api::ProjectAgentSessionEntityTypePatchCall), [*agent train*](api::ProjectAgentTrainCall), [*agent update fulfillment*](api::ProjectAgentUpdateFulfillmentCall), [*agent versions create*](api::ProjectAgentVersionCreateCall), [*agent versions delete*](api::ProjectAgentVersionDeleteCall), [*agent versions get*](api::ProjectAgentVersionGetCall), [*agent versions list*](api::ProjectAgentVersionListCall), [*agent versions patch*](api::ProjectAgentVersionPatchCall), [*answer records list*](api::ProjectAnswerRecordListCall), [*answer records patch*](api::ProjectAnswerRecordPatchCall), [*conversation datasets get*](api::ProjectConversationDatasetGetCall), [*conversation datasets import conversation data*](api::ProjectConversationDatasetImportConversationDataCall), [*conversation datasets list*](api::ProjectConversationDatasetListCall), [*conversation models create*](api::ProjectConversationModelCreateCall), [*conversation models delete*](api::ProjectConversationModelDeleteCall), [*conversation models deploy*](api::ProjectConversationModelDeployCall), [*conversation models evaluations get*](api::ProjectConversationModelEvaluationGetCall), [*conversation models evaluations list*](api::ProjectConversationModelEvaluationListCall), [*conversation models get*](api::ProjectConversationModelGetCall), [*conversation models list*](api::ProjectConversationModelListCall), [*conversation models undeploy*](api::ProjectConversationModelUndeployCall), [*conversation profiles clear suggestion feature config*](api::ProjectConversationProfileClearSuggestionFeatureConfigCall), [*conversation profiles create*](api::ProjectConversationProfileCreateCall), [*conversation profiles delete*](api::ProjectConversationProfileDeleteCall), [*conversation profiles get*](api::ProjectConversationProfileGetCall), [*conversation profiles list*](api::ProjectConversationProfileListCall), [*conversation profiles patch*](api::ProjectConversationProfilePatchCall), [*conversation profiles set suggestion feature config*](api::ProjectConversationProfileSetSuggestionFeatureConfigCall), [*conversations complete*](api::ProjectConversationCompleteCall), [*conversations create*](api::ProjectConversationCreateCall), [*conversations get*](api::ProjectConversationGetCall), [*conversations list*](api::ProjectConversationListCall), [*conversations messages list*](api::ProjectConversationMessageListCall), [*conversations participants analyze content*](api::ProjectConversationParticipantAnalyzeContentCall), [*conversations participants create*](api::ProjectConversationParticipantCreateCall), [*conversations participants get*](api::ProjectConversationParticipantGetCall), [*conversations participants list*](api::ProjectConversationParticipantListCall), [*conversations participants patch*](api::ProjectConversationParticipantPatchCall), [*conversations participants suggestions suggest articles*](api::ProjectConversationParticipantSuggestionSuggestArticleCall), [*conversations participants suggestions suggest faq answers*](api::ProjectConversationParticipantSuggestionSuggestFaqAnswerCall), [*conversations participants suggestions suggest smart replies*](api::ProjectConversationParticipantSuggestionSuggestSmartReplyCall), [*conversations suggestions suggest conversation summary*](api::ProjectConversationSuggestionSuggestConversationSummaryCall), [*delete agent*](api::ProjectDeleteAgentCall), [*get agent*](api::ProjectGetAgentCall), [*knowledge bases create*](api::ProjectKnowledgeBaseCreateCall), [*knowledge bases delete*](api::ProjectKnowledgeBaseDeleteCall), [*knowledge bases documents create*](api::ProjectKnowledgeBaseDocumentCreateCall), [*knowledge bases documents delete*](api::ProjectKnowledgeBaseDocumentDeleteCall), [*knowledge bases documents export*](api::ProjectKnowledgeBaseDocumentExportCall), [*knowledge bases documents get*](api::ProjectKnowledgeBaseDocumentGetCall), [*knowledge bases documents import*](api::ProjectKnowledgeBaseDocumentImportCall), [*knowledge bases documents list*](api::ProjectKnowledgeBaseDocumentListCall), [*knowledge bases documents patch*](api::ProjectKnowledgeBaseDocumentPatchCall), [*knowledge bases documents reload*](api::ProjectKnowledgeBaseDocumentReloadCall), [*knowledge bases get*](api::ProjectKnowledgeBaseGetCall), [*knowledge bases list*](api::ProjectKnowledgeBaseListCall), [*knowledge bases patch*](api::ProjectKnowledgeBasePatchCall), [*locations agent entity types batch delete*](api::ProjectLocationAgentEntityTypeBatchDeleteCall), [*locations agent entity types batch update*](api::ProjectLocationAgentEntityTypeBatchUpdateCall), [*locations agent entity types create*](api::ProjectLocationAgentEntityTypeCreateCall), [*locations agent entity types delete*](api::ProjectLocationAgentEntityTypeDeleteCall), [*locations agent entity types entities batch create*](api::ProjectLocationAgentEntityTypeEntityBatchCreateCall), [*locations agent entity types entities batch delete*](api::ProjectLocationAgentEntityTypeEntityBatchDeleteCall), [*locations agent entity types entities batch update*](api::ProjectLocationAgentEntityTypeEntityBatchUpdateCall), [*locations agent entity types get*](api::ProjectLocationAgentEntityTypeGetCall), [*locations agent entity types list*](api::ProjectLocationAgentEntityTypeListCall), [*locations agent entity types patch*](api::ProjectLocationAgentEntityTypePatchCall), [*locations agent environments create*](api::ProjectLocationAgentEnvironmentCreateCall), [*locations agent environments delete*](api::ProjectLocationAgentEnvironmentDeleteCall), [*locations agent environments get*](api::ProjectLocationAgentEnvironmentGetCall), [*locations agent environments get history*](api::ProjectLocationAgentEnvironmentGetHistoryCall), [*locations agent environments intents list*](api::ProjectLocationAgentEnvironmentIntentListCall), [*locations agent environments list*](api::ProjectLocationAgentEnvironmentListCall), [*locations agent environments patch*](api::ProjectLocationAgentEnvironmentPatchCall), [*locations agent environments users sessions contexts create*](api::ProjectLocationAgentEnvironmentUserSessionContextCreateCall), [*locations agent environments users sessions contexts delete*](api::ProjectLocationAgentEnvironmentUserSessionContextDeleteCall), [*locations agent environments users sessions contexts get*](api::ProjectLocationAgentEnvironmentUserSessionContextGetCall), [*locations agent environments users sessions contexts list*](api::ProjectLocationAgentEnvironmentUserSessionContextListCall), [*locations agent environments users sessions contexts patch*](api::ProjectLocationAgentEnvironmentUserSessionContextPatchCall), [*locations agent environments users sessions delete contexts*](api::ProjectLocationAgentEnvironmentUserSessionDeleteContextCall), [*locations agent environments users sessions detect intent*](api::ProjectLocationAgentEnvironmentUserSessionDetectIntentCall), [*locations agent environments users sessions entity types create*](api::ProjectLocationAgentEnvironmentUserSessionEntityTypeCreateCall), [*locations agent environments users sessions entity types delete*](api::ProjectLocationAgentEnvironmentUserSessionEntityTypeDeleteCall), [*locations agent environments users sessions entity types get*](api::ProjectLocationAgentEnvironmentUserSessionEntityTypeGetCall), [*locations agent environments users sessions entity types list*](api::ProjectLocationAgentEnvironmentUserSessionEntityTypeListCall), [*locations agent environments users sessions entity types patch*](api::ProjectLocationAgentEnvironmentUserSessionEntityTypePatchCall), [*locations agent export*](api::ProjectLocationAgentExportCall), [*locations agent get fulfillment*](api::ProjectLocationAgentGetFulfillmentCall), [*locations agent get validation result*](api::ProjectLocationAgentGetValidationResultCall), [*locations agent import*](api::ProjectLocationAgentImportCall), [*locations agent intents batch delete*](api::ProjectLocationAgentIntentBatchDeleteCall), [*locations agent intents batch update*](api::ProjectLocationAgentIntentBatchUpdateCall), [*locations agent intents create*](api::ProjectLocationAgentIntentCreateCall), [*locations agent intents delete*](api::ProjectLocationAgentIntentDeleteCall), [*locations agent intents get*](api::ProjectLocationAgentIntentGetCall), [*locations agent intents list*](api::ProjectLocationAgentIntentListCall), [*locations agent intents patch*](api::ProjectLocationAgentIntentPatchCall), [*locations agent restore*](api::ProjectLocationAgentRestoreCall), [*locations agent search*](api::ProjectLocationAgentSearchCall), [*locations agent sessions contexts create*](api::ProjectLocationAgentSessionContextCreateCall), [*locations agent sessions contexts delete*](api::ProjectLocationAgentSessionContextDeleteCall), [*locations agent sessions contexts get*](api::ProjectLocationAgentSessionContextGetCall), [*locations agent sessions contexts list*](api::ProjectLocationAgentSessionContextListCall), [*locations agent sessions contexts patch*](api::ProjectLocationAgentSessionContextPatchCall), [*locations agent sessions delete contexts*](api::ProjectLocationAgentSessionDeleteContextCall), [*locations agent sessions detect intent*](api::ProjectLocationAgentSessionDetectIntentCall), [*locations agent sessions entity types create*](api::ProjectLocationAgentSessionEntityTypeCreateCall), [*locations agent sessions entity types delete*](api::ProjectLocationAgentSessionEntityTypeDeleteCall), [*locations agent sessions entity types get*](api::ProjectLocationAgentSessionEntityTypeGetCall), [*locations agent sessions entity types list*](api::ProjectLocationAgentSessionEntityTypeListCall), [*locations agent sessions entity types patch*](api::ProjectLocationAgentSessionEntityTypePatchCall), [*locations agent train*](api::ProjectLocationAgentTrainCall), [*locations agent update fulfillment*](api::ProjectLocationAgentUpdateFulfillmentCall), [*locations agent versions create*](api::ProjectLocationAgentVersionCreateCall), [*locations agent versions delete*](api::ProjectLocationAgentVersionDeleteCall), [*locations agent versions get*](api::ProjectLocationAgentVersionGetCall), [*locations agent versions list*](api::ProjectLocationAgentVersionListCall), [*locations agent versions patch*](api::ProjectLocationAgentVersionPatchCall), [*locations answer records list*](api::ProjectLocationAnswerRecordListCall), [*locations answer records patch*](api::ProjectLocationAnswerRecordPatchCall), [*locations conversation datasets create*](api::ProjectLocationConversationDatasetCreateCall), [*locations conversation datasets delete*](api::ProjectLocationConversationDatasetDeleteCall), [*locations conversation datasets get*](api::ProjectLocationConversationDatasetGetCall), [*locations conversation datasets import conversation data*](api::ProjectLocationConversationDatasetImportConversationDataCall), [*locations conversation datasets list*](api::ProjectLocationConversationDatasetListCall), [*locations conversation models create*](api::ProjectLocationConversationModelCreateCall), [*locations conversation models delete*](api::ProjectLocationConversationModelDeleteCall), [*locations conversation models deploy*](api::ProjectLocationConversationModelDeployCall), [*locations conversation models evaluations create*](api::ProjectLocationConversationModelEvaluationCreateCall), [*locations conversation models evaluations get*](api::ProjectLocationConversationModelEvaluationGetCall), [*locations conversation models evaluations list*](api::ProjectLocationConversationModelEvaluationListCall), [*locations conversation models get*](api::ProjectLocationConversationModelGetCall), [*locations conversation models list*](api::ProjectLocationConversationModelListCall), [*locations conversation models undeploy*](api::ProjectLocationConversationModelUndeployCall), [*locations conversation profiles clear suggestion feature config*](api::ProjectLocationConversationProfileClearSuggestionFeatureConfigCall), [*locations conversation profiles create*](api::ProjectLocationConversationProfileCreateCall), [*locations conversation profiles delete*](api::ProjectLocationConversationProfileDeleteCall), [*locations conversation profiles get*](api::ProjectLocationConversationProfileGetCall), [*locations conversation profiles list*](api::ProjectLocationConversationProfileListCall), [*locations conversation profiles patch*](api::ProjectLocationConversationProfilePatchCall), [*locations conversation profiles set suggestion feature config*](api::ProjectLocationConversationProfileSetSuggestionFeatureConfigCall), [*locations conversations complete*](api::ProjectLocationConversationCompleteCall), [*locations conversations create*](api::ProjectLocationConversationCreateCall), [*locations conversations get*](api::ProjectLocationConversationGetCall), [*locations conversations list*](api::ProjectLocationConversationListCall), [*locations conversations messages list*](api::ProjectLocationConversationMessageListCall), [*locations conversations participants analyze content*](api::ProjectLocationConversationParticipantAnalyzeContentCall), [*locations conversations participants create*](api::ProjectLocationConversationParticipantCreateCall), [*locations conversations participants get*](api::ProjectLocationConversationParticipantGetCall), [*locations conversations participants list*](api::ProjectLocationConversationParticipantListCall), [*locations conversations participants patch*](api::ProjectLocationConversationParticipantPatchCall), [*locations conversations participants suggestions suggest articles*](api::ProjectLocationConversationParticipantSuggestionSuggestArticleCall), [*locations conversations participants suggestions suggest faq answers*](api::ProjectLocationConversationParticipantSuggestionSuggestFaqAnswerCall), [*locations conversations participants suggestions suggest smart replies*](api::ProjectLocationConversationParticipantSuggestionSuggestSmartReplyCall), [*locations conversations suggestions suggest conversation summary*](api::ProjectLocationConversationSuggestionSuggestConversationSummaryCall), [*locations delete agent*](api::ProjectLocationDeleteAgentCall), [*locations get*](api::ProjectLocationGetCall), [*locations get agent*](api::ProjectLocationGetAgentCall), [*locations knowledge bases create*](api::ProjectLocationKnowledgeBaseCreateCall), [*locations knowledge bases delete*](api::ProjectLocationKnowledgeBaseDeleteCall), [*locations knowledge bases documents create*](api::ProjectLocationKnowledgeBaseDocumentCreateCall), [*locations knowledge bases documents delete*](api::ProjectLocationKnowledgeBaseDocumentDeleteCall), [*locations knowledge bases documents export*](api::ProjectLocationKnowledgeBaseDocumentExportCall), [*locations knowledge bases documents get*](api::ProjectLocationKnowledgeBaseDocumentGetCall), [*locations knowledge bases documents import*](api::ProjectLocationKnowledgeBaseDocumentImportCall), [*locations knowledge bases documents list*](api::ProjectLocationKnowledgeBaseDocumentListCall), [*locations knowledge bases documents patch*](api::ProjectLocationKnowledgeBaseDocumentPatchCall), [*locations knowledge bases documents reload*](api::ProjectLocationKnowledgeBaseDocumentReloadCall), [*locations knowledge bases get*](api::ProjectLocationKnowledgeBaseGetCall), [*locations knowledge bases list*](api::ProjectLocationKnowledgeBaseListCall), [*locations knowledge bases patch*](api::ProjectLocationKnowledgeBasePatchCall), [*locations list*](api::ProjectLocationListCall), [*locations operations cancel*](api::ProjectLocationOperationCancelCall), [*locations operations get*](api::ProjectLocationOperationGetCall), [*locations operations list*](api::ProjectLocationOperationListCall), [*locations set agent*](api::ProjectLocationSetAgentCall), [*operations cancel*](api::ProjectOperationCancelCall), [*operations get*](api::ProjectOperationGetCall), [*operations list*](api::ProjectOperationListCall) and [*set agent*](api::ProjectSetAgentCall) @@ -106,8 +106,8 @@ //! let r = hub.projects().operations_get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -136,12 +136,12 @@ //! use std::default::Default; //! use dialogflow2::{Dialogflow, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -183,10 +183,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -196,25 +196,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/dialogflow2_beta1/README.md b/gen/dialogflow2_beta1/README.md index 64dc481f1c..dd800095fc 100644 --- a/gen/dialogflow2_beta1/README.md +++ b/gen/dialogflow2_beta1/README.md @@ -11,7 +11,7 @@ Everything else about the *Dialogflow* *v2_beta1* API can be found at the [official documentation site](https://cloud.google.com/dialogflow/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/Dialogflow) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/Dialogflow) ... * projects * [*agent entity types batch delete*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentEntityTypeBatchDeleteCall), [*agent entity types batch update*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentEntityTypeBatchUpdateCall), [*agent entity types create*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentEntityTypeCreateCall), [*agent entity types delete*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentEntityTypeDeleteCall), [*agent entity types entities batch create*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentEntityTypeEntityBatchCreateCall), [*agent entity types entities batch delete*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentEntityTypeEntityBatchDeleteCall), [*agent entity types entities batch update*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentEntityTypeEntityBatchUpdateCall), [*agent entity types get*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentEntityTypeGetCall), [*agent entity types list*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentEntityTypeListCall), [*agent entity types patch*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentEntityTypePatchCall), [*agent environments create*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentEnvironmentCreateCall), [*agent environments delete*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentEnvironmentDeleteCall), [*agent environments get*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentEnvironmentGetCall), [*agent environments get history*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentEnvironmentGetHistoryCall), [*agent environments intents list*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentEnvironmentIntentListCall), [*agent environments list*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentEnvironmentListCall), [*agent environments patch*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentEnvironmentPatchCall), [*agent environments users sessions contexts create*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentEnvironmentUserSessionContextCreateCall), [*agent environments users sessions contexts delete*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentEnvironmentUserSessionContextDeleteCall), [*agent environments users sessions contexts get*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentEnvironmentUserSessionContextGetCall), [*agent environments users sessions contexts list*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentEnvironmentUserSessionContextListCall), [*agent environments users sessions contexts patch*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentEnvironmentUserSessionContextPatchCall), [*agent environments users sessions delete contexts*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentEnvironmentUserSessionDeleteContextCall), [*agent environments users sessions detect intent*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentEnvironmentUserSessionDetectIntentCall), [*agent environments users sessions entity types create*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentEnvironmentUserSessionEntityTypeCreateCall), [*agent environments users sessions entity types delete*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentEnvironmentUserSessionEntityTypeDeleteCall), [*agent environments users sessions entity types get*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentEnvironmentUserSessionEntityTypeGetCall), [*agent environments users sessions entity types list*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentEnvironmentUserSessionEntityTypeListCall), [*agent environments users sessions entity types patch*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentEnvironmentUserSessionEntityTypePatchCall), [*agent export*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentExportCall), [*agent get fulfillment*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentGetFulfillmentCall), [*agent get validation result*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentGetValidationResultCall), [*agent import*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentImportCall), [*agent intents batch delete*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentIntentBatchDeleteCall), [*agent intents batch update*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentIntentBatchUpdateCall), [*agent intents create*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentIntentCreateCall), [*agent intents delete*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentIntentDeleteCall), [*agent intents get*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentIntentGetCall), [*agent intents list*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentIntentListCall), [*agent intents patch*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentIntentPatchCall), [*agent knowledge bases create*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentKnowledgeBaseCreateCall), [*agent knowledge bases delete*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentKnowledgeBaseDeleteCall), [*agent knowledge bases documents create*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentKnowledgeBaseDocumentCreateCall), [*agent knowledge bases documents delete*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentKnowledgeBaseDocumentDeleteCall), [*agent knowledge bases documents get*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentKnowledgeBaseDocumentGetCall), [*agent knowledge bases documents list*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentKnowledgeBaseDocumentListCall), [*agent knowledge bases documents patch*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentKnowledgeBaseDocumentPatchCall), [*agent knowledge bases documents reload*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentKnowledgeBaseDocumentReloadCall), [*agent knowledge bases get*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentKnowledgeBaseGetCall), [*agent knowledge bases list*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentKnowledgeBaseListCall), [*agent knowledge bases patch*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentKnowledgeBasePatchCall), [*agent restore*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentRestoreCall), [*agent search*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentSearchCall), [*agent sessions contexts create*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentSessionContextCreateCall), [*agent sessions contexts delete*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentSessionContextDeleteCall), [*agent sessions contexts get*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentSessionContextGetCall), [*agent sessions contexts list*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentSessionContextListCall), [*agent sessions contexts patch*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentSessionContextPatchCall), [*agent sessions delete contexts*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentSessionDeleteContextCall), [*agent sessions detect intent*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentSessionDetectIntentCall), [*agent sessions entity types create*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentSessionEntityTypeCreateCall), [*agent sessions entity types delete*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentSessionEntityTypeDeleteCall), [*agent sessions entity types get*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentSessionEntityTypeGetCall), [*agent sessions entity types list*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentSessionEntityTypeListCall), [*agent sessions entity types patch*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentSessionEntityTypePatchCall), [*agent train*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentTrainCall), [*agent update fulfillment*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentUpdateFulfillmentCall), [*agent versions create*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentVersionCreateCall), [*agent versions delete*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentVersionDeleteCall), [*agent versions get*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentVersionGetCall), [*agent versions list*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentVersionListCall), [*agent versions patch*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAgentVersionPatchCall), [*answer records get*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAnswerRecordGetCall), [*answer records list*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAnswerRecordListCall), [*answer records patch*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectAnswerRecordPatchCall), [*conversation profiles clear suggestion feature config*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectConversationProfileClearSuggestionFeatureConfigCall), [*conversation profiles create*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectConversationProfileCreateCall), [*conversation profiles delete*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectConversationProfileDeleteCall), [*conversation profiles get*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectConversationProfileGetCall), [*conversation profiles list*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectConversationProfileListCall), [*conversation profiles patch*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectConversationProfilePatchCall), [*conversation profiles set suggestion feature config*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectConversationProfileSetSuggestionFeatureConfigCall), [*conversations complete*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectConversationCompleteCall), [*conversations create*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectConversationCreateCall), [*conversations get*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectConversationGetCall), [*conversations list*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectConversationListCall), [*conversations messages batch create*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectConversationMessageBatchCreateCall), [*conversations messages list*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectConversationMessageListCall), [*conversations participants analyze content*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectConversationParticipantAnalyzeContentCall), [*conversations participants create*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectConversationParticipantCreateCall), [*conversations participants get*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectConversationParticipantGetCall), [*conversations participants list*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectConversationParticipantListCall), [*conversations participants patch*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectConversationParticipantPatchCall), [*conversations participants suggestions compile*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectConversationParticipantSuggestionCompileCall), [*conversations participants suggestions list*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectConversationParticipantSuggestionListCall), [*conversations participants suggestions suggest articles*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectConversationParticipantSuggestionSuggestArticleCall), [*conversations participants suggestions suggest faq answers*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectConversationParticipantSuggestionSuggestFaqAnswerCall), [*conversations participants suggestions suggest smart replies*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectConversationParticipantSuggestionSuggestSmartReplyCall), [*conversations suggestions suggest conversation summary*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectConversationSuggestionSuggestConversationSummaryCall), [*delete agent*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectDeleteAgentCall), [*get agent*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectGetAgentCall), [*knowledge bases create*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectKnowledgeBaseCreateCall), [*knowledge bases delete*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectKnowledgeBaseDeleteCall), [*knowledge bases documents create*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectKnowledgeBaseDocumentCreateCall), [*knowledge bases documents delete*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectKnowledgeBaseDocumentDeleteCall), [*knowledge bases documents get*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectKnowledgeBaseDocumentGetCall), [*knowledge bases documents import*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectKnowledgeBaseDocumentImportCall), [*knowledge bases documents list*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectKnowledgeBaseDocumentListCall), [*knowledge bases documents patch*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectKnowledgeBaseDocumentPatchCall), [*knowledge bases documents reload*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectKnowledgeBaseDocumentReloadCall), [*knowledge bases get*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectKnowledgeBaseGetCall), [*knowledge bases list*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectKnowledgeBaseListCall), [*knowledge bases patch*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectKnowledgeBasePatchCall), [*locations agent entity types batch delete*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentEntityTypeBatchDeleteCall), [*locations agent entity types batch update*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentEntityTypeBatchUpdateCall), [*locations agent entity types create*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentEntityTypeCreateCall), [*locations agent entity types delete*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentEntityTypeDeleteCall), [*locations agent entity types entities batch create*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentEntityTypeEntityBatchCreateCall), [*locations agent entity types entities batch delete*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentEntityTypeEntityBatchDeleteCall), [*locations agent entity types entities batch update*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentEntityTypeEntityBatchUpdateCall), [*locations agent entity types get*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentEntityTypeGetCall), [*locations agent entity types list*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentEntityTypeListCall), [*locations agent entity types patch*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentEntityTypePatchCall), [*locations agent environments create*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentEnvironmentCreateCall), [*locations agent environments delete*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentEnvironmentDeleteCall), [*locations agent environments get*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentEnvironmentGetCall), [*locations agent environments get history*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentEnvironmentGetHistoryCall), [*locations agent environments intents list*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentEnvironmentIntentListCall), [*locations agent environments list*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentEnvironmentListCall), [*locations agent environments patch*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentEnvironmentPatchCall), [*locations agent environments users sessions contexts create*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentEnvironmentUserSessionContextCreateCall), [*locations agent environments users sessions contexts delete*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentEnvironmentUserSessionContextDeleteCall), [*locations agent environments users sessions contexts get*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentEnvironmentUserSessionContextGetCall), [*locations agent environments users sessions contexts list*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentEnvironmentUserSessionContextListCall), [*locations agent environments users sessions contexts patch*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentEnvironmentUserSessionContextPatchCall), [*locations agent environments users sessions delete contexts*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentEnvironmentUserSessionDeleteContextCall), [*locations agent environments users sessions detect intent*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentEnvironmentUserSessionDetectIntentCall), [*locations agent environments users sessions entity types create*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentEnvironmentUserSessionEntityTypeCreateCall), [*locations agent environments users sessions entity types delete*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentEnvironmentUserSessionEntityTypeDeleteCall), [*locations agent environments users sessions entity types get*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentEnvironmentUserSessionEntityTypeGetCall), [*locations agent environments users sessions entity types list*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentEnvironmentUserSessionEntityTypeListCall), [*locations agent environments users sessions entity types patch*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentEnvironmentUserSessionEntityTypePatchCall), [*locations agent export*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentExportCall), [*locations agent get fulfillment*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentGetFulfillmentCall), [*locations agent get validation result*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentGetValidationResultCall), [*locations agent import*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentImportCall), [*locations agent intents batch delete*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentIntentBatchDeleteCall), [*locations agent intents batch update*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentIntentBatchUpdateCall), [*locations agent intents create*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentIntentCreateCall), [*locations agent intents delete*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentIntentDeleteCall), [*locations agent intents get*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentIntentGetCall), [*locations agent intents list*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentIntentListCall), [*locations agent intents patch*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentIntentPatchCall), [*locations agent restore*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentRestoreCall), [*locations agent search*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentSearchCall), [*locations agent sessions contexts create*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentSessionContextCreateCall), [*locations agent sessions contexts delete*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentSessionContextDeleteCall), [*locations agent sessions contexts get*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentSessionContextGetCall), [*locations agent sessions contexts list*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentSessionContextListCall), [*locations agent sessions contexts patch*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentSessionContextPatchCall), [*locations agent sessions delete contexts*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentSessionDeleteContextCall), [*locations agent sessions detect intent*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentSessionDetectIntentCall), [*locations agent sessions entity types create*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentSessionEntityTypeCreateCall), [*locations agent sessions entity types delete*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentSessionEntityTypeDeleteCall), [*locations agent sessions entity types get*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentSessionEntityTypeGetCall), [*locations agent sessions entity types list*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentSessionEntityTypeListCall), [*locations agent sessions entity types patch*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentSessionEntityTypePatchCall), [*locations agent train*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentTrainCall), [*locations agent update fulfillment*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentUpdateFulfillmentCall), [*locations agent versions create*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentVersionCreateCall), [*locations agent versions delete*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentVersionDeleteCall), [*locations agent versions get*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentVersionGetCall), [*locations agent versions list*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentVersionListCall), [*locations agent versions patch*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAgentVersionPatchCall), [*locations answer records get*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAnswerRecordGetCall), [*locations answer records list*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAnswerRecordListCall), [*locations answer records patch*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationAnswerRecordPatchCall), [*locations conversation profiles clear suggestion feature config*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationConversationProfileClearSuggestionFeatureConfigCall), [*locations conversation profiles create*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationConversationProfileCreateCall), [*locations conversation profiles delete*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationConversationProfileDeleteCall), [*locations conversation profiles get*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationConversationProfileGetCall), [*locations conversation profiles list*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationConversationProfileListCall), [*locations conversation profiles patch*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationConversationProfilePatchCall), [*locations conversation profiles set suggestion feature config*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationConversationProfileSetSuggestionFeatureConfigCall), [*locations conversations complete*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationConversationCompleteCall), [*locations conversations create*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationConversationCreateCall), [*locations conversations get*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationConversationGetCall), [*locations conversations list*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationConversationListCall), [*locations conversations messages batch create*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationConversationMessageBatchCreateCall), [*locations conversations messages list*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationConversationMessageListCall), [*locations conversations participants analyze content*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationConversationParticipantAnalyzeContentCall), [*locations conversations participants create*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationConversationParticipantCreateCall), [*locations conversations participants get*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationConversationParticipantGetCall), [*locations conversations participants list*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationConversationParticipantListCall), [*locations conversations participants patch*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationConversationParticipantPatchCall), [*locations conversations participants suggestions suggest articles*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationConversationParticipantSuggestionSuggestArticleCall), [*locations conversations participants suggestions suggest faq answers*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationConversationParticipantSuggestionSuggestFaqAnswerCall), [*locations conversations participants suggestions suggest smart replies*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationConversationParticipantSuggestionSuggestSmartReplyCall), [*locations conversations suggestions suggest conversation summary*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationConversationSuggestionSuggestConversationSummaryCall), [*locations delete agent*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationDeleteAgentCall), [*locations get*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationGetCall), [*locations get agent*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationGetAgentCall), [*locations knowledge bases create*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationKnowledgeBaseCreateCall), [*locations knowledge bases delete*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationKnowledgeBaseDeleteCall), [*locations knowledge bases documents create*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationKnowledgeBaseDocumentCreateCall), [*locations knowledge bases documents delete*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationKnowledgeBaseDocumentDeleteCall), [*locations knowledge bases documents get*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationKnowledgeBaseDocumentGetCall), [*locations knowledge bases documents import*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationKnowledgeBaseDocumentImportCall), [*locations knowledge bases documents list*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationKnowledgeBaseDocumentListCall), [*locations knowledge bases documents patch*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationKnowledgeBaseDocumentPatchCall), [*locations knowledge bases documents reload*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationKnowledgeBaseDocumentReloadCall), [*locations knowledge bases get*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationKnowledgeBaseGetCall), [*locations knowledge bases list*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationKnowledgeBaseListCall), [*locations knowledge bases patch*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationKnowledgeBasePatchCall), [*locations list*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationListCall), [*locations operations cancel*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationOperationCancelCall), [*locations operations get*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationOperationGetCall), [*locations operations list*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationOperationListCall), [*locations set agent*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectLocationSetAgentCall), [*operations cancel*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectOperationCancelCall), [*operations get*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectOperationGetCall), [*operations list*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectOperationListCall) and [*set agent*](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/api::ProjectSetAgentCall) @@ -91,8 +91,8 @@ let r = hub.projects().locations_operations_get(...).doit().await let r = hub.projects().operations_get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -120,12 +120,12 @@ use dialogflow2_beta1::{Result, Error}; use std::default::Default; use dialogflow2_beta1::{Dialogflow, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -167,10 +167,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -180,25 +180,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-dialog You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/client::Delegate) to the -[Method Builder](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/client::Delegate) to the +[Method Builder](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/client::RequestValue) and -[decodable](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/client::RequestValue) and +[decodable](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-dialogflow2_beta1/5.0.3+20230110/google_dialogflow2_beta1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -217,7 +217,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **dialogflow2_beta1** library was generated by Sebastian Thiel, and is placed +The **dialogflow2_beta1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/dialogflow2_beta1/src/api.rs b/gen/dialogflow2_beta1/src/api.rs index 4776b30366..740a9074bd 100644 --- a/gen/dialogflow2_beta1/src/api.rs +++ b/gen/dialogflow2_beta1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use dialogflow2_beta1::{Dialogflow, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/dialogflow2_beta1/src/lib.rs b/gen/dialogflow2_beta1/src/lib.rs index 4a53567c8b..2bfa4e2243 100644 --- a/gen/dialogflow2_beta1/src/lib.rs +++ b/gen/dialogflow2_beta1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/dialogflow2_beta1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Dialogflow) ... +//! Handle the following *Resources* with ease from the central [hub](Dialogflow) ... //! //! * projects //! * [*agent entity types batch delete*](api::ProjectAgentEntityTypeBatchDeleteCall), [*agent entity types batch update*](api::ProjectAgentEntityTypeBatchUpdateCall), [*agent entity types create*](api::ProjectAgentEntityTypeCreateCall), [*agent entity types delete*](api::ProjectAgentEntityTypeDeleteCall), [*agent entity types entities batch create*](api::ProjectAgentEntityTypeEntityBatchCreateCall), [*agent entity types entities batch delete*](api::ProjectAgentEntityTypeEntityBatchDeleteCall), [*agent entity types entities batch update*](api::ProjectAgentEntityTypeEntityBatchUpdateCall), [*agent entity types get*](api::ProjectAgentEntityTypeGetCall), [*agent entity types list*](api::ProjectAgentEntityTypeListCall), [*agent entity types patch*](api::ProjectAgentEntityTypePatchCall), [*agent environments create*](api::ProjectAgentEnvironmentCreateCall), [*agent environments delete*](api::ProjectAgentEnvironmentDeleteCall), [*agent environments get*](api::ProjectAgentEnvironmentGetCall), [*agent environments get history*](api::ProjectAgentEnvironmentGetHistoryCall), [*agent environments intents list*](api::ProjectAgentEnvironmentIntentListCall), [*agent environments list*](api::ProjectAgentEnvironmentListCall), [*agent environments patch*](api::ProjectAgentEnvironmentPatchCall), [*agent environments users sessions contexts create*](api::ProjectAgentEnvironmentUserSessionContextCreateCall), [*agent environments users sessions contexts delete*](api::ProjectAgentEnvironmentUserSessionContextDeleteCall), [*agent environments users sessions contexts get*](api::ProjectAgentEnvironmentUserSessionContextGetCall), [*agent environments users sessions contexts list*](api::ProjectAgentEnvironmentUserSessionContextListCall), [*agent environments users sessions contexts patch*](api::ProjectAgentEnvironmentUserSessionContextPatchCall), [*agent environments users sessions delete contexts*](api::ProjectAgentEnvironmentUserSessionDeleteContextCall), [*agent environments users sessions detect intent*](api::ProjectAgentEnvironmentUserSessionDetectIntentCall), [*agent environments users sessions entity types create*](api::ProjectAgentEnvironmentUserSessionEntityTypeCreateCall), [*agent environments users sessions entity types delete*](api::ProjectAgentEnvironmentUserSessionEntityTypeDeleteCall), [*agent environments users sessions entity types get*](api::ProjectAgentEnvironmentUserSessionEntityTypeGetCall), [*agent environments users sessions entity types list*](api::ProjectAgentEnvironmentUserSessionEntityTypeListCall), [*agent environments users sessions entity types patch*](api::ProjectAgentEnvironmentUserSessionEntityTypePatchCall), [*agent export*](api::ProjectAgentExportCall), [*agent get fulfillment*](api::ProjectAgentGetFulfillmentCall), [*agent get validation result*](api::ProjectAgentGetValidationResultCall), [*agent import*](api::ProjectAgentImportCall), [*agent intents batch delete*](api::ProjectAgentIntentBatchDeleteCall), [*agent intents batch update*](api::ProjectAgentIntentBatchUpdateCall), [*agent intents create*](api::ProjectAgentIntentCreateCall), [*agent intents delete*](api::ProjectAgentIntentDeleteCall), [*agent intents get*](api::ProjectAgentIntentGetCall), [*agent intents list*](api::ProjectAgentIntentListCall), [*agent intents patch*](api::ProjectAgentIntentPatchCall), [*agent knowledge bases create*](api::ProjectAgentKnowledgeBaseCreateCall), [*agent knowledge bases delete*](api::ProjectAgentKnowledgeBaseDeleteCall), [*agent knowledge bases documents create*](api::ProjectAgentKnowledgeBaseDocumentCreateCall), [*agent knowledge bases documents delete*](api::ProjectAgentKnowledgeBaseDocumentDeleteCall), [*agent knowledge bases documents get*](api::ProjectAgentKnowledgeBaseDocumentGetCall), [*agent knowledge bases documents list*](api::ProjectAgentKnowledgeBaseDocumentListCall), [*agent knowledge bases documents patch*](api::ProjectAgentKnowledgeBaseDocumentPatchCall), [*agent knowledge bases documents reload*](api::ProjectAgentKnowledgeBaseDocumentReloadCall), [*agent knowledge bases get*](api::ProjectAgentKnowledgeBaseGetCall), [*agent knowledge bases list*](api::ProjectAgentKnowledgeBaseListCall), [*agent knowledge bases patch*](api::ProjectAgentKnowledgeBasePatchCall), [*agent restore*](api::ProjectAgentRestoreCall), [*agent search*](api::ProjectAgentSearchCall), [*agent sessions contexts create*](api::ProjectAgentSessionContextCreateCall), [*agent sessions contexts delete*](api::ProjectAgentSessionContextDeleteCall), [*agent sessions contexts get*](api::ProjectAgentSessionContextGetCall), [*agent sessions contexts list*](api::ProjectAgentSessionContextListCall), [*agent sessions contexts patch*](api::ProjectAgentSessionContextPatchCall), [*agent sessions delete contexts*](api::ProjectAgentSessionDeleteContextCall), [*agent sessions detect intent*](api::ProjectAgentSessionDetectIntentCall), [*agent sessions entity types create*](api::ProjectAgentSessionEntityTypeCreateCall), [*agent sessions entity types delete*](api::ProjectAgentSessionEntityTypeDeleteCall), [*agent sessions entity types get*](api::ProjectAgentSessionEntityTypeGetCall), [*agent sessions entity types list*](api::ProjectAgentSessionEntityTypeListCall), [*agent sessions entity types patch*](api::ProjectAgentSessionEntityTypePatchCall), [*agent train*](api::ProjectAgentTrainCall), [*agent update fulfillment*](api::ProjectAgentUpdateFulfillmentCall), [*agent versions create*](api::ProjectAgentVersionCreateCall), [*agent versions delete*](api::ProjectAgentVersionDeleteCall), [*agent versions get*](api::ProjectAgentVersionGetCall), [*agent versions list*](api::ProjectAgentVersionListCall), [*agent versions patch*](api::ProjectAgentVersionPatchCall), [*answer records get*](api::ProjectAnswerRecordGetCall), [*answer records list*](api::ProjectAnswerRecordListCall), [*answer records patch*](api::ProjectAnswerRecordPatchCall), [*conversation profiles clear suggestion feature config*](api::ProjectConversationProfileClearSuggestionFeatureConfigCall), [*conversation profiles create*](api::ProjectConversationProfileCreateCall), [*conversation profiles delete*](api::ProjectConversationProfileDeleteCall), [*conversation profiles get*](api::ProjectConversationProfileGetCall), [*conversation profiles list*](api::ProjectConversationProfileListCall), [*conversation profiles patch*](api::ProjectConversationProfilePatchCall), [*conversation profiles set suggestion feature config*](api::ProjectConversationProfileSetSuggestionFeatureConfigCall), [*conversations complete*](api::ProjectConversationCompleteCall), [*conversations create*](api::ProjectConversationCreateCall), [*conversations get*](api::ProjectConversationGetCall), [*conversations list*](api::ProjectConversationListCall), [*conversations messages batch create*](api::ProjectConversationMessageBatchCreateCall), [*conversations messages list*](api::ProjectConversationMessageListCall), [*conversations participants analyze content*](api::ProjectConversationParticipantAnalyzeContentCall), [*conversations participants create*](api::ProjectConversationParticipantCreateCall), [*conversations participants get*](api::ProjectConversationParticipantGetCall), [*conversations participants list*](api::ProjectConversationParticipantListCall), [*conversations participants patch*](api::ProjectConversationParticipantPatchCall), [*conversations participants suggestions compile*](api::ProjectConversationParticipantSuggestionCompileCall), [*conversations participants suggestions list*](api::ProjectConversationParticipantSuggestionListCall), [*conversations participants suggestions suggest articles*](api::ProjectConversationParticipantSuggestionSuggestArticleCall), [*conversations participants suggestions suggest faq answers*](api::ProjectConversationParticipantSuggestionSuggestFaqAnswerCall), [*conversations participants suggestions suggest smart replies*](api::ProjectConversationParticipantSuggestionSuggestSmartReplyCall), [*conversations suggestions suggest conversation summary*](api::ProjectConversationSuggestionSuggestConversationSummaryCall), [*delete agent*](api::ProjectDeleteAgentCall), [*get agent*](api::ProjectGetAgentCall), [*knowledge bases create*](api::ProjectKnowledgeBaseCreateCall), [*knowledge bases delete*](api::ProjectKnowledgeBaseDeleteCall), [*knowledge bases documents create*](api::ProjectKnowledgeBaseDocumentCreateCall), [*knowledge bases documents delete*](api::ProjectKnowledgeBaseDocumentDeleteCall), [*knowledge bases documents get*](api::ProjectKnowledgeBaseDocumentGetCall), [*knowledge bases documents import*](api::ProjectKnowledgeBaseDocumentImportCall), [*knowledge bases documents list*](api::ProjectKnowledgeBaseDocumentListCall), [*knowledge bases documents patch*](api::ProjectKnowledgeBaseDocumentPatchCall), [*knowledge bases documents reload*](api::ProjectKnowledgeBaseDocumentReloadCall), [*knowledge bases get*](api::ProjectKnowledgeBaseGetCall), [*knowledge bases list*](api::ProjectKnowledgeBaseListCall), [*knowledge bases patch*](api::ProjectKnowledgeBasePatchCall), [*locations agent entity types batch delete*](api::ProjectLocationAgentEntityTypeBatchDeleteCall), [*locations agent entity types batch update*](api::ProjectLocationAgentEntityTypeBatchUpdateCall), [*locations agent entity types create*](api::ProjectLocationAgentEntityTypeCreateCall), [*locations agent entity types delete*](api::ProjectLocationAgentEntityTypeDeleteCall), [*locations agent entity types entities batch create*](api::ProjectLocationAgentEntityTypeEntityBatchCreateCall), [*locations agent entity types entities batch delete*](api::ProjectLocationAgentEntityTypeEntityBatchDeleteCall), [*locations agent entity types entities batch update*](api::ProjectLocationAgentEntityTypeEntityBatchUpdateCall), [*locations agent entity types get*](api::ProjectLocationAgentEntityTypeGetCall), [*locations agent entity types list*](api::ProjectLocationAgentEntityTypeListCall), [*locations agent entity types patch*](api::ProjectLocationAgentEntityTypePatchCall), [*locations agent environments create*](api::ProjectLocationAgentEnvironmentCreateCall), [*locations agent environments delete*](api::ProjectLocationAgentEnvironmentDeleteCall), [*locations agent environments get*](api::ProjectLocationAgentEnvironmentGetCall), [*locations agent environments get history*](api::ProjectLocationAgentEnvironmentGetHistoryCall), [*locations agent environments intents list*](api::ProjectLocationAgentEnvironmentIntentListCall), [*locations agent environments list*](api::ProjectLocationAgentEnvironmentListCall), [*locations agent environments patch*](api::ProjectLocationAgentEnvironmentPatchCall), [*locations agent environments users sessions contexts create*](api::ProjectLocationAgentEnvironmentUserSessionContextCreateCall), [*locations agent environments users sessions contexts delete*](api::ProjectLocationAgentEnvironmentUserSessionContextDeleteCall), [*locations agent environments users sessions contexts get*](api::ProjectLocationAgentEnvironmentUserSessionContextGetCall), [*locations agent environments users sessions contexts list*](api::ProjectLocationAgentEnvironmentUserSessionContextListCall), [*locations agent environments users sessions contexts patch*](api::ProjectLocationAgentEnvironmentUserSessionContextPatchCall), [*locations agent environments users sessions delete contexts*](api::ProjectLocationAgentEnvironmentUserSessionDeleteContextCall), [*locations agent environments users sessions detect intent*](api::ProjectLocationAgentEnvironmentUserSessionDetectIntentCall), [*locations agent environments users sessions entity types create*](api::ProjectLocationAgentEnvironmentUserSessionEntityTypeCreateCall), [*locations agent environments users sessions entity types delete*](api::ProjectLocationAgentEnvironmentUserSessionEntityTypeDeleteCall), [*locations agent environments users sessions entity types get*](api::ProjectLocationAgentEnvironmentUserSessionEntityTypeGetCall), [*locations agent environments users sessions entity types list*](api::ProjectLocationAgentEnvironmentUserSessionEntityTypeListCall), [*locations agent environments users sessions entity types patch*](api::ProjectLocationAgentEnvironmentUserSessionEntityTypePatchCall), [*locations agent export*](api::ProjectLocationAgentExportCall), [*locations agent get fulfillment*](api::ProjectLocationAgentGetFulfillmentCall), [*locations agent get validation result*](api::ProjectLocationAgentGetValidationResultCall), [*locations agent import*](api::ProjectLocationAgentImportCall), [*locations agent intents batch delete*](api::ProjectLocationAgentIntentBatchDeleteCall), [*locations agent intents batch update*](api::ProjectLocationAgentIntentBatchUpdateCall), [*locations agent intents create*](api::ProjectLocationAgentIntentCreateCall), [*locations agent intents delete*](api::ProjectLocationAgentIntentDeleteCall), [*locations agent intents get*](api::ProjectLocationAgentIntentGetCall), [*locations agent intents list*](api::ProjectLocationAgentIntentListCall), [*locations agent intents patch*](api::ProjectLocationAgentIntentPatchCall), [*locations agent restore*](api::ProjectLocationAgentRestoreCall), [*locations agent search*](api::ProjectLocationAgentSearchCall), [*locations agent sessions contexts create*](api::ProjectLocationAgentSessionContextCreateCall), [*locations agent sessions contexts delete*](api::ProjectLocationAgentSessionContextDeleteCall), [*locations agent sessions contexts get*](api::ProjectLocationAgentSessionContextGetCall), [*locations agent sessions contexts list*](api::ProjectLocationAgentSessionContextListCall), [*locations agent sessions contexts patch*](api::ProjectLocationAgentSessionContextPatchCall), [*locations agent sessions delete contexts*](api::ProjectLocationAgentSessionDeleteContextCall), [*locations agent sessions detect intent*](api::ProjectLocationAgentSessionDetectIntentCall), [*locations agent sessions entity types create*](api::ProjectLocationAgentSessionEntityTypeCreateCall), [*locations agent sessions entity types delete*](api::ProjectLocationAgentSessionEntityTypeDeleteCall), [*locations agent sessions entity types get*](api::ProjectLocationAgentSessionEntityTypeGetCall), [*locations agent sessions entity types list*](api::ProjectLocationAgentSessionEntityTypeListCall), [*locations agent sessions entity types patch*](api::ProjectLocationAgentSessionEntityTypePatchCall), [*locations agent train*](api::ProjectLocationAgentTrainCall), [*locations agent update fulfillment*](api::ProjectLocationAgentUpdateFulfillmentCall), [*locations agent versions create*](api::ProjectLocationAgentVersionCreateCall), [*locations agent versions delete*](api::ProjectLocationAgentVersionDeleteCall), [*locations agent versions get*](api::ProjectLocationAgentVersionGetCall), [*locations agent versions list*](api::ProjectLocationAgentVersionListCall), [*locations agent versions patch*](api::ProjectLocationAgentVersionPatchCall), [*locations answer records get*](api::ProjectLocationAnswerRecordGetCall), [*locations answer records list*](api::ProjectLocationAnswerRecordListCall), [*locations answer records patch*](api::ProjectLocationAnswerRecordPatchCall), [*locations conversation profiles clear suggestion feature config*](api::ProjectLocationConversationProfileClearSuggestionFeatureConfigCall), [*locations conversation profiles create*](api::ProjectLocationConversationProfileCreateCall), [*locations conversation profiles delete*](api::ProjectLocationConversationProfileDeleteCall), [*locations conversation profiles get*](api::ProjectLocationConversationProfileGetCall), [*locations conversation profiles list*](api::ProjectLocationConversationProfileListCall), [*locations conversation profiles patch*](api::ProjectLocationConversationProfilePatchCall), [*locations conversation profiles set suggestion feature config*](api::ProjectLocationConversationProfileSetSuggestionFeatureConfigCall), [*locations conversations complete*](api::ProjectLocationConversationCompleteCall), [*locations conversations create*](api::ProjectLocationConversationCreateCall), [*locations conversations get*](api::ProjectLocationConversationGetCall), [*locations conversations list*](api::ProjectLocationConversationListCall), [*locations conversations messages batch create*](api::ProjectLocationConversationMessageBatchCreateCall), [*locations conversations messages list*](api::ProjectLocationConversationMessageListCall), [*locations conversations participants analyze content*](api::ProjectLocationConversationParticipantAnalyzeContentCall), [*locations conversations participants create*](api::ProjectLocationConversationParticipantCreateCall), [*locations conversations participants get*](api::ProjectLocationConversationParticipantGetCall), [*locations conversations participants list*](api::ProjectLocationConversationParticipantListCall), [*locations conversations participants patch*](api::ProjectLocationConversationParticipantPatchCall), [*locations conversations participants suggestions suggest articles*](api::ProjectLocationConversationParticipantSuggestionSuggestArticleCall), [*locations conversations participants suggestions suggest faq answers*](api::ProjectLocationConversationParticipantSuggestionSuggestFaqAnswerCall), [*locations conversations participants suggestions suggest smart replies*](api::ProjectLocationConversationParticipantSuggestionSuggestSmartReplyCall), [*locations conversations suggestions suggest conversation summary*](api::ProjectLocationConversationSuggestionSuggestConversationSummaryCall), [*locations delete agent*](api::ProjectLocationDeleteAgentCall), [*locations get*](api::ProjectLocationGetCall), [*locations get agent*](api::ProjectLocationGetAgentCall), [*locations knowledge bases create*](api::ProjectLocationKnowledgeBaseCreateCall), [*locations knowledge bases delete*](api::ProjectLocationKnowledgeBaseDeleteCall), [*locations knowledge bases documents create*](api::ProjectLocationKnowledgeBaseDocumentCreateCall), [*locations knowledge bases documents delete*](api::ProjectLocationKnowledgeBaseDocumentDeleteCall), [*locations knowledge bases documents get*](api::ProjectLocationKnowledgeBaseDocumentGetCall), [*locations knowledge bases documents import*](api::ProjectLocationKnowledgeBaseDocumentImportCall), [*locations knowledge bases documents list*](api::ProjectLocationKnowledgeBaseDocumentListCall), [*locations knowledge bases documents patch*](api::ProjectLocationKnowledgeBaseDocumentPatchCall), [*locations knowledge bases documents reload*](api::ProjectLocationKnowledgeBaseDocumentReloadCall), [*locations knowledge bases get*](api::ProjectLocationKnowledgeBaseGetCall), [*locations knowledge bases list*](api::ProjectLocationKnowledgeBaseListCall), [*locations knowledge bases patch*](api::ProjectLocationKnowledgeBasePatchCall), [*locations list*](api::ProjectLocationListCall), [*locations operations cancel*](api::ProjectLocationOperationCancelCall), [*locations operations get*](api::ProjectLocationOperationGetCall), [*locations operations list*](api::ProjectLocationOperationListCall), [*locations set agent*](api::ProjectLocationSetAgentCall), [*operations cancel*](api::ProjectOperationCancelCall), [*operations get*](api::ProjectOperationGetCall), [*operations list*](api::ProjectOperationListCall) and [*set agent*](api::ProjectSetAgentCall) @@ -91,8 +91,8 @@ //! let r = hub.projects().operations_get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -121,12 +121,12 @@ //! use std::default::Default; //! use dialogflow2_beta1::{Dialogflow, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -168,10 +168,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -181,25 +181,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/dialogflow3/README.md b/gen/dialogflow3/README.md index ed8b626cf9..7f24232aa7 100644 --- a/gen/dialogflow3/README.md +++ b/gen/dialogflow3/README.md @@ -11,7 +11,7 @@ Everything else about the *Dialogflow* *v3* API can be found at the [official documentation site](https://cloud.google.com/dialogflow/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/Dialogflow) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/Dialogflow) ... * projects * [*locations agents changelogs get*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentChangelogGetCall), [*locations agents changelogs list*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentChangelogListCall), [*locations agents create*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentCreateCall), [*locations agents delete*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentDeleteCall), [*locations agents entity types create*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentEntityTypeCreateCall), [*locations agents entity types delete*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentEntityTypeDeleteCall), [*locations agents entity types get*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentEntityTypeGetCall), [*locations agents entity types list*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentEntityTypeListCall), [*locations agents entity types patch*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentEntityTypePatchCall), [*locations agents environments continuous test results list*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentEnvironmentContinuousTestResultListCall), [*locations agents environments create*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentEnvironmentCreateCall), [*locations agents environments delete*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentEnvironmentDeleteCall), [*locations agents environments deploy flow*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentEnvironmentDeployFlowCall), [*locations agents environments deployments get*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentEnvironmentDeploymentGetCall), [*locations agents environments deployments list*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentEnvironmentDeploymentListCall), [*locations agents environments experiments create*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentEnvironmentExperimentCreateCall), [*locations agents environments experiments delete*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentEnvironmentExperimentDeleteCall), [*locations agents environments experiments get*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentEnvironmentExperimentGetCall), [*locations agents environments experiments list*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentEnvironmentExperimentListCall), [*locations agents environments experiments patch*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentEnvironmentExperimentPatchCall), [*locations agents environments experiments start*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentEnvironmentExperimentStartCall), [*locations agents environments experiments stop*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentEnvironmentExperimentStopCall), [*locations agents environments get*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentEnvironmentGetCall), [*locations agents environments list*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentEnvironmentListCall), [*locations agents environments lookup environment history*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentEnvironmentLookupEnvironmentHistoryCall), [*locations agents environments patch*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentEnvironmentPatchCall), [*locations agents environments run continuous test*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentEnvironmentRunContinuousTestCall), [*locations agents environments sessions detect intent*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentEnvironmentSessionDetectIntentCall), [*locations agents environments sessions entity types create*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentEnvironmentSessionEntityTypeCreateCall), [*locations agents environments sessions entity types delete*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentEnvironmentSessionEntityTypeDeleteCall), [*locations agents environments sessions entity types get*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentEnvironmentSessionEntityTypeGetCall), [*locations agents environments sessions entity types list*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentEnvironmentSessionEntityTypeListCall), [*locations agents environments sessions entity types patch*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentEnvironmentSessionEntityTypePatchCall), [*locations agents environments sessions fulfill intent*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentEnvironmentSessionFulfillIntentCall), [*locations agents environments sessions match intent*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentEnvironmentSessionMatchIntentCall), [*locations agents export*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentExportCall), [*locations agents flows create*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentFlowCreateCall), [*locations agents flows delete*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentFlowDeleteCall), [*locations agents flows export*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentFlowExportCall), [*locations agents flows get*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentFlowGetCall), [*locations agents flows get validation result*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentFlowGetValidationResultCall), [*locations agents flows import*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentFlowImportCall), [*locations agents flows list*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentFlowListCall), [*locations agents flows pages create*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentFlowPageCreateCall), [*locations agents flows pages delete*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentFlowPageDeleteCall), [*locations agents flows pages get*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentFlowPageGetCall), [*locations agents flows pages list*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentFlowPageListCall), [*locations agents flows pages patch*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentFlowPagePatchCall), [*locations agents flows patch*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentFlowPatchCall), [*locations agents flows train*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentFlowTrainCall), [*locations agents flows transition route groups create*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentFlowTransitionRouteGroupCreateCall), [*locations agents flows transition route groups delete*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentFlowTransitionRouteGroupDeleteCall), [*locations agents flows transition route groups get*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentFlowTransitionRouteGroupGetCall), [*locations agents flows transition route groups list*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentFlowTransitionRouteGroupListCall), [*locations agents flows transition route groups patch*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentFlowTransitionRouteGroupPatchCall), [*locations agents flows validate*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentFlowValidateCall), [*locations agents flows versions compare versions*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentFlowVersionCompareVersionCall), [*locations agents flows versions create*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentFlowVersionCreateCall), [*locations agents flows versions delete*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentFlowVersionDeleteCall), [*locations agents flows versions get*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentFlowVersionGetCall), [*locations agents flows versions list*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentFlowVersionListCall), [*locations agents flows versions load*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentFlowVersionLoadCall), [*locations agents flows versions patch*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentFlowVersionPatchCall), [*locations agents get*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentGetCall), [*locations agents get validation result*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentGetValidationResultCall), [*locations agents intents create*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentIntentCreateCall), [*locations agents intents delete*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentIntentDeleteCall), [*locations agents intents get*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentIntentGetCall), [*locations agents intents list*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentIntentListCall), [*locations agents intents patch*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentIntentPatchCall), [*locations agents list*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentListCall), [*locations agents patch*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentPatchCall), [*locations agents restore*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentRestoreCall), [*locations agents sessions detect intent*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentSessionDetectIntentCall), [*locations agents sessions entity types create*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentSessionEntityTypeCreateCall), [*locations agents sessions entity types delete*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentSessionEntityTypeDeleteCall), [*locations agents sessions entity types get*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentSessionEntityTypeGetCall), [*locations agents sessions entity types list*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentSessionEntityTypeListCall), [*locations agents sessions entity types patch*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentSessionEntityTypePatchCall), [*locations agents sessions fulfill intent*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentSessionFulfillIntentCall), [*locations agents sessions match intent*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentSessionMatchIntentCall), [*locations agents test cases batch delete*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentTestCaseBatchDeleteCall), [*locations agents test cases batch run*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentTestCaseBatchRunCall), [*locations agents test cases calculate coverage*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentTestCaseCalculateCoverageCall), [*locations agents test cases create*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentTestCaseCreateCall), [*locations agents test cases export*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentTestCaseExportCall), [*locations agents test cases get*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentTestCaseGetCall), [*locations agents test cases import*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentTestCaseImportCall), [*locations agents test cases list*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentTestCaseListCall), [*locations agents test cases patch*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentTestCasePatchCall), [*locations agents test cases results get*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentTestCaseResultGetCall), [*locations agents test cases results list*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentTestCaseResultListCall), [*locations agents test cases run*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentTestCaseRunCall), [*locations agents validate*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentValidateCall), [*locations agents webhooks create*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentWebhookCreateCall), [*locations agents webhooks delete*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentWebhookDeleteCall), [*locations agents webhooks get*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentWebhookGetCall), [*locations agents webhooks list*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentWebhookListCall), [*locations agents webhooks patch*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationAgentWebhookPatchCall), [*locations get*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationGetCall), [*locations list*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationListCall), [*locations operations cancel*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationOperationCancelCall), [*locations operations get*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationOperationGetCall), [*locations operations list*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationOperationListCall), [*locations security settings create*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationSecuritySettingCreateCall), [*locations security settings delete*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationSecuritySettingDeleteCall), [*locations security settings get*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationSecuritySettingGetCall), [*locations security settings list*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationSecuritySettingListCall), [*locations security settings patch*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectLocationSecuritySettingPatchCall), [*operations cancel*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectOperationCancelCall), [*operations get*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectOperationGetCall) and [*operations list*](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/api::ProjectOperationListCall) @@ -66,8 +66,8 @@ let r = hub.projects().locations_operations_get(...).doit().await let r = hub.projects().operations_get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -95,12 +95,12 @@ use dialogflow3::{Result, Error}; use std::default::Default; use dialogflow3::{Dialogflow, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -142,10 +142,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -155,25 +155,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-dialog You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/client::Delegate) to the -[Method Builder](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/client::Delegate) to the +[Method Builder](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/client::RequestValue) and -[decodable](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/client::RequestValue) and +[decodable](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-dialogflow3/5.0.3+20230110/google_dialogflow3/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -192,7 +192,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **dialogflow3** library was generated by Sebastian Thiel, and is placed +The **dialogflow3** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/dialogflow3/src/api.rs b/gen/dialogflow3/src/api.rs index e194575773..a9ca99a65b 100644 --- a/gen/dialogflow3/src/api.rs +++ b/gen/dialogflow3/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use dialogflow3::{Dialogflow, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/dialogflow3/src/lib.rs b/gen/dialogflow3/src/lib.rs index 253bb0e35f..42c6fd0229 100644 --- a/gen/dialogflow3/src/lib.rs +++ b/gen/dialogflow3/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/dialogflow3). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Dialogflow) ... +//! Handle the following *Resources* with ease from the central [hub](Dialogflow) ... //! //! * projects //! * [*locations agents changelogs get*](api::ProjectLocationAgentChangelogGetCall), [*locations agents changelogs list*](api::ProjectLocationAgentChangelogListCall), [*locations agents create*](api::ProjectLocationAgentCreateCall), [*locations agents delete*](api::ProjectLocationAgentDeleteCall), [*locations agents entity types create*](api::ProjectLocationAgentEntityTypeCreateCall), [*locations agents entity types delete*](api::ProjectLocationAgentEntityTypeDeleteCall), [*locations agents entity types get*](api::ProjectLocationAgentEntityTypeGetCall), [*locations agents entity types list*](api::ProjectLocationAgentEntityTypeListCall), [*locations agents entity types patch*](api::ProjectLocationAgentEntityTypePatchCall), [*locations agents environments continuous test results list*](api::ProjectLocationAgentEnvironmentContinuousTestResultListCall), [*locations agents environments create*](api::ProjectLocationAgentEnvironmentCreateCall), [*locations agents environments delete*](api::ProjectLocationAgentEnvironmentDeleteCall), [*locations agents environments deploy flow*](api::ProjectLocationAgentEnvironmentDeployFlowCall), [*locations agents environments deployments get*](api::ProjectLocationAgentEnvironmentDeploymentGetCall), [*locations agents environments deployments list*](api::ProjectLocationAgentEnvironmentDeploymentListCall), [*locations agents environments experiments create*](api::ProjectLocationAgentEnvironmentExperimentCreateCall), [*locations agents environments experiments delete*](api::ProjectLocationAgentEnvironmentExperimentDeleteCall), [*locations agents environments experiments get*](api::ProjectLocationAgentEnvironmentExperimentGetCall), [*locations agents environments experiments list*](api::ProjectLocationAgentEnvironmentExperimentListCall), [*locations agents environments experiments patch*](api::ProjectLocationAgentEnvironmentExperimentPatchCall), [*locations agents environments experiments start*](api::ProjectLocationAgentEnvironmentExperimentStartCall), [*locations agents environments experiments stop*](api::ProjectLocationAgentEnvironmentExperimentStopCall), [*locations agents environments get*](api::ProjectLocationAgentEnvironmentGetCall), [*locations agents environments list*](api::ProjectLocationAgentEnvironmentListCall), [*locations agents environments lookup environment history*](api::ProjectLocationAgentEnvironmentLookupEnvironmentHistoryCall), [*locations agents environments patch*](api::ProjectLocationAgentEnvironmentPatchCall), [*locations agents environments run continuous test*](api::ProjectLocationAgentEnvironmentRunContinuousTestCall), [*locations agents environments sessions detect intent*](api::ProjectLocationAgentEnvironmentSessionDetectIntentCall), [*locations agents environments sessions entity types create*](api::ProjectLocationAgentEnvironmentSessionEntityTypeCreateCall), [*locations agents environments sessions entity types delete*](api::ProjectLocationAgentEnvironmentSessionEntityTypeDeleteCall), [*locations agents environments sessions entity types get*](api::ProjectLocationAgentEnvironmentSessionEntityTypeGetCall), [*locations agents environments sessions entity types list*](api::ProjectLocationAgentEnvironmentSessionEntityTypeListCall), [*locations agents environments sessions entity types patch*](api::ProjectLocationAgentEnvironmentSessionEntityTypePatchCall), [*locations agents environments sessions fulfill intent*](api::ProjectLocationAgentEnvironmentSessionFulfillIntentCall), [*locations agents environments sessions match intent*](api::ProjectLocationAgentEnvironmentSessionMatchIntentCall), [*locations agents export*](api::ProjectLocationAgentExportCall), [*locations agents flows create*](api::ProjectLocationAgentFlowCreateCall), [*locations agents flows delete*](api::ProjectLocationAgentFlowDeleteCall), [*locations agents flows export*](api::ProjectLocationAgentFlowExportCall), [*locations agents flows get*](api::ProjectLocationAgentFlowGetCall), [*locations agents flows get validation result*](api::ProjectLocationAgentFlowGetValidationResultCall), [*locations agents flows import*](api::ProjectLocationAgentFlowImportCall), [*locations agents flows list*](api::ProjectLocationAgentFlowListCall), [*locations agents flows pages create*](api::ProjectLocationAgentFlowPageCreateCall), [*locations agents flows pages delete*](api::ProjectLocationAgentFlowPageDeleteCall), [*locations agents flows pages get*](api::ProjectLocationAgentFlowPageGetCall), [*locations agents flows pages list*](api::ProjectLocationAgentFlowPageListCall), [*locations agents flows pages patch*](api::ProjectLocationAgentFlowPagePatchCall), [*locations agents flows patch*](api::ProjectLocationAgentFlowPatchCall), [*locations agents flows train*](api::ProjectLocationAgentFlowTrainCall), [*locations agents flows transition route groups create*](api::ProjectLocationAgentFlowTransitionRouteGroupCreateCall), [*locations agents flows transition route groups delete*](api::ProjectLocationAgentFlowTransitionRouteGroupDeleteCall), [*locations agents flows transition route groups get*](api::ProjectLocationAgentFlowTransitionRouteGroupGetCall), [*locations agents flows transition route groups list*](api::ProjectLocationAgentFlowTransitionRouteGroupListCall), [*locations agents flows transition route groups patch*](api::ProjectLocationAgentFlowTransitionRouteGroupPatchCall), [*locations agents flows validate*](api::ProjectLocationAgentFlowValidateCall), [*locations agents flows versions compare versions*](api::ProjectLocationAgentFlowVersionCompareVersionCall), [*locations agents flows versions create*](api::ProjectLocationAgentFlowVersionCreateCall), [*locations agents flows versions delete*](api::ProjectLocationAgentFlowVersionDeleteCall), [*locations agents flows versions get*](api::ProjectLocationAgentFlowVersionGetCall), [*locations agents flows versions list*](api::ProjectLocationAgentFlowVersionListCall), [*locations agents flows versions load*](api::ProjectLocationAgentFlowVersionLoadCall), [*locations agents flows versions patch*](api::ProjectLocationAgentFlowVersionPatchCall), [*locations agents get*](api::ProjectLocationAgentGetCall), [*locations agents get validation result*](api::ProjectLocationAgentGetValidationResultCall), [*locations agents intents create*](api::ProjectLocationAgentIntentCreateCall), [*locations agents intents delete*](api::ProjectLocationAgentIntentDeleteCall), [*locations agents intents get*](api::ProjectLocationAgentIntentGetCall), [*locations agents intents list*](api::ProjectLocationAgentIntentListCall), [*locations agents intents patch*](api::ProjectLocationAgentIntentPatchCall), [*locations agents list*](api::ProjectLocationAgentListCall), [*locations agents patch*](api::ProjectLocationAgentPatchCall), [*locations agents restore*](api::ProjectLocationAgentRestoreCall), [*locations agents sessions detect intent*](api::ProjectLocationAgentSessionDetectIntentCall), [*locations agents sessions entity types create*](api::ProjectLocationAgentSessionEntityTypeCreateCall), [*locations agents sessions entity types delete*](api::ProjectLocationAgentSessionEntityTypeDeleteCall), [*locations agents sessions entity types get*](api::ProjectLocationAgentSessionEntityTypeGetCall), [*locations agents sessions entity types list*](api::ProjectLocationAgentSessionEntityTypeListCall), [*locations agents sessions entity types patch*](api::ProjectLocationAgentSessionEntityTypePatchCall), [*locations agents sessions fulfill intent*](api::ProjectLocationAgentSessionFulfillIntentCall), [*locations agents sessions match intent*](api::ProjectLocationAgentSessionMatchIntentCall), [*locations agents test cases batch delete*](api::ProjectLocationAgentTestCaseBatchDeleteCall), [*locations agents test cases batch run*](api::ProjectLocationAgentTestCaseBatchRunCall), [*locations agents test cases calculate coverage*](api::ProjectLocationAgentTestCaseCalculateCoverageCall), [*locations agents test cases create*](api::ProjectLocationAgentTestCaseCreateCall), [*locations agents test cases export*](api::ProjectLocationAgentTestCaseExportCall), [*locations agents test cases get*](api::ProjectLocationAgentTestCaseGetCall), [*locations agents test cases import*](api::ProjectLocationAgentTestCaseImportCall), [*locations agents test cases list*](api::ProjectLocationAgentTestCaseListCall), [*locations agents test cases patch*](api::ProjectLocationAgentTestCasePatchCall), [*locations agents test cases results get*](api::ProjectLocationAgentTestCaseResultGetCall), [*locations agents test cases results list*](api::ProjectLocationAgentTestCaseResultListCall), [*locations agents test cases run*](api::ProjectLocationAgentTestCaseRunCall), [*locations agents validate*](api::ProjectLocationAgentValidateCall), [*locations agents webhooks create*](api::ProjectLocationAgentWebhookCreateCall), [*locations agents webhooks delete*](api::ProjectLocationAgentWebhookDeleteCall), [*locations agents webhooks get*](api::ProjectLocationAgentWebhookGetCall), [*locations agents webhooks list*](api::ProjectLocationAgentWebhookListCall), [*locations agents webhooks patch*](api::ProjectLocationAgentWebhookPatchCall), [*locations get*](api::ProjectLocationGetCall), [*locations list*](api::ProjectLocationListCall), [*locations operations cancel*](api::ProjectLocationOperationCancelCall), [*locations operations get*](api::ProjectLocationOperationGetCall), [*locations operations list*](api::ProjectLocationOperationListCall), [*locations security settings create*](api::ProjectLocationSecuritySettingCreateCall), [*locations security settings delete*](api::ProjectLocationSecuritySettingDeleteCall), [*locations security settings get*](api::ProjectLocationSecuritySettingGetCall), [*locations security settings list*](api::ProjectLocationSecuritySettingListCall), [*locations security settings patch*](api::ProjectLocationSecuritySettingPatchCall), [*operations cancel*](api::ProjectOperationCancelCall), [*operations get*](api::ProjectOperationGetCall) and [*operations list*](api::ProjectOperationListCall) @@ -66,8 +66,8 @@ //! let r = hub.projects().operations_get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -96,12 +96,12 @@ //! use std::default::Default; //! use dialogflow3::{Dialogflow, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -143,10 +143,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -156,25 +156,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/digitalassetlinks1/README.md b/gen/digitalassetlinks1/README.md index ada5766336..fab0572d96 100644 --- a/gen/digitalassetlinks1/README.md +++ b/gen/digitalassetlinks1/README.md @@ -11,7 +11,7 @@ Everything else about the *digitalassetlinks* *v1* API can be found at the [official documentation site](https://developers.google.com/digital-asset-links/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-digitalassetlinks1/5.0.3+20230117/google_digitalassetlinks1/Digitalassetlinks) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-digitalassetlinks1/5.0.3+20230117/google_digitalassetlinks1/Digitalassetlinks) ... * assetlinks * [*bulk check*](https://docs.rs/google-digitalassetlinks1/5.0.3+20230117/google_digitalassetlinks1/api::AssetlinkBulkCheckCall) and [*check*](https://docs.rs/google-digitalassetlinks1/5.0.3+20230117/google_digitalassetlinks1/api::AssetlinkCheckCall) @@ -52,8 +52,8 @@ Or specifically ... let r = hub.assetlinks().bulk_check(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -81,12 +81,12 @@ use digitalassetlinks1::{Result, Error}; use std::default::Default; use digitalassetlinks1::{Digitalassetlinks, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -127,10 +127,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-digitalassetlinks1/5.0.3+20230117/google_digitalassetlinks1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-digitalassetlinks1/5.0.3+20230117/google_digitalassetlinks1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -140,25 +140,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-digita You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-digitalassetlinks1/5.0.3+20230117/google_digitalassetlinks1/client::Delegate) to the -[Method Builder](https://docs.rs/google-digitalassetlinks1/5.0.3+20230117/google_digitalassetlinks1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-digitalassetlinks1/5.0.3+20230117/google_digitalassetlinks1/client::Delegate) to the +[Method Builder](https://docs.rs/google-digitalassetlinks1/5.0.3+20230117/google_digitalassetlinks1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-digitalassetlinks1/5.0.3+20230117/google_digitalassetlinks1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-digitalassetlinks1/5.0.3+20230117/google_digitalassetlinks1/client::RequestValue) and -[decodable](https://docs.rs/google-digitalassetlinks1/5.0.3+20230117/google_digitalassetlinks1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-digitalassetlinks1/5.0.3+20230117/google_digitalassetlinks1/client::RequestValue) and +[decodable](https://docs.rs/google-digitalassetlinks1/5.0.3+20230117/google_digitalassetlinks1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-digitalassetlinks1/5.0.3+20230117/google_digitalassetlinks1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-digitalassetlinks1/5.0.3+20230117/google_digitalassetlinks1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -177,7 +177,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **digitalassetlinks1** library was generated by Sebastian Thiel, and is placed +The **digitalassetlinks1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/digitalassetlinks1/src/api.rs b/gen/digitalassetlinks1/src/api.rs index c5d5c674d5..e7cc6a2849 100644 --- a/gen/digitalassetlinks1/src/api.rs +++ b/gen/digitalassetlinks1/src/api.rs @@ -43,12 +43,12 @@ use crate::{client, client::GetToken, client::serde_with}; /// use std::default::Default; /// use digitalassetlinks1::{Digitalassetlinks, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/digitalassetlinks1/src/lib.rs b/gen/digitalassetlinks1/src/lib.rs index 945c25af4a..8c10976b49 100644 --- a/gen/digitalassetlinks1/src/lib.rs +++ b/gen/digitalassetlinks1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/digitalassetlinks1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Digitalassetlinks) ... +//! Handle the following *Resources* with ease from the central [hub](Digitalassetlinks) ... //! //! * assetlinks //! * [*bulk check*](api::AssetlinkBulkCheckCall) and [*check*](api::AssetlinkCheckCall) @@ -52,8 +52,8 @@ //! let r = hub.assetlinks().bulk_check(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -82,12 +82,12 @@ //! use std::default::Default; //! use digitalassetlinks1::{Digitalassetlinks, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -128,10 +128,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -141,25 +141,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/discovery1/README.md b/gen/discovery1/README.md index a611e1f950..55d9821cd3 100644 --- a/gen/discovery1/README.md +++ b/gen/discovery1/README.md @@ -11,7 +11,7 @@ Everything else about the *discovery* *v1* API can be found at the [official documentation site](https://developers.google.com/discovery/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-discovery1/5.0.3+20200806/google_discovery1/Discovery) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-discovery1/5.0.3+20200806/google_discovery1/Discovery) ... * apis * [*get rest*](https://docs.rs/google-discovery1/5.0.3+20200806/google_discovery1/api::ApiGetRestCall) and [*list*](https://docs.rs/google-discovery1/5.0.3+20200806/google_discovery1/api::ApiListCall) @@ -50,8 +50,8 @@ Or specifically ... let r = hub.apis().get_rest(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -78,12 +78,12 @@ use discovery1::{Result, Error}; use std::default::Default; use discovery1::{Discovery, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -119,10 +119,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-discovery1/5.0.3+20200806/google_discovery1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-discovery1/5.0.3+20200806/google_discovery1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -132,25 +132,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-discov You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-discovery1/5.0.3+20200806/google_discovery1/client::Delegate) to the -[Method Builder](https://docs.rs/google-discovery1/5.0.3+20200806/google_discovery1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-discovery1/5.0.3+20200806/google_discovery1/client::Delegate) to the +[Method Builder](https://docs.rs/google-discovery1/5.0.3+20200806/google_discovery1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-discovery1/5.0.3+20200806/google_discovery1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-discovery1/5.0.3+20200806/google_discovery1/client::RequestValue) and -[decodable](https://docs.rs/google-discovery1/5.0.3+20200806/google_discovery1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-discovery1/5.0.3+20200806/google_discovery1/client::RequestValue) and +[decodable](https://docs.rs/google-discovery1/5.0.3+20200806/google_discovery1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-discovery1/5.0.3+20200806/google_discovery1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-discovery1/5.0.3+20200806/google_discovery1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -169,7 +169,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **discovery1** library was generated by Sebastian Thiel, and is placed +The **discovery1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/discovery1/src/api.rs b/gen/discovery1/src/api.rs index 5b9993882d..7fad6d9b73 100644 --- a/gen/discovery1/src/api.rs +++ b/gen/discovery1/src/api.rs @@ -42,12 +42,12 @@ use crate::{client, client::GetToken, client::serde_with}; /// use std::default::Default; /// use discovery1::{Discovery, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/discovery1/src/lib.rs b/gen/discovery1/src/lib.rs index 5711f0c6d5..195736bbcc 100644 --- a/gen/discovery1/src/lib.rs +++ b/gen/discovery1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/discovery1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Discovery) ... +//! Handle the following *Resources* with ease from the central [hub](Discovery) ... //! //! * apis //! * [*get rest*](api::ApiGetRestCall) and [*list*](api::ApiListCall) @@ -50,8 +50,8 @@ //! let r = hub.apis().get_rest(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -79,12 +79,12 @@ //! use std::default::Default; //! use discovery1::{Discovery, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -120,10 +120,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -133,25 +133,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/displayvideo1/README.md b/gen/displayvideo1/README.md index 42b3b2d3a1..54e67b86e4 100644 --- a/gen/displayvideo1/README.md +++ b/gen/displayvideo1/README.md @@ -11,7 +11,7 @@ Everything else about the *Display Video* *v1* API can be found at the [official documentation site](https://developers.google.com/display-video/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/DisplayVideo) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/DisplayVideo) ... * [advertisers](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::Advertiser) * [*assets upload*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserAssetUploadCall), [*audit*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserAuditCall), [*bulk edit advertiser assigned targeting options*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserBulkEditAdvertiserAssignedTargetingOptionCall), [*bulk list advertiser assigned targeting options*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserBulkListAdvertiserAssignedTargetingOptionCall), [*campaigns bulk list campaign assigned targeting options*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserCampaignBulkListCampaignAssignedTargetingOptionCall), [*campaigns create*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserCampaignCreateCall), [*campaigns delete*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserCampaignDeleteCall), [*campaigns get*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserCampaignGetCall), [*campaigns list*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserCampaignListCall), [*campaigns patch*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserCampaignPatchCall), [*campaigns targeting types assigned targeting options get*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserCampaignTargetingTypeAssignedTargetingOptionGetCall), [*campaigns targeting types assigned targeting options list*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserCampaignTargetingTypeAssignedTargetingOptionListCall), [*channels create*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserChannelCreateCall), [*channels get*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserChannelGetCall), [*channels list*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserChannelListCall), [*channels patch*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserChannelPatchCall), [*channels sites bulk edit*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserChannelSiteBulkEditCall), [*channels sites create*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserChannelSiteCreateCall), [*channels sites delete*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserChannelSiteDeleteCall), [*channels sites list*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserChannelSiteListCall), [*channels sites replace*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserChannelSiteReplaceCall), [*create*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserCreateCall), [*creatives create*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserCreativeCreateCall), [*creatives delete*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserCreativeDeleteCall), [*creatives get*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserCreativeGetCall), [*creatives list*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserCreativeListCall), [*creatives patch*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserCreativePatchCall), [*delete*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserDeleteCall), [*get*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserGetCall), [*insertion orders bulk list insertion order assigned targeting options*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserInsertionOrderBulkListInsertionOrderAssignedTargetingOptionCall), [*insertion orders create*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserInsertionOrderCreateCall), [*insertion orders delete*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserInsertionOrderDeleteCall), [*insertion orders get*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserInsertionOrderGetCall), [*insertion orders list*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserInsertionOrderListCall), [*insertion orders patch*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserInsertionOrderPatchCall), [*insertion orders targeting types assigned targeting options get*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserInsertionOrderTargetingTypeAssignedTargetingOptionGetCall), [*insertion orders targeting types assigned targeting options list*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserInsertionOrderTargetingTypeAssignedTargetingOptionListCall), [*invoices list*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserInvoiceListCall), [*invoices lookup invoice currency*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserInvoiceLookupInvoiceCurrencyCall), [*line items bulk edit line item assigned targeting options*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserLineItemBulkEditLineItemAssignedTargetingOptionCall), [*line items bulk list line item assigned targeting options*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserLineItemBulkListLineItemAssignedTargetingOptionCall), [*line items create*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserLineItemCreateCall), [*line items delete*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserLineItemDeleteCall), [*line items generate default*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserLineItemGenerateDefaultCall), [*line items get*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserLineItemGetCall), [*line items list*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserLineItemListCall), [*line items patch*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserLineItemPatchCall), [*line items targeting types assigned targeting options create*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserLineItemTargetingTypeAssignedTargetingOptionCreateCall), [*line items targeting types assigned targeting options delete*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserLineItemTargetingTypeAssignedTargetingOptionDeleteCall), [*line items targeting types assigned targeting options get*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserLineItemTargetingTypeAssignedTargetingOptionGetCall), [*line items targeting types assigned targeting options list*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserLineItemTargetingTypeAssignedTargetingOptionListCall), [*list*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserListCall), [*location lists assigned locations bulk edit*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserLocationListAssignedLocationBulkEditCall), [*location lists assigned locations create*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserLocationListAssignedLocationCreateCall), [*location lists assigned locations delete*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserLocationListAssignedLocationDeleteCall), [*location lists assigned locations list*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserLocationListAssignedLocationListCall), [*location lists create*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserLocationListCreateCall), [*location lists get*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserLocationListGetCall), [*location lists list*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserLocationListListCall), [*location lists patch*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserLocationListPatchCall), [*manual triggers activate*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserManualTriggerActivateCall), [*manual triggers create*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserManualTriggerCreateCall), [*manual triggers deactivate*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserManualTriggerDeactivateCall), [*manual triggers get*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserManualTriggerGetCall), [*manual triggers list*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserManualTriggerListCall), [*manual triggers patch*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserManualTriggerPatchCall), [*negative keyword lists create*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserNegativeKeywordListCreateCall), [*negative keyword lists delete*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserNegativeKeywordListDeleteCall), [*negative keyword lists get*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserNegativeKeywordListGetCall), [*negative keyword lists list*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserNegativeKeywordListListCall), [*negative keyword lists negative keywords bulk edit*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserNegativeKeywordListNegativeKeywordBulkEditCall), [*negative keyword lists negative keywords create*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserNegativeKeywordListNegativeKeywordCreateCall), [*negative keyword lists negative keywords delete*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserNegativeKeywordListNegativeKeywordDeleteCall), [*negative keyword lists negative keywords list*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserNegativeKeywordListNegativeKeywordListCall), [*negative keyword lists negative keywords replace*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserNegativeKeywordListNegativeKeywordReplaceCall), [*negative keyword lists patch*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserNegativeKeywordListPatchCall), [*patch*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserPatchCall), [*targeting types assigned targeting options create*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserTargetingTypeAssignedTargetingOptionCreateCall), [*targeting types assigned targeting options delete*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserTargetingTypeAssignedTargetingOptionDeleteCall), [*targeting types assigned targeting options get*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserTargetingTypeAssignedTargetingOptionGetCall) and [*targeting types assigned targeting options list*](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/api::AdvertiserTargetingTypeAssignedTargetingOptionListCall) @@ -167,8 +167,8 @@ let r = hub.advertisers().list(...).doit().await let r = hub.advertisers().patch(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -195,12 +195,12 @@ use displayvideo1::{Result, Error}; use std::default::Default; use displayvideo1::{DisplayVideo, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -240,10 +240,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -253,25 +253,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-displa You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/client::Delegate) to the -[Method Builder](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/client::Delegate) to the +[Method Builder](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/client::RequestValue) and -[decodable](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/client::RequestValue) and +[decodable](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-displayvideo1/5.0.3+20230119/google_displayvideo1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -290,7 +290,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **displayvideo1** library was generated by Sebastian Thiel, and is placed +The **displayvideo1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/displayvideo1/src/api.rs b/gen/displayvideo1/src/api.rs index b6b90b20d1..c2c5151f1e 100644 --- a/gen/displayvideo1/src/api.rs +++ b/gen/displayvideo1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// Create, see, edit, and permanently delete your Display & Video 360 entities and reports DisplayVideo, @@ -76,12 +76,12 @@ impl Default for Scope { /// use std::default::Default; /// use displayvideo1::{DisplayVideo, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/displayvideo1/src/lib.rs b/gen/displayvideo1/src/lib.rs index 2a490c1913..830c1bb339 100644 --- a/gen/displayvideo1/src/lib.rs +++ b/gen/displayvideo1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/displayvideo1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](DisplayVideo) ... +//! Handle the following *Resources* with ease from the central [hub](DisplayVideo) ... //! //! * [advertisers](api::Advertiser) //! * [*assets upload*](api::AdvertiserAssetUploadCall), [*audit*](api::AdvertiserAuditCall), [*bulk edit advertiser assigned targeting options*](api::AdvertiserBulkEditAdvertiserAssignedTargetingOptionCall), [*bulk list advertiser assigned targeting options*](api::AdvertiserBulkListAdvertiserAssignedTargetingOptionCall), [*campaigns bulk list campaign assigned targeting options*](api::AdvertiserCampaignBulkListCampaignAssignedTargetingOptionCall), [*campaigns create*](api::AdvertiserCampaignCreateCall), [*campaigns delete*](api::AdvertiserCampaignDeleteCall), [*campaigns get*](api::AdvertiserCampaignGetCall), [*campaigns list*](api::AdvertiserCampaignListCall), [*campaigns patch*](api::AdvertiserCampaignPatchCall), [*campaigns targeting types assigned targeting options get*](api::AdvertiserCampaignTargetingTypeAssignedTargetingOptionGetCall), [*campaigns targeting types assigned targeting options list*](api::AdvertiserCampaignTargetingTypeAssignedTargetingOptionListCall), [*channels create*](api::AdvertiserChannelCreateCall), [*channels get*](api::AdvertiserChannelGetCall), [*channels list*](api::AdvertiserChannelListCall), [*channels patch*](api::AdvertiserChannelPatchCall), [*channels sites bulk edit*](api::AdvertiserChannelSiteBulkEditCall), [*channels sites create*](api::AdvertiserChannelSiteCreateCall), [*channels sites delete*](api::AdvertiserChannelSiteDeleteCall), [*channels sites list*](api::AdvertiserChannelSiteListCall), [*channels sites replace*](api::AdvertiserChannelSiteReplaceCall), [*create*](api::AdvertiserCreateCall), [*creatives create*](api::AdvertiserCreativeCreateCall), [*creatives delete*](api::AdvertiserCreativeDeleteCall), [*creatives get*](api::AdvertiserCreativeGetCall), [*creatives list*](api::AdvertiserCreativeListCall), [*creatives patch*](api::AdvertiserCreativePatchCall), [*delete*](api::AdvertiserDeleteCall), [*get*](api::AdvertiserGetCall), [*insertion orders bulk list insertion order assigned targeting options*](api::AdvertiserInsertionOrderBulkListInsertionOrderAssignedTargetingOptionCall), [*insertion orders create*](api::AdvertiserInsertionOrderCreateCall), [*insertion orders delete*](api::AdvertiserInsertionOrderDeleteCall), [*insertion orders get*](api::AdvertiserInsertionOrderGetCall), [*insertion orders list*](api::AdvertiserInsertionOrderListCall), [*insertion orders patch*](api::AdvertiserInsertionOrderPatchCall), [*insertion orders targeting types assigned targeting options get*](api::AdvertiserInsertionOrderTargetingTypeAssignedTargetingOptionGetCall), [*insertion orders targeting types assigned targeting options list*](api::AdvertiserInsertionOrderTargetingTypeAssignedTargetingOptionListCall), [*invoices list*](api::AdvertiserInvoiceListCall), [*invoices lookup invoice currency*](api::AdvertiserInvoiceLookupInvoiceCurrencyCall), [*line items bulk edit line item assigned targeting options*](api::AdvertiserLineItemBulkEditLineItemAssignedTargetingOptionCall), [*line items bulk list line item assigned targeting options*](api::AdvertiserLineItemBulkListLineItemAssignedTargetingOptionCall), [*line items create*](api::AdvertiserLineItemCreateCall), [*line items delete*](api::AdvertiserLineItemDeleteCall), [*line items generate default*](api::AdvertiserLineItemGenerateDefaultCall), [*line items get*](api::AdvertiserLineItemGetCall), [*line items list*](api::AdvertiserLineItemListCall), [*line items patch*](api::AdvertiserLineItemPatchCall), [*line items targeting types assigned targeting options create*](api::AdvertiserLineItemTargetingTypeAssignedTargetingOptionCreateCall), [*line items targeting types assigned targeting options delete*](api::AdvertiserLineItemTargetingTypeAssignedTargetingOptionDeleteCall), [*line items targeting types assigned targeting options get*](api::AdvertiserLineItemTargetingTypeAssignedTargetingOptionGetCall), [*line items targeting types assigned targeting options list*](api::AdvertiserLineItemTargetingTypeAssignedTargetingOptionListCall), [*list*](api::AdvertiserListCall), [*location lists assigned locations bulk edit*](api::AdvertiserLocationListAssignedLocationBulkEditCall), [*location lists assigned locations create*](api::AdvertiserLocationListAssignedLocationCreateCall), [*location lists assigned locations delete*](api::AdvertiserLocationListAssignedLocationDeleteCall), [*location lists assigned locations list*](api::AdvertiserLocationListAssignedLocationListCall), [*location lists create*](api::AdvertiserLocationListCreateCall), [*location lists get*](api::AdvertiserLocationListGetCall), [*location lists list*](api::AdvertiserLocationListListCall), [*location lists patch*](api::AdvertiserLocationListPatchCall), [*manual triggers activate*](api::AdvertiserManualTriggerActivateCall), [*manual triggers create*](api::AdvertiserManualTriggerCreateCall), [*manual triggers deactivate*](api::AdvertiserManualTriggerDeactivateCall), [*manual triggers get*](api::AdvertiserManualTriggerGetCall), [*manual triggers list*](api::AdvertiserManualTriggerListCall), [*manual triggers patch*](api::AdvertiserManualTriggerPatchCall), [*negative keyword lists create*](api::AdvertiserNegativeKeywordListCreateCall), [*negative keyword lists delete*](api::AdvertiserNegativeKeywordListDeleteCall), [*negative keyword lists get*](api::AdvertiserNegativeKeywordListGetCall), [*negative keyword lists list*](api::AdvertiserNegativeKeywordListListCall), [*negative keyword lists negative keywords bulk edit*](api::AdvertiserNegativeKeywordListNegativeKeywordBulkEditCall), [*negative keyword lists negative keywords create*](api::AdvertiserNegativeKeywordListNegativeKeywordCreateCall), [*negative keyword lists negative keywords delete*](api::AdvertiserNegativeKeywordListNegativeKeywordDeleteCall), [*negative keyword lists negative keywords list*](api::AdvertiserNegativeKeywordListNegativeKeywordListCall), [*negative keyword lists negative keywords replace*](api::AdvertiserNegativeKeywordListNegativeKeywordReplaceCall), [*negative keyword lists patch*](api::AdvertiserNegativeKeywordListPatchCall), [*patch*](api::AdvertiserPatchCall), [*targeting types assigned targeting options create*](api::AdvertiserTargetingTypeAssignedTargetingOptionCreateCall), [*targeting types assigned targeting options delete*](api::AdvertiserTargetingTypeAssignedTargetingOptionDeleteCall), [*targeting types assigned targeting options get*](api::AdvertiserTargetingTypeAssignedTargetingOptionGetCall) and [*targeting types assigned targeting options list*](api::AdvertiserTargetingTypeAssignedTargetingOptionListCall) @@ -167,8 +167,8 @@ //! let r = hub.advertisers().patch(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -196,12 +196,12 @@ //! use std::default::Default; //! use displayvideo1::{DisplayVideo, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -241,10 +241,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -254,25 +254,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/dlp2/README.md b/gen/dlp2/README.md index c6f76eba80..964e63a6ac 100644 --- a/gen/dlp2/README.md +++ b/gen/dlp2/README.md @@ -11,7 +11,7 @@ Everything else about the *DLP* *v2* API can be found at the [official documentation site](https://cloud.google.com/dlp/docs/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-dlp2/5.0.3+20230121/google_dlp2/DLP) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-dlp2/5.0.3+20230121/google_dlp2/DLP) ... * info types * [*list*](https://docs.rs/google-dlp2/5.0.3+20230121/google_dlp2/api::InfoTypeListCall) @@ -75,8 +75,8 @@ let r = hub.projects().locations_stored_info_types_delete(...).doit().await let r = hub.projects().stored_info_types_delete(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -104,12 +104,12 @@ use dlp2::{Result, Error}; use std::default::Default; use dlp2::{DLP, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -150,10 +150,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-dlp2/5.0.3+20230121/google_dlp2/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-dlp2/5.0.3+20230121/google_dlp2/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -163,25 +163,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-dlp2/5 You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-dlp2/5.0.3+20230121/google_dlp2/client::Delegate) to the -[Method Builder](https://docs.rs/google-dlp2/5.0.3+20230121/google_dlp2/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-dlp2/5.0.3+20230121/google_dlp2/client::Delegate) to the +[Method Builder](https://docs.rs/google-dlp2/5.0.3+20230121/google_dlp2/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-dlp2/5.0.3+20230121/google_dlp2/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-dlp2/5.0.3+20230121/google_dlp2/client::RequestValue) and -[decodable](https://docs.rs/google-dlp2/5.0.3+20230121/google_dlp2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-dlp2/5.0.3+20230121/google_dlp2/client::RequestValue) and +[decodable](https://docs.rs/google-dlp2/5.0.3+20230121/google_dlp2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-dlp2/5.0.3+20230121/google_dlp2/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-dlp2/5.0.3+20230121/google_dlp2/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -200,7 +200,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **dlp2** library was generated by Sebastian Thiel, and is placed +The **dlp2** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/dlp2/src/api.rs b/gen/dlp2/src/api.rs index 8314bddb82..a8fd8e975c 100644 --- a/gen/dlp2/src/api.rs +++ b/gen/dlp2/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use dlp2::{DLP, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/dlp2/src/lib.rs b/gen/dlp2/src/lib.rs index a27e414c0f..0f3fabe213 100644 --- a/gen/dlp2/src/lib.rs +++ b/gen/dlp2/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/dlp2). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](DLP) ... +//! Handle the following *Resources* with ease from the central [hub](DLP) ... //! //! * info types //! * [*list*](api::InfoTypeListCall) @@ -75,8 +75,8 @@ //! let r = hub.projects().stored_info_types_delete(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -105,12 +105,12 @@ //! use std::default::Default; //! use dlp2::{DLP, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -151,10 +151,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -164,25 +164,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/dlp2_beta1/README.md b/gen/dlp2_beta1/README.md index 12aa1c84a7..c95522d072 100644 --- a/gen/dlp2_beta1/README.md +++ b/gen/dlp2_beta1/README.md @@ -11,7 +11,7 @@ Everything else about the *DLP* *v2_beta1* API can be found at the [official documentation site](https://cloud.google.com/dlp/docs/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-dlp2_beta1/5.0.3+20171205/google_dlp2_beta1/DLP) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-dlp2_beta1/5.0.3+20171205/google_dlp2_beta1/DLP) ... * content * [*deidentify*](https://docs.rs/google-dlp2_beta1/5.0.3+20171205/google_dlp2_beta1/api::ContentDeidentifyCall), [*inspect*](https://docs.rs/google-dlp2_beta1/5.0.3+20171205/google_dlp2_beta1/api::ContentInspectCall) and [*redact*](https://docs.rs/google-dlp2_beta1/5.0.3+20171205/google_dlp2_beta1/api::ContentRedactCall) @@ -61,8 +61,8 @@ let r = hub.inspect().operations_create(...).doit().await let r = hub.inspect().operations_get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -89,12 +89,12 @@ use dlp2_beta1::{Result, Error}; use std::default::Default; use dlp2_beta1::{DLP, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -130,10 +130,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-dlp2_beta1/5.0.3+20171205/google_dlp2_beta1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-dlp2_beta1/5.0.3+20171205/google_dlp2_beta1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -143,25 +143,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-dlp2_b You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-dlp2_beta1/5.0.3+20171205/google_dlp2_beta1/client::Delegate) to the -[Method Builder](https://docs.rs/google-dlp2_beta1/5.0.3+20171205/google_dlp2_beta1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-dlp2_beta1/5.0.3+20171205/google_dlp2_beta1/client::Delegate) to the +[Method Builder](https://docs.rs/google-dlp2_beta1/5.0.3+20171205/google_dlp2_beta1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-dlp2_beta1/5.0.3+20171205/google_dlp2_beta1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-dlp2_beta1/5.0.3+20171205/google_dlp2_beta1/client::RequestValue) and -[decodable](https://docs.rs/google-dlp2_beta1/5.0.3+20171205/google_dlp2_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-dlp2_beta1/5.0.3+20171205/google_dlp2_beta1/client::RequestValue) and +[decodable](https://docs.rs/google-dlp2_beta1/5.0.3+20171205/google_dlp2_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-dlp2_beta1/5.0.3+20171205/google_dlp2_beta1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-dlp2_beta1/5.0.3+20171205/google_dlp2_beta1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -180,7 +180,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **dlp2_beta1** library was generated by Sebastian Thiel, and is placed +The **dlp2_beta1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/dlp2_beta1/src/api.rs b/gen/dlp2_beta1/src/api.rs index 9ef2cddd62..4d8e6b9f10 100644 --- a/gen/dlp2_beta1/src/api.rs +++ b/gen/dlp2_beta1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your data across Google Cloud Platform services CloudPlatform, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use dlp2_beta1::{DLP, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/dlp2_beta1/src/lib.rs b/gen/dlp2_beta1/src/lib.rs index 54580331b3..7c184c8b27 100644 --- a/gen/dlp2_beta1/src/lib.rs +++ b/gen/dlp2_beta1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/dlp2_beta1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](DLP) ... +//! Handle the following *Resources* with ease from the central [hub](DLP) ... //! //! * content //! * [*deidentify*](api::ContentDeidentifyCall), [*inspect*](api::ContentInspectCall) and [*redact*](api::ContentRedactCall) @@ -61,8 +61,8 @@ //! let r = hub.inspect().operations_get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -90,12 +90,12 @@ //! use std::default::Default; //! use dlp2_beta1::{DLP, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -131,10 +131,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -144,25 +144,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/dns1/README.md b/gen/dns1/README.md index 03c1029ca1..259d4b7aa7 100644 --- a/gen/dns1/README.md +++ b/gen/dns1/README.md @@ -11,7 +11,7 @@ Everything else about the *Dns* *v1* API can be found at the [official documentation site](https://cloud.google.com/dns/docs). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-dns1/5.0.3+20230119/google_dns1/Dns) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-dns1/5.0.3+20230119/google_dns1/Dns) ... * [changes](https://docs.rs/google-dns1/5.0.3+20230119/google_dns1/api::Change) * [*create*](https://docs.rs/google-dns1/5.0.3+20230119/google_dns1/api::ChangeCreateCall), [*get*](https://docs.rs/google-dns1/5.0.3+20230119/google_dns1/api::ChangeGetCall) and [*list*](https://docs.rs/google-dns1/5.0.3+20230119/google_dns1/api::ChangeListCall) @@ -74,8 +74,8 @@ let r = hub.managed_zones().test_iam_permissions(...).doit().await let r = hub.managed_zones().update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -102,12 +102,12 @@ use dns1::{Result, Error}; use std::default::Default; use dns1::{Dns, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -146,10 +146,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-dns1/5.0.3+20230119/google_dns1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-dns1/5.0.3+20230119/google_dns1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -159,25 +159,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-dns1/5 You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-dns1/5.0.3+20230119/google_dns1/client::Delegate) to the -[Method Builder](https://docs.rs/google-dns1/5.0.3+20230119/google_dns1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-dns1/5.0.3+20230119/google_dns1/client::Delegate) to the +[Method Builder](https://docs.rs/google-dns1/5.0.3+20230119/google_dns1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-dns1/5.0.3+20230119/google_dns1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-dns1/5.0.3+20230119/google_dns1/client::RequestValue) and -[decodable](https://docs.rs/google-dns1/5.0.3+20230119/google_dns1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-dns1/5.0.3+20230119/google_dns1/client::RequestValue) and +[decodable](https://docs.rs/google-dns1/5.0.3+20230119/google_dns1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-dns1/5.0.3+20230119/google_dns1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-dns1/5.0.3+20230119/google_dns1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -196,7 +196,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **dns1** library was generated by Sebastian Thiel, and is placed +The **dns1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/dns1/src/api.rs b/gen/dns1/src/api.rs index c805b76055..52cc17511a 100644 --- a/gen/dns1/src/api.rs +++ b/gen/dns1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -76,12 +76,12 @@ impl Default for Scope { /// use std::default::Default; /// use dns1::{Dns, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/dns1/src/lib.rs b/gen/dns1/src/lib.rs index 4074c68443..fe5531b53e 100644 --- a/gen/dns1/src/lib.rs +++ b/gen/dns1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/dns1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Dns) ... +//! Handle the following *Resources* with ease from the central [hub](Dns) ... //! //! * [changes](api::Change) //! * [*create*](api::ChangeCreateCall), [*get*](api::ChangeGetCall) and [*list*](api::ChangeListCall) @@ -74,8 +74,8 @@ //! let r = hub.managed_zones().update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -103,12 +103,12 @@ //! use std::default::Default; //! use dns1::{Dns, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -147,10 +147,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -160,25 +160,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/dns2/README.md b/gen/dns2/README.md index 0a7312b7ce..4411552196 100644 --- a/gen/dns2/README.md +++ b/gen/dns2/README.md @@ -11,7 +11,7 @@ Everything else about the *Dns* *v2* API can be found at the [official documentation site](https://cloud.google.com/dns/docs). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-dns2/5.0.3+20230119/google_dns2/Dns) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-dns2/5.0.3+20230119/google_dns2/Dns) ... * [changes](https://docs.rs/google-dns2/5.0.3+20230119/google_dns2/api::Change) * [*create*](https://docs.rs/google-dns2/5.0.3+20230119/google_dns2/api::ChangeCreateCall), [*get*](https://docs.rs/google-dns2/5.0.3+20230119/google_dns2/api::ChangeGetCall) and [*list*](https://docs.rs/google-dns2/5.0.3+20230119/google_dns2/api::ChangeListCall) @@ -74,8 +74,8 @@ let r = hub.managed_zones().test_iam_permissions(...).doit().await let r = hub.managed_zones().update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -102,12 +102,12 @@ use dns2::{Result, Error}; use std::default::Default; use dns2::{Dns, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -146,10 +146,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-dns2/5.0.3+20230119/google_dns2/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-dns2/5.0.3+20230119/google_dns2/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -159,25 +159,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-dns2/5 You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-dns2/5.0.3+20230119/google_dns2/client::Delegate) to the -[Method Builder](https://docs.rs/google-dns2/5.0.3+20230119/google_dns2/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-dns2/5.0.3+20230119/google_dns2/client::Delegate) to the +[Method Builder](https://docs.rs/google-dns2/5.0.3+20230119/google_dns2/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-dns2/5.0.3+20230119/google_dns2/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-dns2/5.0.3+20230119/google_dns2/client::RequestValue) and -[decodable](https://docs.rs/google-dns2/5.0.3+20230119/google_dns2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-dns2/5.0.3+20230119/google_dns2/client::RequestValue) and +[decodable](https://docs.rs/google-dns2/5.0.3+20230119/google_dns2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-dns2/5.0.3+20230119/google_dns2/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-dns2/5.0.3+20230119/google_dns2/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -196,7 +196,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **dns2** library was generated by Sebastian Thiel, and is placed +The **dns2** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/dns2/src/api.rs b/gen/dns2/src/api.rs index c76f6fc330..2cc93ec123 100644 --- a/gen/dns2/src/api.rs +++ b/gen/dns2/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -76,12 +76,12 @@ impl Default for Scope { /// use std::default::Default; /// use dns2::{Dns, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/dns2/src/lib.rs b/gen/dns2/src/lib.rs index 0f8f05174b..32205a6eb0 100644 --- a/gen/dns2/src/lib.rs +++ b/gen/dns2/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/dns2). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Dns) ... +//! Handle the following *Resources* with ease from the central [hub](Dns) ... //! //! * [changes](api::Change) //! * [*create*](api::ChangeCreateCall), [*get*](api::ChangeGetCall) and [*list*](api::ChangeListCall) @@ -74,8 +74,8 @@ //! let r = hub.managed_zones().update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -103,12 +103,12 @@ //! use std::default::Default; //! use dns2::{Dns, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -147,10 +147,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -160,25 +160,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/docs1/README.md b/gen/docs1/README.md index ec8c6eed6b..6197508543 100644 --- a/gen/docs1/README.md +++ b/gen/docs1/README.md @@ -11,7 +11,7 @@ Everything else about the *Docs* *v1* API can be found at the [official documentation site](https://developers.google.com/docs/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-docs1/5.0.3+20230119/google_docs1/Docs) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-docs1/5.0.3+20230119/google_docs1/Docs) ... * [documents](https://docs.rs/google-docs1/5.0.3+20230119/google_docs1/api::Document) * [*batch update*](https://docs.rs/google-docs1/5.0.3+20230119/google_docs1/api::DocumentBatchUpdateCall), [*create*](https://docs.rs/google-docs1/5.0.3+20230119/google_docs1/api::DocumentCreateCall) and [*get*](https://docs.rs/google-docs1/5.0.3+20230119/google_docs1/api::DocumentGetCall) @@ -52,8 +52,8 @@ let r = hub.documents().create(...).doit().await let r = hub.documents().get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -81,12 +81,12 @@ use docs1::{Result, Error}; use std::default::Default; use docs1::{Docs, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -127,10 +127,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-docs1/5.0.3+20230119/google_docs1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-docs1/5.0.3+20230119/google_docs1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -140,25 +140,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-docs1/ You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-docs1/5.0.3+20230119/google_docs1/client::Delegate) to the -[Method Builder](https://docs.rs/google-docs1/5.0.3+20230119/google_docs1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-docs1/5.0.3+20230119/google_docs1/client::Delegate) to the +[Method Builder](https://docs.rs/google-docs1/5.0.3+20230119/google_docs1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-docs1/5.0.3+20230119/google_docs1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-docs1/5.0.3+20230119/google_docs1/client::RequestValue) and -[decodable](https://docs.rs/google-docs1/5.0.3+20230119/google_docs1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-docs1/5.0.3+20230119/google_docs1/client::RequestValue) and +[decodable](https://docs.rs/google-docs1/5.0.3+20230119/google_docs1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-docs1/5.0.3+20230119/google_docs1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-docs1/5.0.3+20230119/google_docs1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -177,7 +177,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **docs1** library was generated by Sebastian Thiel, and is placed +The **docs1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/docs1/src/api.rs b/gen/docs1/src/api.rs index e64e974654..bcd78552b5 100644 --- a/gen/docs1/src/api.rs +++ b/gen/docs1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, create, and delete all your Google Docs documents Document, @@ -81,12 +81,12 @@ impl Default for Scope { /// use std::default::Default; /// use docs1::{Docs, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/docs1/src/lib.rs b/gen/docs1/src/lib.rs index a1c51a20fc..3b691bb518 100644 --- a/gen/docs1/src/lib.rs +++ b/gen/docs1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/docs1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Docs) ... +//! Handle the following *Resources* with ease from the central [hub](Docs) ... //! //! * [documents](api::Document) //! * [*batch update*](api::DocumentBatchUpdateCall), [*create*](api::DocumentCreateCall) and [*get*](api::DocumentGetCall) @@ -52,8 +52,8 @@ //! let r = hub.documents().get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -82,12 +82,12 @@ //! use std::default::Default; //! use docs1::{Docs, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -128,10 +128,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -141,25 +141,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/documentai1/README.md b/gen/documentai1/README.md index c1343ffcac..0c865495a0 100644 --- a/gen/documentai1/README.md +++ b/gen/documentai1/README.md @@ -11,7 +11,7 @@ Everything else about the *Document* *v1* API can be found at the [official documentation site](https://cloud.google.com/document-ai/docs/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-documentai1/5.0.3+20230117/google_documentai1/Document) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-documentai1/5.0.3+20230117/google_documentai1/Document) ... * operations * [*delete*](https://docs.rs/google-documentai1/5.0.3+20230117/google_documentai1/api::OperationDeleteCall) @@ -65,8 +65,8 @@ let r = hub.projects().locations_processors_set_default_processor_version(...).d let r = hub.projects().operations_get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -94,12 +94,12 @@ use documentai1::{Result, Error}; use std::default::Default; use documentai1::{Document, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -140,10 +140,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-documentai1/5.0.3+20230117/google_documentai1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-documentai1/5.0.3+20230117/google_documentai1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -153,25 +153,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-docume You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-documentai1/5.0.3+20230117/google_documentai1/client::Delegate) to the -[Method Builder](https://docs.rs/google-documentai1/5.0.3+20230117/google_documentai1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-documentai1/5.0.3+20230117/google_documentai1/client::Delegate) to the +[Method Builder](https://docs.rs/google-documentai1/5.0.3+20230117/google_documentai1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-documentai1/5.0.3+20230117/google_documentai1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-documentai1/5.0.3+20230117/google_documentai1/client::RequestValue) and -[decodable](https://docs.rs/google-documentai1/5.0.3+20230117/google_documentai1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-documentai1/5.0.3+20230117/google_documentai1/client::RequestValue) and +[decodable](https://docs.rs/google-documentai1/5.0.3+20230117/google_documentai1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-documentai1/5.0.3+20230117/google_documentai1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-documentai1/5.0.3+20230117/google_documentai1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -190,7 +190,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **documentai1** library was generated by Sebastian Thiel, and is placed +The **documentai1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/documentai1/src/api.rs b/gen/documentai1/src/api.rs index ed4499233c..675f2a3a44 100644 --- a/gen/documentai1/src/api.rs +++ b/gen/documentai1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use documentai1::{Document, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/documentai1/src/lib.rs b/gen/documentai1/src/lib.rs index 208cb2b2b1..5d49bf894a 100644 --- a/gen/documentai1/src/lib.rs +++ b/gen/documentai1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/documentai1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Document) ... +//! Handle the following *Resources* with ease from the central [hub](Document) ... //! //! * operations //! * [*delete*](api::OperationDeleteCall) @@ -65,8 +65,8 @@ //! let r = hub.projects().operations_get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -95,12 +95,12 @@ //! use std::default::Default; //! use documentai1::{Document, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -141,10 +141,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -154,25 +154,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/documentai1_beta2/README.md b/gen/documentai1_beta2/README.md index c460f78e80..bb6dbdad0f 100644 --- a/gen/documentai1_beta2/README.md +++ b/gen/documentai1_beta2/README.md @@ -11,7 +11,7 @@ Everything else about the *Document* *v1_beta2* API can be found at the [official documentation site](https://cloud.google.com/document-ai/docs/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-documentai1_beta2/5.0.3+20230117/google_documentai1_beta2/Document) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-documentai1_beta2/5.0.3+20230117/google_documentai1_beta2/Document) ... * projects * [*documents batch process*](https://docs.rs/google-documentai1_beta2/5.0.3+20230117/google_documentai1_beta2/api::ProjectDocumentBatchProcesCall), [*documents process*](https://docs.rs/google-documentai1_beta2/5.0.3+20230117/google_documentai1_beta2/api::ProjectDocumentProcesCall), [*locations documents batch process*](https://docs.rs/google-documentai1_beta2/5.0.3+20230117/google_documentai1_beta2/api::ProjectLocationDocumentBatchProcesCall), [*locations documents process*](https://docs.rs/google-documentai1_beta2/5.0.3+20230117/google_documentai1_beta2/api::ProjectLocationDocumentProcesCall), [*locations operations get*](https://docs.rs/google-documentai1_beta2/5.0.3+20230117/google_documentai1_beta2/api::ProjectLocationOperationGetCall) and [*operations get*](https://docs.rs/google-documentai1_beta2/5.0.3+20230117/google_documentai1_beta2/api::ProjectOperationGetCall) @@ -53,8 +53,8 @@ let r = hub.projects().locations_operations_get(...).doit().await let r = hub.projects().operations_get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -82,12 +82,12 @@ use documentai1_beta2::{Result, Error}; use std::default::Default; use documentai1_beta2::{Document, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -128,10 +128,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-documentai1_beta2/5.0.3+20230117/google_documentai1_beta2/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-documentai1_beta2/5.0.3+20230117/google_documentai1_beta2/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -141,25 +141,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-docume You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-documentai1_beta2/5.0.3+20230117/google_documentai1_beta2/client::Delegate) to the -[Method Builder](https://docs.rs/google-documentai1_beta2/5.0.3+20230117/google_documentai1_beta2/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-documentai1_beta2/5.0.3+20230117/google_documentai1_beta2/client::Delegate) to the +[Method Builder](https://docs.rs/google-documentai1_beta2/5.0.3+20230117/google_documentai1_beta2/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-documentai1_beta2/5.0.3+20230117/google_documentai1_beta2/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-documentai1_beta2/5.0.3+20230117/google_documentai1_beta2/client::RequestValue) and -[decodable](https://docs.rs/google-documentai1_beta2/5.0.3+20230117/google_documentai1_beta2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-documentai1_beta2/5.0.3+20230117/google_documentai1_beta2/client::RequestValue) and +[decodable](https://docs.rs/google-documentai1_beta2/5.0.3+20230117/google_documentai1_beta2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-documentai1_beta2/5.0.3+20230117/google_documentai1_beta2/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-documentai1_beta2/5.0.3+20230117/google_documentai1_beta2/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -178,7 +178,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **documentai1_beta2** library was generated by Sebastian Thiel, and is placed +The **documentai1_beta2** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/documentai1_beta2/src/api.rs b/gen/documentai1_beta2/src/api.rs index 91196dda6f..89afb24847 100644 --- a/gen/documentai1_beta2/src/api.rs +++ b/gen/documentai1_beta2/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use documentai1_beta2::{Document, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/documentai1_beta2/src/lib.rs b/gen/documentai1_beta2/src/lib.rs index c0f0df9872..9d1b3accc4 100644 --- a/gen/documentai1_beta2/src/lib.rs +++ b/gen/documentai1_beta2/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/documentai1_beta2). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Document) ... +//! Handle the following *Resources* with ease from the central [hub](Document) ... //! //! * projects //! * [*documents batch process*](api::ProjectDocumentBatchProcesCall), [*documents process*](api::ProjectDocumentProcesCall), [*locations documents batch process*](api::ProjectLocationDocumentBatchProcesCall), [*locations documents process*](api::ProjectLocationDocumentProcesCall), [*locations operations get*](api::ProjectLocationOperationGetCall) and [*operations get*](api::ProjectOperationGetCall) @@ -53,8 +53,8 @@ //! let r = hub.projects().operations_get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -83,12 +83,12 @@ //! use std::default::Default; //! use documentai1_beta2::{Document, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -129,10 +129,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -142,25 +142,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/domains1/README.md b/gen/domains1/README.md index 360c6194ba..2fc003491c 100644 --- a/gen/domains1/README.md +++ b/gen/domains1/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Domains* *v1* API can be found at the [official documentation site](https://cloud.google.com/domains/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-domains1/5.0.3+20230105/google_domains1/CloudDomains) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-domains1/5.0.3+20230105/google_domains1/CloudDomains) ... * projects * [*locations get*](https://docs.rs/google-domains1/5.0.3+20230105/google_domains1/api::ProjectLocationGetCall), [*locations list*](https://docs.rs/google-domains1/5.0.3+20230105/google_domains1/api::ProjectLocationListCall), [*locations operations get*](https://docs.rs/google-domains1/5.0.3+20230105/google_domains1/api::ProjectLocationOperationGetCall), [*locations operations list*](https://docs.rs/google-domains1/5.0.3+20230105/google_domains1/api::ProjectLocationOperationListCall), [*locations registrations configure contact settings*](https://docs.rs/google-domains1/5.0.3+20230105/google_domains1/api::ProjectLocationRegistrationConfigureContactSettingCall), [*locations registrations configure dns settings*](https://docs.rs/google-domains1/5.0.3+20230105/google_domains1/api::ProjectLocationRegistrationConfigureDnsSettingCall), [*locations registrations configure management settings*](https://docs.rs/google-domains1/5.0.3+20230105/google_domains1/api::ProjectLocationRegistrationConfigureManagementSettingCall), [*locations registrations delete*](https://docs.rs/google-domains1/5.0.3+20230105/google_domains1/api::ProjectLocationRegistrationDeleteCall), [*locations registrations export*](https://docs.rs/google-domains1/5.0.3+20230105/google_domains1/api::ProjectLocationRegistrationExportCall), [*locations registrations get*](https://docs.rs/google-domains1/5.0.3+20230105/google_domains1/api::ProjectLocationRegistrationGetCall), [*locations registrations get iam policy*](https://docs.rs/google-domains1/5.0.3+20230105/google_domains1/api::ProjectLocationRegistrationGetIamPolicyCall), [*locations registrations import*](https://docs.rs/google-domains1/5.0.3+20230105/google_domains1/api::ProjectLocationRegistrationImportCall), [*locations registrations list*](https://docs.rs/google-domains1/5.0.3+20230105/google_domains1/api::ProjectLocationRegistrationListCall), [*locations registrations patch*](https://docs.rs/google-domains1/5.0.3+20230105/google_domains1/api::ProjectLocationRegistrationPatchCall), [*locations registrations register*](https://docs.rs/google-domains1/5.0.3+20230105/google_domains1/api::ProjectLocationRegistrationRegisterCall), [*locations registrations reset authorization code*](https://docs.rs/google-domains1/5.0.3+20230105/google_domains1/api::ProjectLocationRegistrationResetAuthorizationCodeCall), [*locations registrations retrieve authorization code*](https://docs.rs/google-domains1/5.0.3+20230105/google_domains1/api::ProjectLocationRegistrationRetrieveAuthorizationCodeCall), [*locations registrations retrieve importable domains*](https://docs.rs/google-domains1/5.0.3+20230105/google_domains1/api::ProjectLocationRegistrationRetrieveImportableDomainCall), [*locations registrations retrieve register parameters*](https://docs.rs/google-domains1/5.0.3+20230105/google_domains1/api::ProjectLocationRegistrationRetrieveRegisterParameterCall), [*locations registrations retrieve transfer parameters*](https://docs.rs/google-domains1/5.0.3+20230105/google_domains1/api::ProjectLocationRegistrationRetrieveTransferParameterCall), [*locations registrations search domains*](https://docs.rs/google-domains1/5.0.3+20230105/google_domains1/api::ProjectLocationRegistrationSearchDomainCall), [*locations registrations set iam policy*](https://docs.rs/google-domains1/5.0.3+20230105/google_domains1/api::ProjectLocationRegistrationSetIamPolicyCall), [*locations registrations test iam permissions*](https://docs.rs/google-domains1/5.0.3+20230105/google_domains1/api::ProjectLocationRegistrationTestIamPermissionCall) and [*locations registrations transfer*](https://docs.rs/google-domains1/5.0.3+20230105/google_domains1/api::ProjectLocationRegistrationTransferCall) @@ -59,8 +59,8 @@ let r = hub.projects().locations_registrations_register(...).doit().await let r = hub.projects().locations_registrations_transfer(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -88,12 +88,12 @@ use domains1::{Result, Error}; use std::default::Default; use domains1::{CloudDomains, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -135,10 +135,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-domains1/5.0.3+20230105/google_domains1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-domains1/5.0.3+20230105/google_domains1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -148,25 +148,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-domain You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-domains1/5.0.3+20230105/google_domains1/client::Delegate) to the -[Method Builder](https://docs.rs/google-domains1/5.0.3+20230105/google_domains1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-domains1/5.0.3+20230105/google_domains1/client::Delegate) to the +[Method Builder](https://docs.rs/google-domains1/5.0.3+20230105/google_domains1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-domains1/5.0.3+20230105/google_domains1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-domains1/5.0.3+20230105/google_domains1/client::RequestValue) and -[decodable](https://docs.rs/google-domains1/5.0.3+20230105/google_domains1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-domains1/5.0.3+20230105/google_domains1/client::RequestValue) and +[decodable](https://docs.rs/google-domains1/5.0.3+20230105/google_domains1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-domains1/5.0.3+20230105/google_domains1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-domains1/5.0.3+20230105/google_domains1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -185,7 +185,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **domains1** library was generated by Sebastian Thiel, and is placed +The **domains1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/domains1/src/api.rs b/gen/domains1/src/api.rs index 3b6f9522b9..21a695a460 100644 --- a/gen/domains1/src/api.rs +++ b/gen/domains1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use domains1::{CloudDomains, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/domains1/src/lib.rs b/gen/domains1/src/lib.rs index dc4bb607f0..d9616052b6 100644 --- a/gen/domains1/src/lib.rs +++ b/gen/domains1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/domains1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudDomains) ... +//! Handle the following *Resources* with ease from the central [hub](CloudDomains) ... //! //! * projects //! * [*locations get*](api::ProjectLocationGetCall), [*locations list*](api::ProjectLocationListCall), [*locations operations get*](api::ProjectLocationOperationGetCall), [*locations operations list*](api::ProjectLocationOperationListCall), [*locations registrations configure contact settings*](api::ProjectLocationRegistrationConfigureContactSettingCall), [*locations registrations configure dns settings*](api::ProjectLocationRegistrationConfigureDnsSettingCall), [*locations registrations configure management settings*](api::ProjectLocationRegistrationConfigureManagementSettingCall), [*locations registrations delete*](api::ProjectLocationRegistrationDeleteCall), [*locations registrations export*](api::ProjectLocationRegistrationExportCall), [*locations registrations get*](api::ProjectLocationRegistrationGetCall), [*locations registrations get iam policy*](api::ProjectLocationRegistrationGetIamPolicyCall), [*locations registrations import*](api::ProjectLocationRegistrationImportCall), [*locations registrations list*](api::ProjectLocationRegistrationListCall), [*locations registrations patch*](api::ProjectLocationRegistrationPatchCall), [*locations registrations register*](api::ProjectLocationRegistrationRegisterCall), [*locations registrations reset authorization code*](api::ProjectLocationRegistrationResetAuthorizationCodeCall), [*locations registrations retrieve authorization code*](api::ProjectLocationRegistrationRetrieveAuthorizationCodeCall), [*locations registrations retrieve importable domains*](api::ProjectLocationRegistrationRetrieveImportableDomainCall), [*locations registrations retrieve register parameters*](api::ProjectLocationRegistrationRetrieveRegisterParameterCall), [*locations registrations retrieve transfer parameters*](api::ProjectLocationRegistrationRetrieveTransferParameterCall), [*locations registrations search domains*](api::ProjectLocationRegistrationSearchDomainCall), [*locations registrations set iam policy*](api::ProjectLocationRegistrationSetIamPolicyCall), [*locations registrations test iam permissions*](api::ProjectLocationRegistrationTestIamPermissionCall) and [*locations registrations transfer*](api::ProjectLocationRegistrationTransferCall) @@ -59,8 +59,8 @@ //! let r = hub.projects().locations_registrations_transfer(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -89,12 +89,12 @@ //! use std::default::Default; //! use domains1::{CloudDomains, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -136,10 +136,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -149,25 +149,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/domains1_beta1/README.md b/gen/domains1_beta1/README.md index 3e9b6f21bd..e994dcbd3f 100644 --- a/gen/domains1_beta1/README.md +++ b/gen/domains1_beta1/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Domains* *v1_beta1* API can be found at the [official documentation site](https://cloud.google.com/domains/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-domains1_beta1/5.0.3+20230105/google_domains1_beta1/CloudDomains) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-domains1_beta1/5.0.3+20230105/google_domains1_beta1/CloudDomains) ... * projects * [*locations get*](https://docs.rs/google-domains1_beta1/5.0.3+20230105/google_domains1_beta1/api::ProjectLocationGetCall), [*locations list*](https://docs.rs/google-domains1_beta1/5.0.3+20230105/google_domains1_beta1/api::ProjectLocationListCall), [*locations operations get*](https://docs.rs/google-domains1_beta1/5.0.3+20230105/google_domains1_beta1/api::ProjectLocationOperationGetCall), [*locations operations list*](https://docs.rs/google-domains1_beta1/5.0.3+20230105/google_domains1_beta1/api::ProjectLocationOperationListCall), [*locations registrations configure contact settings*](https://docs.rs/google-domains1_beta1/5.0.3+20230105/google_domains1_beta1/api::ProjectLocationRegistrationConfigureContactSettingCall), [*locations registrations configure dns settings*](https://docs.rs/google-domains1_beta1/5.0.3+20230105/google_domains1_beta1/api::ProjectLocationRegistrationConfigureDnsSettingCall), [*locations registrations configure management settings*](https://docs.rs/google-domains1_beta1/5.0.3+20230105/google_domains1_beta1/api::ProjectLocationRegistrationConfigureManagementSettingCall), [*locations registrations delete*](https://docs.rs/google-domains1_beta1/5.0.3+20230105/google_domains1_beta1/api::ProjectLocationRegistrationDeleteCall), [*locations registrations export*](https://docs.rs/google-domains1_beta1/5.0.3+20230105/google_domains1_beta1/api::ProjectLocationRegistrationExportCall), [*locations registrations get*](https://docs.rs/google-domains1_beta1/5.0.3+20230105/google_domains1_beta1/api::ProjectLocationRegistrationGetCall), [*locations registrations get iam policy*](https://docs.rs/google-domains1_beta1/5.0.3+20230105/google_domains1_beta1/api::ProjectLocationRegistrationGetIamPolicyCall), [*locations registrations import*](https://docs.rs/google-domains1_beta1/5.0.3+20230105/google_domains1_beta1/api::ProjectLocationRegistrationImportCall), [*locations registrations list*](https://docs.rs/google-domains1_beta1/5.0.3+20230105/google_domains1_beta1/api::ProjectLocationRegistrationListCall), [*locations registrations patch*](https://docs.rs/google-domains1_beta1/5.0.3+20230105/google_domains1_beta1/api::ProjectLocationRegistrationPatchCall), [*locations registrations register*](https://docs.rs/google-domains1_beta1/5.0.3+20230105/google_domains1_beta1/api::ProjectLocationRegistrationRegisterCall), [*locations registrations reset authorization code*](https://docs.rs/google-domains1_beta1/5.0.3+20230105/google_domains1_beta1/api::ProjectLocationRegistrationResetAuthorizationCodeCall), [*locations registrations retrieve authorization code*](https://docs.rs/google-domains1_beta1/5.0.3+20230105/google_domains1_beta1/api::ProjectLocationRegistrationRetrieveAuthorizationCodeCall), [*locations registrations retrieve importable domains*](https://docs.rs/google-domains1_beta1/5.0.3+20230105/google_domains1_beta1/api::ProjectLocationRegistrationRetrieveImportableDomainCall), [*locations registrations retrieve register parameters*](https://docs.rs/google-domains1_beta1/5.0.3+20230105/google_domains1_beta1/api::ProjectLocationRegistrationRetrieveRegisterParameterCall), [*locations registrations retrieve transfer parameters*](https://docs.rs/google-domains1_beta1/5.0.3+20230105/google_domains1_beta1/api::ProjectLocationRegistrationRetrieveTransferParameterCall), [*locations registrations search domains*](https://docs.rs/google-domains1_beta1/5.0.3+20230105/google_domains1_beta1/api::ProjectLocationRegistrationSearchDomainCall), [*locations registrations set iam policy*](https://docs.rs/google-domains1_beta1/5.0.3+20230105/google_domains1_beta1/api::ProjectLocationRegistrationSetIamPolicyCall), [*locations registrations test iam permissions*](https://docs.rs/google-domains1_beta1/5.0.3+20230105/google_domains1_beta1/api::ProjectLocationRegistrationTestIamPermissionCall) and [*locations registrations transfer*](https://docs.rs/google-domains1_beta1/5.0.3+20230105/google_domains1_beta1/api::ProjectLocationRegistrationTransferCall) @@ -59,8 +59,8 @@ let r = hub.projects().locations_registrations_register(...).doit().await let r = hub.projects().locations_registrations_transfer(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -88,12 +88,12 @@ use domains1_beta1::{Result, Error}; use std::default::Default; use domains1_beta1::{CloudDomains, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -135,10 +135,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-domains1_beta1/5.0.3+20230105/google_domains1_beta1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-domains1_beta1/5.0.3+20230105/google_domains1_beta1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -148,25 +148,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-domain You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-domains1_beta1/5.0.3+20230105/google_domains1_beta1/client::Delegate) to the -[Method Builder](https://docs.rs/google-domains1_beta1/5.0.3+20230105/google_domains1_beta1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-domains1_beta1/5.0.3+20230105/google_domains1_beta1/client::Delegate) to the +[Method Builder](https://docs.rs/google-domains1_beta1/5.0.3+20230105/google_domains1_beta1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-domains1_beta1/5.0.3+20230105/google_domains1_beta1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-domains1_beta1/5.0.3+20230105/google_domains1_beta1/client::RequestValue) and -[decodable](https://docs.rs/google-domains1_beta1/5.0.3+20230105/google_domains1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-domains1_beta1/5.0.3+20230105/google_domains1_beta1/client::RequestValue) and +[decodable](https://docs.rs/google-domains1_beta1/5.0.3+20230105/google_domains1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-domains1_beta1/5.0.3+20230105/google_domains1_beta1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-domains1_beta1/5.0.3+20230105/google_domains1_beta1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -185,7 +185,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **domains1_beta1** library was generated by Sebastian Thiel, and is placed +The **domains1_beta1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/domains1_beta1/src/api.rs b/gen/domains1_beta1/src/api.rs index 79ed1043dc..b209a3d26a 100644 --- a/gen/domains1_beta1/src/api.rs +++ b/gen/domains1_beta1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use domains1_beta1::{CloudDomains, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/domains1_beta1/src/lib.rs b/gen/domains1_beta1/src/lib.rs index e370eb607f..d48cc1d454 100644 --- a/gen/domains1_beta1/src/lib.rs +++ b/gen/domains1_beta1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/domains1_beta1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudDomains) ... +//! Handle the following *Resources* with ease from the central [hub](CloudDomains) ... //! //! * projects //! * [*locations get*](api::ProjectLocationGetCall), [*locations list*](api::ProjectLocationListCall), [*locations operations get*](api::ProjectLocationOperationGetCall), [*locations operations list*](api::ProjectLocationOperationListCall), [*locations registrations configure contact settings*](api::ProjectLocationRegistrationConfigureContactSettingCall), [*locations registrations configure dns settings*](api::ProjectLocationRegistrationConfigureDnsSettingCall), [*locations registrations configure management settings*](api::ProjectLocationRegistrationConfigureManagementSettingCall), [*locations registrations delete*](api::ProjectLocationRegistrationDeleteCall), [*locations registrations export*](api::ProjectLocationRegistrationExportCall), [*locations registrations get*](api::ProjectLocationRegistrationGetCall), [*locations registrations get iam policy*](api::ProjectLocationRegistrationGetIamPolicyCall), [*locations registrations import*](api::ProjectLocationRegistrationImportCall), [*locations registrations list*](api::ProjectLocationRegistrationListCall), [*locations registrations patch*](api::ProjectLocationRegistrationPatchCall), [*locations registrations register*](api::ProjectLocationRegistrationRegisterCall), [*locations registrations reset authorization code*](api::ProjectLocationRegistrationResetAuthorizationCodeCall), [*locations registrations retrieve authorization code*](api::ProjectLocationRegistrationRetrieveAuthorizationCodeCall), [*locations registrations retrieve importable domains*](api::ProjectLocationRegistrationRetrieveImportableDomainCall), [*locations registrations retrieve register parameters*](api::ProjectLocationRegistrationRetrieveRegisterParameterCall), [*locations registrations retrieve transfer parameters*](api::ProjectLocationRegistrationRetrieveTransferParameterCall), [*locations registrations search domains*](api::ProjectLocationRegistrationSearchDomainCall), [*locations registrations set iam policy*](api::ProjectLocationRegistrationSetIamPolicyCall), [*locations registrations test iam permissions*](api::ProjectLocationRegistrationTestIamPermissionCall) and [*locations registrations transfer*](api::ProjectLocationRegistrationTransferCall) @@ -59,8 +59,8 @@ //! let r = hub.projects().locations_registrations_transfer(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -89,12 +89,12 @@ //! use std::default::Default; //! use domains1_beta1::{CloudDomains, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -136,10 +136,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -149,25 +149,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/domainsrdap1/README.md b/gen/domainsrdap1/README.md index e88ca66de5..2b25886d30 100644 --- a/gen/domainsrdap1/README.md +++ b/gen/domainsrdap1/README.md @@ -11,7 +11,7 @@ Everything else about the *Domains RDAP* *v1* API can be found at the [official documentation site](https://developers.google.com/domains/rdap/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-domainsrdap1/5.0.3+20230124/google_domainsrdap1/DomainsRDAP) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-domainsrdap1/5.0.3+20230124/google_domainsrdap1/DomainsRDAP) ... * autnum * [*get*](https://docs.rs/google-domainsrdap1/5.0.3+20230124/google_domainsrdap1/api::AutnumGetCall) @@ -71,8 +71,8 @@ let r = hub.methods().get_entities(...).doit().await let r = hub.methods().get_nameservers(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -99,12 +99,12 @@ use domainsrdap1::{Result, Error}; use std::default::Default; use domainsrdap1::{DomainsRDAP, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -140,10 +140,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-domainsrdap1/5.0.3+20230124/google_domainsrdap1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-domainsrdap1/5.0.3+20230124/google_domainsrdap1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -153,25 +153,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-domain You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-domainsrdap1/5.0.3+20230124/google_domainsrdap1/client::Delegate) to the -[Method Builder](https://docs.rs/google-domainsrdap1/5.0.3+20230124/google_domainsrdap1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-domainsrdap1/5.0.3+20230124/google_domainsrdap1/client::Delegate) to the +[Method Builder](https://docs.rs/google-domainsrdap1/5.0.3+20230124/google_domainsrdap1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-domainsrdap1/5.0.3+20230124/google_domainsrdap1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-domainsrdap1/5.0.3+20230124/google_domainsrdap1/client::RequestValue) and -[decodable](https://docs.rs/google-domainsrdap1/5.0.3+20230124/google_domainsrdap1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-domainsrdap1/5.0.3+20230124/google_domainsrdap1/client::RequestValue) and +[decodable](https://docs.rs/google-domainsrdap1/5.0.3+20230124/google_domainsrdap1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-domainsrdap1/5.0.3+20230124/google_domainsrdap1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-domainsrdap1/5.0.3+20230124/google_domainsrdap1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -190,7 +190,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **domainsrdap1** library was generated by Sebastian Thiel, and is placed +The **domainsrdap1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/domainsrdap1/src/api.rs b/gen/domainsrdap1/src/api.rs index 43d553e350..890535cd18 100644 --- a/gen/domainsrdap1/src/api.rs +++ b/gen/domainsrdap1/src/api.rs @@ -42,12 +42,12 @@ use crate::{client, client::GetToken, client::serde_with}; /// use std::default::Default; /// use domainsrdap1::{DomainsRDAP, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/domainsrdap1/src/lib.rs b/gen/domainsrdap1/src/lib.rs index cf000085e0..65755f806c 100644 --- a/gen/domainsrdap1/src/lib.rs +++ b/gen/domainsrdap1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/domainsrdap1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](DomainsRDAP) ... +//! Handle the following *Resources* with ease from the central [hub](DomainsRDAP) ... //! //! * autnum //! * [*get*](api::AutnumGetCall) @@ -71,8 +71,8 @@ //! let r = hub.methods().get_nameservers(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -100,12 +100,12 @@ //! use std::default::Default; //! use domainsrdap1::{DomainsRDAP, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -141,10 +141,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -154,25 +154,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/doubleclickbidmanager1/README.md b/gen/doubleclickbidmanager1/README.md index d142de8d0e..8292dc463c 100644 --- a/gen/doubleclickbidmanager1/README.md +++ b/gen/doubleclickbidmanager1/README.md @@ -11,7 +11,7 @@ Everything else about the *DoubleClick Bid Manager* *v1* API can be found at the [official documentation site](https://developers.google.com/bid-manager/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-doubleclickbidmanager1/5.0.3+20210323/google_doubleclickbidmanager1/DoubleClickBidManager) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-doubleclickbidmanager1/5.0.3+20210323/google_doubleclickbidmanager1/DoubleClickBidManager) ... * lineitems * [*downloadlineitems*](https://docs.rs/google-doubleclickbidmanager1/5.0.3+20210323/google_doubleclickbidmanager1/api::LineitemDownloadlineitemCall) and [*uploadlineitems*](https://docs.rs/google-doubleclickbidmanager1/5.0.3+20210323/google_doubleclickbidmanager1/api::LineitemUploadlineitemCall) @@ -57,8 +57,8 @@ let r = hub.queries().createquery(...).doit().await let r = hub.queries().getquery(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -86,12 +86,12 @@ use doubleclickbidmanager1::{Result, Error}; use std::default::Default; use doubleclickbidmanager1::{DoubleClickBidManager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -132,10 +132,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-doubleclickbidmanager1/5.0.3+20210323/google_doubleclickbidmanager1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-doubleclickbidmanager1/5.0.3+20210323/google_doubleclickbidmanager1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -145,25 +145,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-double You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-doubleclickbidmanager1/5.0.3+20210323/google_doubleclickbidmanager1/client::Delegate) to the -[Method Builder](https://docs.rs/google-doubleclickbidmanager1/5.0.3+20210323/google_doubleclickbidmanager1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-doubleclickbidmanager1/5.0.3+20210323/google_doubleclickbidmanager1/client::Delegate) to the +[Method Builder](https://docs.rs/google-doubleclickbidmanager1/5.0.3+20210323/google_doubleclickbidmanager1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-doubleclickbidmanager1/5.0.3+20210323/google_doubleclickbidmanager1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-doubleclickbidmanager1/5.0.3+20210323/google_doubleclickbidmanager1/client::RequestValue) and -[decodable](https://docs.rs/google-doubleclickbidmanager1/5.0.3+20210323/google_doubleclickbidmanager1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-doubleclickbidmanager1/5.0.3+20210323/google_doubleclickbidmanager1/client::RequestValue) and +[decodable](https://docs.rs/google-doubleclickbidmanager1/5.0.3+20210323/google_doubleclickbidmanager1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-doubleclickbidmanager1/5.0.3+20210323/google_doubleclickbidmanager1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-doubleclickbidmanager1/5.0.3+20210323/google_doubleclickbidmanager1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -182,7 +182,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **doubleclickbidmanager1** library was generated by Sebastian Thiel, and is placed +The **doubleclickbidmanager1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/doubleclickbidmanager1/src/api.rs b/gen/doubleclickbidmanager1/src/api.rs index ed65afa25f..fd2d1e4aed 100644 --- a/gen/doubleclickbidmanager1/src/api.rs +++ b/gen/doubleclickbidmanager1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your reports in DoubleClick Bid Manager Full, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use doubleclickbidmanager1::{DoubleClickBidManager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/doubleclickbidmanager1/src/lib.rs b/gen/doubleclickbidmanager1/src/lib.rs index 7819440a85..7270d2c236 100644 --- a/gen/doubleclickbidmanager1/src/lib.rs +++ b/gen/doubleclickbidmanager1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/doubleclickbidmanager1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](DoubleClickBidManager) ... +//! Handle the following *Resources* with ease from the central [hub](DoubleClickBidManager) ... //! //! * lineitems //! * [*downloadlineitems*](api::LineitemDownloadlineitemCall) and [*uploadlineitems*](api::LineitemUploadlineitemCall) @@ -57,8 +57,8 @@ //! let r = hub.queries().getquery(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -87,12 +87,12 @@ //! use std::default::Default; //! use doubleclickbidmanager1::{DoubleClickBidManager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -133,10 +133,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -146,25 +146,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/doubleclickbidmanager1d1/README.md b/gen/doubleclickbidmanager1d1/README.md index 5a0591f5c4..374f945947 100644 --- a/gen/doubleclickbidmanager1d1/README.md +++ b/gen/doubleclickbidmanager1d1/README.md @@ -11,7 +11,7 @@ Everything else about the *DoubleClick Bid Manager* *v1d1* API can be found at t [official documentation site](https://developers.google.com/bid-manager/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-doubleclickbidmanager1d1/5.0.3+20230117/google_doubleclickbidmanager1d1/DoubleClickBidManager) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-doubleclickbidmanager1d1/5.0.3+20230117/google_doubleclickbidmanager1d1/DoubleClickBidManager) ... * [queries](https://docs.rs/google-doubleclickbidmanager1d1/5.0.3+20230117/google_doubleclickbidmanager1d1/api::Query) * [*createquery*](https://docs.rs/google-doubleclickbidmanager1d1/5.0.3+20230117/google_doubleclickbidmanager1d1/api::QueryCreatequeryCall), [*deletequery*](https://docs.rs/google-doubleclickbidmanager1d1/5.0.3+20230117/google_doubleclickbidmanager1d1/api::QueryDeletequeryCall), [*getquery*](https://docs.rs/google-doubleclickbidmanager1d1/5.0.3+20230117/google_doubleclickbidmanager1d1/api::QueryGetqueryCall), [*listqueries*](https://docs.rs/google-doubleclickbidmanager1d1/5.0.3+20230117/google_doubleclickbidmanager1d1/api::QueryListqueryCall) and [*runquery*](https://docs.rs/google-doubleclickbidmanager1d1/5.0.3+20230117/google_doubleclickbidmanager1d1/api::QueryRunqueryCall) @@ -53,8 +53,8 @@ let r = hub.queries().createquery(...).doit().await let r = hub.queries().getquery(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -82,12 +82,12 @@ use doubleclickbidmanager1d1::{Result, Error}; use std::default::Default; use doubleclickbidmanager1d1::{DoubleClickBidManager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -129,10 +129,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-doubleclickbidmanager1d1/5.0.3+20230117/google_doubleclickbidmanager1d1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-doubleclickbidmanager1d1/5.0.3+20230117/google_doubleclickbidmanager1d1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -142,25 +142,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-double You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-doubleclickbidmanager1d1/5.0.3+20230117/google_doubleclickbidmanager1d1/client::Delegate) to the -[Method Builder](https://docs.rs/google-doubleclickbidmanager1d1/5.0.3+20230117/google_doubleclickbidmanager1d1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-doubleclickbidmanager1d1/5.0.3+20230117/google_doubleclickbidmanager1d1/client::Delegate) to the +[Method Builder](https://docs.rs/google-doubleclickbidmanager1d1/5.0.3+20230117/google_doubleclickbidmanager1d1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-doubleclickbidmanager1d1/5.0.3+20230117/google_doubleclickbidmanager1d1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-doubleclickbidmanager1d1/5.0.3+20230117/google_doubleclickbidmanager1d1/client::RequestValue) and -[decodable](https://docs.rs/google-doubleclickbidmanager1d1/5.0.3+20230117/google_doubleclickbidmanager1d1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-doubleclickbidmanager1d1/5.0.3+20230117/google_doubleclickbidmanager1d1/client::RequestValue) and +[decodable](https://docs.rs/google-doubleclickbidmanager1d1/5.0.3+20230117/google_doubleclickbidmanager1d1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-doubleclickbidmanager1d1/5.0.3+20230117/google_doubleclickbidmanager1d1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-doubleclickbidmanager1d1/5.0.3+20230117/google_doubleclickbidmanager1d1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -179,7 +179,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **doubleclickbidmanager1d1** library was generated by Sebastian Thiel, and is placed +The **doubleclickbidmanager1d1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/doubleclickbidmanager1d1/src/api.rs b/gen/doubleclickbidmanager1d1/src/api.rs index 633b65f485..2ef04de074 100644 --- a/gen/doubleclickbidmanager1d1/src/api.rs +++ b/gen/doubleclickbidmanager1d1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your reports in DoubleClick Bid Manager Full, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use doubleclickbidmanager1d1::{DoubleClickBidManager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/doubleclickbidmanager1d1/src/lib.rs b/gen/doubleclickbidmanager1d1/src/lib.rs index 07bc173652..3230f20a1e 100644 --- a/gen/doubleclickbidmanager1d1/src/lib.rs +++ b/gen/doubleclickbidmanager1d1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/doubleclickbidmanager1d1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](DoubleClickBidManager) ... +//! Handle the following *Resources* with ease from the central [hub](DoubleClickBidManager) ... //! //! * [queries](api::Query) //! * [*createquery*](api::QueryCreatequeryCall), [*deletequery*](api::QueryDeletequeryCall), [*getquery*](api::QueryGetqueryCall), [*listqueries*](api::QueryListqueryCall) and [*runquery*](api::QueryRunqueryCall) @@ -53,8 +53,8 @@ //! let r = hub.queries().getquery(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -83,12 +83,12 @@ //! use std::default::Default; //! use doubleclickbidmanager1d1::{DoubleClickBidManager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -130,10 +130,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -143,25 +143,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/doubleclicksearch2/README.md b/gen/doubleclicksearch2/README.md index a52203fb6a..e267453132 100644 --- a/gen/doubleclicksearch2/README.md +++ b/gen/doubleclicksearch2/README.md @@ -11,7 +11,7 @@ Everything else about the *Doubleclicksearch* *v2* API can be found at the [official documentation site](https://developers.google.com/search-ads). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-doubleclicksearch2/5.0.3+20230118/google_doubleclicksearch2/Doubleclicksearch) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-doubleclicksearch2/5.0.3+20230118/google_doubleclicksearch2/Doubleclicksearch) ... * [conversion](https://docs.rs/google-doubleclicksearch2/5.0.3+20230118/google_doubleclicksearch2/api::Conversion) * [*get*](https://docs.rs/google-doubleclicksearch2/5.0.3+20230118/google_doubleclicksearch2/api::ConversionGetCall), [*get by customer id*](https://docs.rs/google-doubleclicksearch2/5.0.3+20230118/google_doubleclicksearch2/api::ConversionGetByCustomerIdCall), [*insert*](https://docs.rs/google-doubleclicksearch2/5.0.3+20230118/google_doubleclicksearch2/api::ConversionInsertCall), [*update*](https://docs.rs/google-doubleclicksearch2/5.0.3+20230118/google_doubleclicksearch2/api::ConversionUpdateCall) and [*update availability*](https://docs.rs/google-doubleclicksearch2/5.0.3+20230118/google_doubleclicksearch2/api::ConversionUpdateAvailabilityCall) @@ -63,8 +63,8 @@ let r = hub.reports().get_id_mapping_file(...).doit().await let r = hub.reports().request(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -91,12 +91,12 @@ use doubleclicksearch2::{Result, Error}; use std::default::Default; use doubleclicksearch2::{Doubleclicksearch, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -132,10 +132,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-doubleclicksearch2/5.0.3+20230118/google_doubleclicksearch2/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-doubleclicksearch2/5.0.3+20230118/google_doubleclicksearch2/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -145,25 +145,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-double You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-doubleclicksearch2/5.0.3+20230118/google_doubleclicksearch2/client::Delegate) to the -[Method Builder](https://docs.rs/google-doubleclicksearch2/5.0.3+20230118/google_doubleclicksearch2/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-doubleclicksearch2/5.0.3+20230118/google_doubleclicksearch2/client::Delegate) to the +[Method Builder](https://docs.rs/google-doubleclicksearch2/5.0.3+20230118/google_doubleclicksearch2/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-doubleclicksearch2/5.0.3+20230118/google_doubleclicksearch2/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-doubleclicksearch2/5.0.3+20230118/google_doubleclicksearch2/client::RequestValue) and -[decodable](https://docs.rs/google-doubleclicksearch2/5.0.3+20230118/google_doubleclicksearch2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-doubleclicksearch2/5.0.3+20230118/google_doubleclicksearch2/client::RequestValue) and +[decodable](https://docs.rs/google-doubleclicksearch2/5.0.3+20230118/google_doubleclicksearch2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-doubleclicksearch2/5.0.3+20230118/google_doubleclicksearch2/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-doubleclicksearch2/5.0.3+20230118/google_doubleclicksearch2/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -182,7 +182,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **doubleclicksearch2** library was generated by Sebastian Thiel, and is placed +The **doubleclicksearch2** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/doubleclicksearch2/src/api.rs b/gen/doubleclicksearch2/src/api.rs index 1bb436b9f8..9c0c5eefa8 100644 --- a/gen/doubleclicksearch2/src/api.rs +++ b/gen/doubleclicksearch2/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your advertising data in DoubleClick Search Full, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use doubleclicksearch2::{Doubleclicksearch, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/doubleclicksearch2/src/lib.rs b/gen/doubleclicksearch2/src/lib.rs index 3de3564b35..5f7ab94585 100644 --- a/gen/doubleclicksearch2/src/lib.rs +++ b/gen/doubleclicksearch2/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/doubleclicksearch2). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Doubleclicksearch) ... +//! Handle the following *Resources* with ease from the central [hub](Doubleclicksearch) ... //! //! * [conversion](api::Conversion) //! * [*get*](api::ConversionGetCall), [*get by customer id*](api::ConversionGetByCustomerIdCall), [*insert*](api::ConversionInsertCall), [*update*](api::ConversionUpdateCall) and [*update availability*](api::ConversionUpdateAvailabilityCall) @@ -63,8 +63,8 @@ //! let r = hub.reports().request(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -92,12 +92,12 @@ //! use std::default::Default; //! use doubleclicksearch2::{Doubleclicksearch, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -133,10 +133,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -146,25 +146,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/drive2/README.md b/gen/drive2/README.md index 9b99c2824e..4a46b3034e 100644 --- a/gen/drive2/README.md +++ b/gen/drive2/README.md @@ -11,7 +11,7 @@ Everything else about the *drive* *v2* API can be found at the [official documentation site](https://developers.google.com/drive/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-drive2/5.0.3+20230115/google_drive2/DriveHub) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-drive2/5.0.3+20230115/google_drive2/DriveHub) ... * [about](https://docs.rs/google-drive2/5.0.3+20230115/google_drive2/api::About) * [*get*](https://docs.rs/google-drive2/5.0.3+20230115/google_drive2/api::AboutGetCall) @@ -110,8 +110,8 @@ let r = hub.files().update(...).doit().await let r = hub.files().watch(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -139,12 +139,12 @@ use drive2::{Result, Error}; use std::default::Default; use drive2::{DriveHub, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -203,10 +203,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-drive2/5.0.3+20230115/google_drive2/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-drive2/5.0.3+20230115/google_drive2/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -216,25 +216,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-drive2 You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-drive2/5.0.3+20230115/google_drive2/client::Delegate) to the -[Method Builder](https://docs.rs/google-drive2/5.0.3+20230115/google_drive2/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-drive2/5.0.3+20230115/google_drive2/client::Delegate) to the +[Method Builder](https://docs.rs/google-drive2/5.0.3+20230115/google_drive2/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-drive2/5.0.3+20230115/google_drive2/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-drive2/5.0.3+20230115/google_drive2/client::RequestValue) and -[decodable](https://docs.rs/google-drive2/5.0.3+20230115/google_drive2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-drive2/5.0.3+20230115/google_drive2/client::RequestValue) and +[decodable](https://docs.rs/google-drive2/5.0.3+20230115/google_drive2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-drive2/5.0.3+20230115/google_drive2/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-drive2/5.0.3+20230115/google_drive2/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -253,7 +253,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **drive2** library was generated by Sebastian Thiel, and is placed +The **drive2** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/drive2/src/api.rs b/gen/drive2/src/api.rs index 8af8cc6d62..944d7ec4c9 100644 --- a/gen/drive2/src/api.rs +++ b/gen/drive2/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, create, and delete all of your Google Drive files Full, @@ -97,12 +97,12 @@ impl Default for Scope { /// use std::default::Default; /// use drive2::{DriveHub, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/drive2/src/lib.rs b/gen/drive2/src/lib.rs index 49fcde2874..4b563e1ef5 100644 --- a/gen/drive2/src/lib.rs +++ b/gen/drive2/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/drive2). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](DriveHub) ... +//! Handle the following *Resources* with ease from the central [hub](DriveHub) ... //! //! * [about](api::About) //! * [*get*](api::AboutGetCall) @@ -110,8 +110,8 @@ //! let r = hub.files().watch(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -140,12 +140,12 @@ //! use std::default::Default; //! use drive2::{DriveHub, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -204,10 +204,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -217,25 +217,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/drive3/README.md b/gen/drive3/README.md index 4cf82b0137..646674f65c 100644 --- a/gen/drive3/README.md +++ b/gen/drive3/README.md @@ -11,7 +11,7 @@ Everything else about the *drive* *v3* API can be found at the [official documentation site](https://developers.google.com/drive/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-drive3/5.0.3+20230115/google_drive3/DriveHub) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-drive3/5.0.3+20230115/google_drive3/DriveHub) ... * [about](https://docs.rs/google-drive3/5.0.3+20230115/google_drive3/api::About) * [*get*](https://docs.rs/google-drive3/5.0.3+20230115/google_drive3/api::AboutGetCall) @@ -99,8 +99,8 @@ let r = hub.files().update(...).doit().await let r = hub.files().watch(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -127,12 +127,12 @@ use drive3::{Result, Error}; use std::default::Default; use drive3::{DriveHub, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -183,10 +183,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-drive3/5.0.3+20230115/google_drive3/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-drive3/5.0.3+20230115/google_drive3/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -196,25 +196,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-drive3 You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-drive3/5.0.3+20230115/google_drive3/client::Delegate) to the -[Method Builder](https://docs.rs/google-drive3/5.0.3+20230115/google_drive3/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-drive3/5.0.3+20230115/google_drive3/client::Delegate) to the +[Method Builder](https://docs.rs/google-drive3/5.0.3+20230115/google_drive3/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-drive3/5.0.3+20230115/google_drive3/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-drive3/5.0.3+20230115/google_drive3/client::RequestValue) and -[decodable](https://docs.rs/google-drive3/5.0.3+20230115/google_drive3/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-drive3/5.0.3+20230115/google_drive3/client::RequestValue) and +[decodable](https://docs.rs/google-drive3/5.0.3+20230115/google_drive3/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-drive3/5.0.3+20230115/google_drive3/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-drive3/5.0.3+20230115/google_drive3/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -233,7 +233,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **drive3** library was generated by Sebastian Thiel, and is placed +The **drive3** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/drive3/src/api.rs b/gen/drive3/src/api.rs index c23d75e73d..32f7a11387 100644 --- a/gen/drive3/src/api.rs +++ b/gen/drive3/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, create, and delete all of your Google Drive files Full, @@ -92,12 +92,12 @@ impl Default for Scope { /// use std::default::Default; /// use drive3::{DriveHub, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/drive3/src/lib.rs b/gen/drive3/src/lib.rs index 2180565040..0110cad74f 100644 --- a/gen/drive3/src/lib.rs +++ b/gen/drive3/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/drive3). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](DriveHub) ... +//! Handle the following *Resources* with ease from the central [hub](DriveHub) ... //! //! * [about](api::About) //! * [*get*](api::AboutGetCall) @@ -99,8 +99,8 @@ //! let r = hub.files().watch(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -128,12 +128,12 @@ //! use std::default::Default; //! use drive3::{DriveHub, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -184,10 +184,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -197,25 +197,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/driveactivity2/README.md b/gen/driveactivity2/README.md index d26573c602..7d6c8120e6 100644 --- a/gen/driveactivity2/README.md +++ b/gen/driveactivity2/README.md @@ -11,7 +11,7 @@ Everything else about the *Drive Activity* *v2* API can be found at the [official documentation site](https://developers.google.com/drive/activity/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-driveactivity2/5.0.3+20230122/google_driveactivity2/DriveActivityHub) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-driveactivity2/5.0.3+20230122/google_driveactivity2/DriveActivityHub) ... * activity * [*query*](https://docs.rs/google-driveactivity2/5.0.3+20230122/google_driveactivity2/api::ActivityQueryCall) @@ -50,8 +50,8 @@ Or specifically ... let r = hub.activity().query(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -79,12 +79,12 @@ use driveactivity2::{Result, Error}; use std::default::Default; use driveactivity2::{DriveActivityHub, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -125,10 +125,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-driveactivity2/5.0.3+20230122/google_driveactivity2/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-driveactivity2/5.0.3+20230122/google_driveactivity2/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -138,25 +138,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-drivea You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-driveactivity2/5.0.3+20230122/google_driveactivity2/client::Delegate) to the -[Method Builder](https://docs.rs/google-driveactivity2/5.0.3+20230122/google_driveactivity2/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-driveactivity2/5.0.3+20230122/google_driveactivity2/client::Delegate) to the +[Method Builder](https://docs.rs/google-driveactivity2/5.0.3+20230122/google_driveactivity2/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-driveactivity2/5.0.3+20230122/google_driveactivity2/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-driveactivity2/5.0.3+20230122/google_driveactivity2/client::RequestValue) and -[decodable](https://docs.rs/google-driveactivity2/5.0.3+20230122/google_driveactivity2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-driveactivity2/5.0.3+20230122/google_driveactivity2/client::RequestValue) and +[decodable](https://docs.rs/google-driveactivity2/5.0.3+20230122/google_driveactivity2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-driveactivity2/5.0.3+20230122/google_driveactivity2/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-driveactivity2/5.0.3+20230122/google_driveactivity2/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -175,7 +175,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **driveactivity2** library was generated by Sebastian Thiel, and is placed +The **driveactivity2** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/driveactivity2/src/api.rs b/gen/driveactivity2/src/api.rs index be2ca592b0..9f6fbab65f 100644 --- a/gen/driveactivity2/src/api.rs +++ b/gen/driveactivity2/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and add to the activity record of files in your Google Drive DriveActivity, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use driveactivity2::{DriveActivityHub, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/driveactivity2/src/lib.rs b/gen/driveactivity2/src/lib.rs index 3422193178..1c42a228fc 100644 --- a/gen/driveactivity2/src/lib.rs +++ b/gen/driveactivity2/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/driveactivity2). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](DriveActivityHub) ... +//! Handle the following *Resources* with ease from the central [hub](DriveActivityHub) ... //! //! * activity //! * [*query*](api::ActivityQueryCall) @@ -50,8 +50,8 @@ //! let r = hub.activity().query(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -80,12 +80,12 @@ //! use std::default::Default; //! use driveactivity2::{DriveActivityHub, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -126,10 +126,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -139,25 +139,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/essentialcontacts1/README.md b/gen/essentialcontacts1/README.md index eb3c2fe517..ae728a6571 100644 --- a/gen/essentialcontacts1/README.md +++ b/gen/essentialcontacts1/README.md @@ -11,7 +11,7 @@ Everything else about the *Essentialcontacts* *v1* API can be found at the [official documentation site](https://cloud.google.com/essentialcontacts/docs/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-essentialcontacts1/5.0.3+20230123/google_essentialcontacts1/Essentialcontacts) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-essentialcontacts1/5.0.3+20230123/google_essentialcontacts1/Essentialcontacts) ... * folders * [*contacts compute*](https://docs.rs/google-essentialcontacts1/5.0.3+20230123/google_essentialcontacts1/api::FolderContactComputeCall), [*contacts create*](https://docs.rs/google-essentialcontacts1/5.0.3+20230123/google_essentialcontacts1/api::FolderContactCreateCall), [*contacts delete*](https://docs.rs/google-essentialcontacts1/5.0.3+20230123/google_essentialcontacts1/api::FolderContactDeleteCall), [*contacts get*](https://docs.rs/google-essentialcontacts1/5.0.3+20230123/google_essentialcontacts1/api::FolderContactGetCall), [*contacts list*](https://docs.rs/google-essentialcontacts1/5.0.3+20230123/google_essentialcontacts1/api::FolderContactListCall), [*contacts patch*](https://docs.rs/google-essentialcontacts1/5.0.3+20230123/google_essentialcontacts1/api::FolderContactPatchCall) and [*contacts send test message*](https://docs.rs/google-essentialcontacts1/5.0.3+20230123/google_essentialcontacts1/api::FolderContactSendTestMessageCall) @@ -62,8 +62,8 @@ let r = hub.projects().contacts_get(...).doit().await let r = hub.projects().contacts_patch(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -91,12 +91,12 @@ use essentialcontacts1::{Result, Error}; use std::default::Default; use essentialcontacts1::{Essentialcontacts, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -138,10 +138,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-essentialcontacts1/5.0.3+20230123/google_essentialcontacts1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-essentialcontacts1/5.0.3+20230123/google_essentialcontacts1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -151,25 +151,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-essent You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-essentialcontacts1/5.0.3+20230123/google_essentialcontacts1/client::Delegate) to the -[Method Builder](https://docs.rs/google-essentialcontacts1/5.0.3+20230123/google_essentialcontacts1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-essentialcontacts1/5.0.3+20230123/google_essentialcontacts1/client::Delegate) to the +[Method Builder](https://docs.rs/google-essentialcontacts1/5.0.3+20230123/google_essentialcontacts1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-essentialcontacts1/5.0.3+20230123/google_essentialcontacts1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-essentialcontacts1/5.0.3+20230123/google_essentialcontacts1/client::RequestValue) and -[decodable](https://docs.rs/google-essentialcontacts1/5.0.3+20230123/google_essentialcontacts1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-essentialcontacts1/5.0.3+20230123/google_essentialcontacts1/client::RequestValue) and +[decodable](https://docs.rs/google-essentialcontacts1/5.0.3+20230123/google_essentialcontacts1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-essentialcontacts1/5.0.3+20230123/google_essentialcontacts1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-essentialcontacts1/5.0.3+20230123/google_essentialcontacts1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -188,7 +188,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **essentialcontacts1** library was generated by Sebastian Thiel, and is placed +The **essentialcontacts1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/essentialcontacts1/src/api.rs b/gen/essentialcontacts1/src/api.rs index 0c7c43b432..73671c8c79 100644 --- a/gen/essentialcontacts1/src/api.rs +++ b/gen/essentialcontacts1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use essentialcontacts1::{Essentialcontacts, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/essentialcontacts1/src/lib.rs b/gen/essentialcontacts1/src/lib.rs index 409cd88b89..05a8a843e8 100644 --- a/gen/essentialcontacts1/src/lib.rs +++ b/gen/essentialcontacts1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/essentialcontacts1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Essentialcontacts) ... +//! Handle the following *Resources* with ease from the central [hub](Essentialcontacts) ... //! //! * folders //! * [*contacts compute*](api::FolderContactComputeCall), [*contacts create*](api::FolderContactCreateCall), [*contacts delete*](api::FolderContactDeleteCall), [*contacts get*](api::FolderContactGetCall), [*contacts list*](api::FolderContactListCall), [*contacts patch*](api::FolderContactPatchCall) and [*contacts send test message*](api::FolderContactSendTestMessageCall) @@ -62,8 +62,8 @@ //! let r = hub.projects().contacts_patch(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -92,12 +92,12 @@ //! use std::default::Default; //! use essentialcontacts1::{Essentialcontacts, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -139,10 +139,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -152,25 +152,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/eventarc1/README.md b/gen/eventarc1/README.md index a00c0349b4..bf57721d8b 100644 --- a/gen/eventarc1/README.md +++ b/gen/eventarc1/README.md @@ -11,7 +11,7 @@ Everything else about the *Eventarc* *v1* API can be found at the [official documentation site](https://cloud.google.com/eventarc). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/Eventarc) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/Eventarc) ... * projects * [*locations channel connections create*](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/api::ProjectLocationChannelConnectionCreateCall), [*locations channel connections delete*](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/api::ProjectLocationChannelConnectionDeleteCall), [*locations channel connections get*](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/api::ProjectLocationChannelConnectionGetCall), [*locations channel connections get iam policy*](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/api::ProjectLocationChannelConnectionGetIamPolicyCall), [*locations channel connections list*](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/api::ProjectLocationChannelConnectionListCall), [*locations channel connections set iam policy*](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/api::ProjectLocationChannelConnectionSetIamPolicyCall), [*locations channel connections test iam permissions*](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/api::ProjectLocationChannelConnectionTestIamPermissionCall), [*locations channels create*](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/api::ProjectLocationChannelCreateCall), [*locations channels delete*](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/api::ProjectLocationChannelDeleteCall), [*locations channels get*](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/api::ProjectLocationChannelGetCall), [*locations channels get iam policy*](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/api::ProjectLocationChannelGetIamPolicyCall), [*locations channels list*](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/api::ProjectLocationChannelListCall), [*locations channels patch*](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/api::ProjectLocationChannelPatchCall), [*locations channels set iam policy*](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/api::ProjectLocationChannelSetIamPolicyCall), [*locations channels test iam permissions*](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/api::ProjectLocationChannelTestIamPermissionCall), [*locations get*](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/api::ProjectLocationGetCall), [*locations get google channel config*](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/api::ProjectLocationGetGoogleChannelConfigCall), [*locations list*](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/api::ProjectLocationListCall), [*locations operations cancel*](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/api::ProjectLocationOperationCancelCall), [*locations operations delete*](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/api::ProjectLocationOperationDeleteCall), [*locations operations get*](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/api::ProjectLocationOperationGetCall), [*locations operations list*](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/api::ProjectLocationOperationListCall), [*locations providers get*](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/api::ProjectLocationProviderGetCall), [*locations providers list*](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/api::ProjectLocationProviderListCall), [*locations triggers create*](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/api::ProjectLocationTriggerCreateCall), [*locations triggers delete*](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/api::ProjectLocationTriggerDeleteCall), [*locations triggers get*](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/api::ProjectLocationTriggerGetCall), [*locations triggers get iam policy*](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/api::ProjectLocationTriggerGetIamPolicyCall), [*locations triggers list*](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/api::ProjectLocationTriggerListCall), [*locations triggers patch*](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/api::ProjectLocationTriggerPatchCall), [*locations triggers set iam policy*](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/api::ProjectLocationTriggerSetIamPolicyCall), [*locations triggers test iam permissions*](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/api::ProjectLocationTriggerTestIamPermissionCall) and [*locations update google channel config*](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/api::ProjectLocationUpdateGoogleChannelConfigCall) @@ -58,8 +58,8 @@ let r = hub.projects().locations_triggers_delete(...).doit().await let r = hub.projects().locations_triggers_patch(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -87,12 +87,12 @@ use eventarc1::{Result, Error}; use std::default::Default; use eventarc1::{Eventarc, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -136,10 +136,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -149,25 +149,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-eventa You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/client::Delegate) to the -[Method Builder](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/client::Delegate) to the +[Method Builder](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/client::RequestValue) and -[decodable](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/client::RequestValue) and +[decodable](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-eventarc1/5.0.3+20230113/google_eventarc1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -186,7 +186,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **eventarc1** library was generated by Sebastian Thiel, and is placed +The **eventarc1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/eventarc1/src/api.rs b/gen/eventarc1/src/api.rs index b091f24fa6..74b096bc31 100644 --- a/gen/eventarc1/src/api.rs +++ b/gen/eventarc1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use eventarc1::{Eventarc, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/eventarc1/src/lib.rs b/gen/eventarc1/src/lib.rs index cac1cc3342..29607a245c 100644 --- a/gen/eventarc1/src/lib.rs +++ b/gen/eventarc1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/eventarc1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Eventarc) ... +//! Handle the following *Resources* with ease from the central [hub](Eventarc) ... //! //! * projects //! * [*locations channel connections create*](api::ProjectLocationChannelConnectionCreateCall), [*locations channel connections delete*](api::ProjectLocationChannelConnectionDeleteCall), [*locations channel connections get*](api::ProjectLocationChannelConnectionGetCall), [*locations channel connections get iam policy*](api::ProjectLocationChannelConnectionGetIamPolicyCall), [*locations channel connections list*](api::ProjectLocationChannelConnectionListCall), [*locations channel connections set iam policy*](api::ProjectLocationChannelConnectionSetIamPolicyCall), [*locations channel connections test iam permissions*](api::ProjectLocationChannelConnectionTestIamPermissionCall), [*locations channels create*](api::ProjectLocationChannelCreateCall), [*locations channels delete*](api::ProjectLocationChannelDeleteCall), [*locations channels get*](api::ProjectLocationChannelGetCall), [*locations channels get iam policy*](api::ProjectLocationChannelGetIamPolicyCall), [*locations channels list*](api::ProjectLocationChannelListCall), [*locations channels patch*](api::ProjectLocationChannelPatchCall), [*locations channels set iam policy*](api::ProjectLocationChannelSetIamPolicyCall), [*locations channels test iam permissions*](api::ProjectLocationChannelTestIamPermissionCall), [*locations get*](api::ProjectLocationGetCall), [*locations get google channel config*](api::ProjectLocationGetGoogleChannelConfigCall), [*locations list*](api::ProjectLocationListCall), [*locations operations cancel*](api::ProjectLocationOperationCancelCall), [*locations operations delete*](api::ProjectLocationOperationDeleteCall), [*locations operations get*](api::ProjectLocationOperationGetCall), [*locations operations list*](api::ProjectLocationOperationListCall), [*locations providers get*](api::ProjectLocationProviderGetCall), [*locations providers list*](api::ProjectLocationProviderListCall), [*locations triggers create*](api::ProjectLocationTriggerCreateCall), [*locations triggers delete*](api::ProjectLocationTriggerDeleteCall), [*locations triggers get*](api::ProjectLocationTriggerGetCall), [*locations triggers get iam policy*](api::ProjectLocationTriggerGetIamPolicyCall), [*locations triggers list*](api::ProjectLocationTriggerListCall), [*locations triggers patch*](api::ProjectLocationTriggerPatchCall), [*locations triggers set iam policy*](api::ProjectLocationTriggerSetIamPolicyCall), [*locations triggers test iam permissions*](api::ProjectLocationTriggerTestIamPermissionCall) and [*locations update google channel config*](api::ProjectLocationUpdateGoogleChannelConfigCall) @@ -58,8 +58,8 @@ //! let r = hub.projects().locations_triggers_patch(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -88,12 +88,12 @@ //! use std::default::Default; //! use eventarc1::{Eventarc, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -137,10 +137,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -150,25 +150,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/factchecktools1_alpha1/README.md b/gen/factchecktools1_alpha1/README.md index be988ae4cf..4ee9ef0a8c 100644 --- a/gen/factchecktools1_alpha1/README.md +++ b/gen/factchecktools1_alpha1/README.md @@ -11,7 +11,7 @@ Everything else about the *Fact Check Tools* *v1_alpha1* API can be found at the [official documentation site](https://developers.google.com/fact-check/tools/api/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-factchecktools1_alpha1/5.0.3+20230121/google_factchecktools1_alpha1/FactCheckTools) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-factchecktools1_alpha1/5.0.3+20230121/google_factchecktools1_alpha1/FactCheckTools) ... * claims * [*search*](https://docs.rs/google-factchecktools1_alpha1/5.0.3+20230121/google_factchecktools1_alpha1/api::ClaimSearchCall) @@ -54,8 +54,8 @@ let r = hub.pages().get(...).doit().await let r = hub.pages().update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -83,12 +83,12 @@ use factchecktools1_alpha1::{Result, Error}; use std::default::Default; use factchecktools1_alpha1::{FactCheckTools, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -129,10 +129,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-factchecktools1_alpha1/5.0.3+20230121/google_factchecktools1_alpha1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-factchecktools1_alpha1/5.0.3+20230121/google_factchecktools1_alpha1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -142,25 +142,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-factch You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-factchecktools1_alpha1/5.0.3+20230121/google_factchecktools1_alpha1/client::Delegate) to the -[Method Builder](https://docs.rs/google-factchecktools1_alpha1/5.0.3+20230121/google_factchecktools1_alpha1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-factchecktools1_alpha1/5.0.3+20230121/google_factchecktools1_alpha1/client::Delegate) to the +[Method Builder](https://docs.rs/google-factchecktools1_alpha1/5.0.3+20230121/google_factchecktools1_alpha1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-factchecktools1_alpha1/5.0.3+20230121/google_factchecktools1_alpha1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-factchecktools1_alpha1/5.0.3+20230121/google_factchecktools1_alpha1/client::RequestValue) and -[decodable](https://docs.rs/google-factchecktools1_alpha1/5.0.3+20230121/google_factchecktools1_alpha1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-factchecktools1_alpha1/5.0.3+20230121/google_factchecktools1_alpha1/client::RequestValue) and +[decodable](https://docs.rs/google-factchecktools1_alpha1/5.0.3+20230121/google_factchecktools1_alpha1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-factchecktools1_alpha1/5.0.3+20230121/google_factchecktools1_alpha1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-factchecktools1_alpha1/5.0.3+20230121/google_factchecktools1_alpha1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -179,7 +179,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **factchecktools1_alpha1** library was generated by Sebastian Thiel, and is placed +The **factchecktools1_alpha1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/factchecktools1_alpha1/src/api.rs b/gen/factchecktools1_alpha1/src/api.rs index d281160cf8..100083cae2 100644 --- a/gen/factchecktools1_alpha1/src/api.rs +++ b/gen/factchecktools1_alpha1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See your primary Google Account email address UserinfoEmail, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use factchecktools1_alpha1::{FactCheckTools, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/factchecktools1_alpha1/src/lib.rs b/gen/factchecktools1_alpha1/src/lib.rs index edf93476aa..2058ccddb0 100644 --- a/gen/factchecktools1_alpha1/src/lib.rs +++ b/gen/factchecktools1_alpha1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/factchecktools1_alpha1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](FactCheckTools) ... +//! Handle the following *Resources* with ease from the central [hub](FactCheckTools) ... //! //! * claims //! * [*search*](api::ClaimSearchCall) @@ -54,8 +54,8 @@ //! let r = hub.pages().update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -84,12 +84,12 @@ //! use std::default::Default; //! use factchecktools1_alpha1::{FactCheckTools, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -130,10 +130,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -143,25 +143,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/fcm1/README.md b/gen/fcm1/README.md index e35d8612bb..38a604079b 100644 --- a/gen/fcm1/README.md +++ b/gen/fcm1/README.md @@ -11,7 +11,7 @@ Everything else about the *Firebase Cloud Messaging* *v1* API can be found at th [official documentation site](https://firebase.google.com/docs/cloud-messaging). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-fcm1/5.0.3+20230106/google_fcm1/FirebaseCloudMessaging) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-fcm1/5.0.3+20230106/google_fcm1/FirebaseCloudMessaging) ... * projects * [*messages send*](https://docs.rs/google-fcm1/5.0.3+20230106/google_fcm1/api::ProjectMessageSendCall) @@ -50,8 +50,8 @@ Or specifically ... let r = hub.projects().messages_send(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -79,12 +79,12 @@ use fcm1::{Result, Error}; use std::default::Default; use fcm1::{FirebaseCloudMessaging, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -125,10 +125,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-fcm1/5.0.3+20230106/google_fcm1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-fcm1/5.0.3+20230106/google_fcm1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -138,25 +138,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-fcm1/5 You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-fcm1/5.0.3+20230106/google_fcm1/client::Delegate) to the -[Method Builder](https://docs.rs/google-fcm1/5.0.3+20230106/google_fcm1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-fcm1/5.0.3+20230106/google_fcm1/client::Delegate) to the +[Method Builder](https://docs.rs/google-fcm1/5.0.3+20230106/google_fcm1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-fcm1/5.0.3+20230106/google_fcm1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-fcm1/5.0.3+20230106/google_fcm1/client::RequestValue) and -[decodable](https://docs.rs/google-fcm1/5.0.3+20230106/google_fcm1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-fcm1/5.0.3+20230106/google_fcm1/client::RequestValue) and +[decodable](https://docs.rs/google-fcm1/5.0.3+20230106/google_fcm1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-fcm1/5.0.3+20230106/google_fcm1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-fcm1/5.0.3+20230106/google_fcm1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -175,7 +175,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **fcm1** library was generated by Sebastian Thiel, and is placed +The **fcm1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/fcm1/src/api.rs b/gen/fcm1/src/api.rs index 23125dbcbb..1870ba0175 100644 --- a/gen/fcm1/src/api.rs +++ b/gen/fcm1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use fcm1::{FirebaseCloudMessaging, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/fcm1/src/lib.rs b/gen/fcm1/src/lib.rs index 32d4f52fb7..0daa58b5bb 100644 --- a/gen/fcm1/src/lib.rs +++ b/gen/fcm1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/fcm1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](FirebaseCloudMessaging) ... +//! Handle the following *Resources* with ease from the central [hub](FirebaseCloudMessaging) ... //! //! * projects //! * [*messages send*](api::ProjectMessageSendCall) @@ -50,8 +50,8 @@ //! let r = hub.projects().messages_send(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -80,12 +80,12 @@ //! use std::default::Default; //! use fcm1::{FirebaseCloudMessaging, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -126,10 +126,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -139,25 +139,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/fcmdata1_beta1/README.md b/gen/fcmdata1_beta1/README.md index ee2ac51511..8ea75b8ade 100644 --- a/gen/fcmdata1_beta1/README.md +++ b/gen/fcmdata1_beta1/README.md @@ -11,7 +11,7 @@ Everything else about the *Fcmdata* *v1_beta1* API can be found at the [official documentation site](https://firebase.google.com/docs/cloud-messaging). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-fcmdata1_beta1/5.0.3+20230123/google_fcmdata1_beta1/Fcmdata) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-fcmdata1_beta1/5.0.3+20230123/google_fcmdata1_beta1/Fcmdata) ... * projects * [*android apps delivery data list*](https://docs.rs/google-fcmdata1_beta1/5.0.3+20230123/google_fcmdata1_beta1/api::ProjectAndroidAppDeliveryDataListCall) @@ -50,8 +50,8 @@ Or specifically ... let r = hub.projects().android_apps_delivery_data_list(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -78,12 +78,12 @@ use fcmdata1_beta1::{Result, Error}; use std::default::Default; use fcmdata1_beta1::{Fcmdata, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -121,10 +121,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-fcmdata1_beta1/5.0.3+20230123/google_fcmdata1_beta1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-fcmdata1_beta1/5.0.3+20230123/google_fcmdata1_beta1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -134,25 +134,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-fcmdat You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-fcmdata1_beta1/5.0.3+20230123/google_fcmdata1_beta1/client::Delegate) to the -[Method Builder](https://docs.rs/google-fcmdata1_beta1/5.0.3+20230123/google_fcmdata1_beta1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-fcmdata1_beta1/5.0.3+20230123/google_fcmdata1_beta1/client::Delegate) to the +[Method Builder](https://docs.rs/google-fcmdata1_beta1/5.0.3+20230123/google_fcmdata1_beta1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-fcmdata1_beta1/5.0.3+20230123/google_fcmdata1_beta1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-fcmdata1_beta1/5.0.3+20230123/google_fcmdata1_beta1/client::RequestValue) and -[decodable](https://docs.rs/google-fcmdata1_beta1/5.0.3+20230123/google_fcmdata1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-fcmdata1_beta1/5.0.3+20230123/google_fcmdata1_beta1/client::RequestValue) and +[decodable](https://docs.rs/google-fcmdata1_beta1/5.0.3+20230123/google_fcmdata1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-fcmdata1_beta1/5.0.3+20230123/google_fcmdata1_beta1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-fcmdata1_beta1/5.0.3+20230123/google_fcmdata1_beta1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -171,7 +171,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **fcmdata1_beta1** library was generated by Sebastian Thiel, and is placed +The **fcmdata1_beta1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/fcmdata1_beta1/src/api.rs b/gen/fcmdata1_beta1/src/api.rs index 07e575045a..b0eceaca5e 100644 --- a/gen/fcmdata1_beta1/src/api.rs +++ b/gen/fcmdata1_beta1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use fcmdata1_beta1::{Fcmdata, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/fcmdata1_beta1/src/lib.rs b/gen/fcmdata1_beta1/src/lib.rs index 58d45bec81..5dde9437cd 100644 --- a/gen/fcmdata1_beta1/src/lib.rs +++ b/gen/fcmdata1_beta1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/fcmdata1_beta1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Fcmdata) ... +//! Handle the following *Resources* with ease from the central [hub](Fcmdata) ... //! //! * projects //! * [*android apps delivery data list*](api::ProjectAndroidAppDeliveryDataListCall) @@ -50,8 +50,8 @@ //! let r = hub.projects().android_apps_delivery_data_list(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -79,12 +79,12 @@ //! use std::default::Default; //! use fcmdata1_beta1::{Fcmdata, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -122,10 +122,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -135,25 +135,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/file1/README.md b/gen/file1/README.md index e944d6569a..e5384aaa2f 100644 --- a/gen/file1/README.md +++ b/gen/file1/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Filestore* *v1* API can be found at the [official documentation site](https://cloud.google.com/filestore/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-file1/5.0.3+20230103/google_file1/CloudFilestore) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-file1/5.0.3+20230103/google_file1/CloudFilestore) ... * projects * [*locations backups create*](https://docs.rs/google-file1/5.0.3+20230103/google_file1/api::ProjectLocationBackupCreateCall), [*locations backups delete*](https://docs.rs/google-file1/5.0.3+20230103/google_file1/api::ProjectLocationBackupDeleteCall), [*locations backups get*](https://docs.rs/google-file1/5.0.3+20230103/google_file1/api::ProjectLocationBackupGetCall), [*locations backups list*](https://docs.rs/google-file1/5.0.3+20230103/google_file1/api::ProjectLocationBackupListCall), [*locations backups patch*](https://docs.rs/google-file1/5.0.3+20230103/google_file1/api::ProjectLocationBackupPatchCall), [*locations get*](https://docs.rs/google-file1/5.0.3+20230103/google_file1/api::ProjectLocationGetCall), [*locations instances create*](https://docs.rs/google-file1/5.0.3+20230103/google_file1/api::ProjectLocationInstanceCreateCall), [*locations instances delete*](https://docs.rs/google-file1/5.0.3+20230103/google_file1/api::ProjectLocationInstanceDeleteCall), [*locations instances get*](https://docs.rs/google-file1/5.0.3+20230103/google_file1/api::ProjectLocationInstanceGetCall), [*locations instances list*](https://docs.rs/google-file1/5.0.3+20230103/google_file1/api::ProjectLocationInstanceListCall), [*locations instances patch*](https://docs.rs/google-file1/5.0.3+20230103/google_file1/api::ProjectLocationInstancePatchCall), [*locations instances restore*](https://docs.rs/google-file1/5.0.3+20230103/google_file1/api::ProjectLocationInstanceRestoreCall), [*locations instances snapshots create*](https://docs.rs/google-file1/5.0.3+20230103/google_file1/api::ProjectLocationInstanceSnapshotCreateCall), [*locations instances snapshots delete*](https://docs.rs/google-file1/5.0.3+20230103/google_file1/api::ProjectLocationInstanceSnapshotDeleteCall), [*locations instances snapshots get*](https://docs.rs/google-file1/5.0.3+20230103/google_file1/api::ProjectLocationInstanceSnapshotGetCall), [*locations instances snapshots list*](https://docs.rs/google-file1/5.0.3+20230103/google_file1/api::ProjectLocationInstanceSnapshotListCall), [*locations instances snapshots patch*](https://docs.rs/google-file1/5.0.3+20230103/google_file1/api::ProjectLocationInstanceSnapshotPatchCall), [*locations list*](https://docs.rs/google-file1/5.0.3+20230103/google_file1/api::ProjectLocationListCall), [*locations operations cancel*](https://docs.rs/google-file1/5.0.3+20230103/google_file1/api::ProjectLocationOperationCancelCall), [*locations operations delete*](https://docs.rs/google-file1/5.0.3+20230103/google_file1/api::ProjectLocationOperationDeleteCall), [*locations operations get*](https://docs.rs/google-file1/5.0.3+20230103/google_file1/api::ProjectLocationOperationGetCall) and [*locations operations list*](https://docs.rs/google-file1/5.0.3+20230103/google_file1/api::ProjectLocationOperationListCall) @@ -60,8 +60,8 @@ let r = hub.projects().locations_instances_restore(...).doit().await let r = hub.projects().locations_operations_get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -89,12 +89,12 @@ use file1::{Result, Error}; use std::default::Default; use file1::{CloudFilestore, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -136,10 +136,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-file1/5.0.3+20230103/google_file1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-file1/5.0.3+20230103/google_file1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -149,25 +149,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-file1/ You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-file1/5.0.3+20230103/google_file1/client::Delegate) to the -[Method Builder](https://docs.rs/google-file1/5.0.3+20230103/google_file1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-file1/5.0.3+20230103/google_file1/client::Delegate) to the +[Method Builder](https://docs.rs/google-file1/5.0.3+20230103/google_file1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-file1/5.0.3+20230103/google_file1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-file1/5.0.3+20230103/google_file1/client::RequestValue) and -[decodable](https://docs.rs/google-file1/5.0.3+20230103/google_file1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-file1/5.0.3+20230103/google_file1/client::RequestValue) and +[decodable](https://docs.rs/google-file1/5.0.3+20230103/google_file1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-file1/5.0.3+20230103/google_file1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-file1/5.0.3+20230103/google_file1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -186,7 +186,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **file1** library was generated by Sebastian Thiel, and is placed +The **file1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/file1/src/api.rs b/gen/file1/src/api.rs index ed4ba9a9ca..5e68284f67 100644 --- a/gen/file1/src/api.rs +++ b/gen/file1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use file1::{CloudFilestore, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/file1/src/lib.rs b/gen/file1/src/lib.rs index 3553ca06c0..101e77c0bc 100644 --- a/gen/file1/src/lib.rs +++ b/gen/file1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/file1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudFilestore) ... +//! Handle the following *Resources* with ease from the central [hub](CloudFilestore) ... //! //! * projects //! * [*locations backups create*](api::ProjectLocationBackupCreateCall), [*locations backups delete*](api::ProjectLocationBackupDeleteCall), [*locations backups get*](api::ProjectLocationBackupGetCall), [*locations backups list*](api::ProjectLocationBackupListCall), [*locations backups patch*](api::ProjectLocationBackupPatchCall), [*locations get*](api::ProjectLocationGetCall), [*locations instances create*](api::ProjectLocationInstanceCreateCall), [*locations instances delete*](api::ProjectLocationInstanceDeleteCall), [*locations instances get*](api::ProjectLocationInstanceGetCall), [*locations instances list*](api::ProjectLocationInstanceListCall), [*locations instances patch*](api::ProjectLocationInstancePatchCall), [*locations instances restore*](api::ProjectLocationInstanceRestoreCall), [*locations instances snapshots create*](api::ProjectLocationInstanceSnapshotCreateCall), [*locations instances snapshots delete*](api::ProjectLocationInstanceSnapshotDeleteCall), [*locations instances snapshots get*](api::ProjectLocationInstanceSnapshotGetCall), [*locations instances snapshots list*](api::ProjectLocationInstanceSnapshotListCall), [*locations instances snapshots patch*](api::ProjectLocationInstanceSnapshotPatchCall), [*locations list*](api::ProjectLocationListCall), [*locations operations cancel*](api::ProjectLocationOperationCancelCall), [*locations operations delete*](api::ProjectLocationOperationDeleteCall), [*locations operations get*](api::ProjectLocationOperationGetCall) and [*locations operations list*](api::ProjectLocationOperationListCall) @@ -60,8 +60,8 @@ //! let r = hub.projects().locations_operations_get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -90,12 +90,12 @@ //! use std::default::Default; //! use file1::{CloudFilestore, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -137,10 +137,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -150,25 +150,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/file1_beta1/README.md b/gen/file1_beta1/README.md index e6d1472b83..4563c2b883 100644 --- a/gen/file1_beta1/README.md +++ b/gen/file1_beta1/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Filestore* *v1_beta1* API can be found at the [official documentation site](https://cloud.google.com/filestore/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-file1_beta1/5.0.3+20230103/google_file1_beta1/CloudFilestore) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-file1_beta1/5.0.3+20230103/google_file1_beta1/CloudFilestore) ... * projects * [*locations backups create*](https://docs.rs/google-file1_beta1/5.0.3+20230103/google_file1_beta1/api::ProjectLocationBackupCreateCall), [*locations backups delete*](https://docs.rs/google-file1_beta1/5.0.3+20230103/google_file1_beta1/api::ProjectLocationBackupDeleteCall), [*locations backups get*](https://docs.rs/google-file1_beta1/5.0.3+20230103/google_file1_beta1/api::ProjectLocationBackupGetCall), [*locations backups list*](https://docs.rs/google-file1_beta1/5.0.3+20230103/google_file1_beta1/api::ProjectLocationBackupListCall), [*locations backups patch*](https://docs.rs/google-file1_beta1/5.0.3+20230103/google_file1_beta1/api::ProjectLocationBackupPatchCall), [*locations get*](https://docs.rs/google-file1_beta1/5.0.3+20230103/google_file1_beta1/api::ProjectLocationGetCall), [*locations instances create*](https://docs.rs/google-file1_beta1/5.0.3+20230103/google_file1_beta1/api::ProjectLocationInstanceCreateCall), [*locations instances delete*](https://docs.rs/google-file1_beta1/5.0.3+20230103/google_file1_beta1/api::ProjectLocationInstanceDeleteCall), [*locations instances get*](https://docs.rs/google-file1_beta1/5.0.3+20230103/google_file1_beta1/api::ProjectLocationInstanceGetCall), [*locations instances list*](https://docs.rs/google-file1_beta1/5.0.3+20230103/google_file1_beta1/api::ProjectLocationInstanceListCall), [*locations instances patch*](https://docs.rs/google-file1_beta1/5.0.3+20230103/google_file1_beta1/api::ProjectLocationInstancePatchCall), [*locations instances restore*](https://docs.rs/google-file1_beta1/5.0.3+20230103/google_file1_beta1/api::ProjectLocationInstanceRestoreCall), [*locations instances revert*](https://docs.rs/google-file1_beta1/5.0.3+20230103/google_file1_beta1/api::ProjectLocationInstanceRevertCall), [*locations instances shares create*](https://docs.rs/google-file1_beta1/5.0.3+20230103/google_file1_beta1/api::ProjectLocationInstanceShareCreateCall), [*locations instances shares delete*](https://docs.rs/google-file1_beta1/5.0.3+20230103/google_file1_beta1/api::ProjectLocationInstanceShareDeleteCall), [*locations instances shares get*](https://docs.rs/google-file1_beta1/5.0.3+20230103/google_file1_beta1/api::ProjectLocationInstanceShareGetCall), [*locations instances shares list*](https://docs.rs/google-file1_beta1/5.0.3+20230103/google_file1_beta1/api::ProjectLocationInstanceShareListCall), [*locations instances shares patch*](https://docs.rs/google-file1_beta1/5.0.3+20230103/google_file1_beta1/api::ProjectLocationInstanceSharePatchCall), [*locations instances snapshots create*](https://docs.rs/google-file1_beta1/5.0.3+20230103/google_file1_beta1/api::ProjectLocationInstanceSnapshotCreateCall), [*locations instances snapshots delete*](https://docs.rs/google-file1_beta1/5.0.3+20230103/google_file1_beta1/api::ProjectLocationInstanceSnapshotDeleteCall), [*locations instances snapshots get*](https://docs.rs/google-file1_beta1/5.0.3+20230103/google_file1_beta1/api::ProjectLocationInstanceSnapshotGetCall), [*locations instances snapshots list*](https://docs.rs/google-file1_beta1/5.0.3+20230103/google_file1_beta1/api::ProjectLocationInstanceSnapshotListCall), [*locations instances snapshots patch*](https://docs.rs/google-file1_beta1/5.0.3+20230103/google_file1_beta1/api::ProjectLocationInstanceSnapshotPatchCall), [*locations list*](https://docs.rs/google-file1_beta1/5.0.3+20230103/google_file1_beta1/api::ProjectLocationListCall), [*locations operations cancel*](https://docs.rs/google-file1_beta1/5.0.3+20230103/google_file1_beta1/api::ProjectLocationOperationCancelCall), [*locations operations delete*](https://docs.rs/google-file1_beta1/5.0.3+20230103/google_file1_beta1/api::ProjectLocationOperationDeleteCall), [*locations operations get*](https://docs.rs/google-file1_beta1/5.0.3+20230103/google_file1_beta1/api::ProjectLocationOperationGetCall) and [*locations operations list*](https://docs.rs/google-file1_beta1/5.0.3+20230103/google_file1_beta1/api::ProjectLocationOperationListCall) @@ -64,8 +64,8 @@ let r = hub.projects().locations_instances_revert(...).doit().await let r = hub.projects().locations_operations_get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -93,12 +93,12 @@ use file1_beta1::{Result, Error}; use std::default::Default; use file1_beta1::{CloudFilestore, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -140,10 +140,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-file1_beta1/5.0.3+20230103/google_file1_beta1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-file1_beta1/5.0.3+20230103/google_file1_beta1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -153,25 +153,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-file1_ You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-file1_beta1/5.0.3+20230103/google_file1_beta1/client::Delegate) to the -[Method Builder](https://docs.rs/google-file1_beta1/5.0.3+20230103/google_file1_beta1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-file1_beta1/5.0.3+20230103/google_file1_beta1/client::Delegate) to the +[Method Builder](https://docs.rs/google-file1_beta1/5.0.3+20230103/google_file1_beta1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-file1_beta1/5.0.3+20230103/google_file1_beta1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-file1_beta1/5.0.3+20230103/google_file1_beta1/client::RequestValue) and -[decodable](https://docs.rs/google-file1_beta1/5.0.3+20230103/google_file1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-file1_beta1/5.0.3+20230103/google_file1_beta1/client::RequestValue) and +[decodable](https://docs.rs/google-file1_beta1/5.0.3+20230103/google_file1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-file1_beta1/5.0.3+20230103/google_file1_beta1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-file1_beta1/5.0.3+20230103/google_file1_beta1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -190,7 +190,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **file1_beta1** library was generated by Sebastian Thiel, and is placed +The **file1_beta1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/file1_beta1/src/api.rs b/gen/file1_beta1/src/api.rs index 4f3dbbb393..c654b23752 100644 --- a/gen/file1_beta1/src/api.rs +++ b/gen/file1_beta1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use file1_beta1::{CloudFilestore, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/file1_beta1/src/lib.rs b/gen/file1_beta1/src/lib.rs index 11adccab03..caa16b1863 100644 --- a/gen/file1_beta1/src/lib.rs +++ b/gen/file1_beta1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/file1_beta1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudFilestore) ... +//! Handle the following *Resources* with ease from the central [hub](CloudFilestore) ... //! //! * projects //! * [*locations backups create*](api::ProjectLocationBackupCreateCall), [*locations backups delete*](api::ProjectLocationBackupDeleteCall), [*locations backups get*](api::ProjectLocationBackupGetCall), [*locations backups list*](api::ProjectLocationBackupListCall), [*locations backups patch*](api::ProjectLocationBackupPatchCall), [*locations get*](api::ProjectLocationGetCall), [*locations instances create*](api::ProjectLocationInstanceCreateCall), [*locations instances delete*](api::ProjectLocationInstanceDeleteCall), [*locations instances get*](api::ProjectLocationInstanceGetCall), [*locations instances list*](api::ProjectLocationInstanceListCall), [*locations instances patch*](api::ProjectLocationInstancePatchCall), [*locations instances restore*](api::ProjectLocationInstanceRestoreCall), [*locations instances revert*](api::ProjectLocationInstanceRevertCall), [*locations instances shares create*](api::ProjectLocationInstanceShareCreateCall), [*locations instances shares delete*](api::ProjectLocationInstanceShareDeleteCall), [*locations instances shares get*](api::ProjectLocationInstanceShareGetCall), [*locations instances shares list*](api::ProjectLocationInstanceShareListCall), [*locations instances shares patch*](api::ProjectLocationInstanceSharePatchCall), [*locations instances snapshots create*](api::ProjectLocationInstanceSnapshotCreateCall), [*locations instances snapshots delete*](api::ProjectLocationInstanceSnapshotDeleteCall), [*locations instances snapshots get*](api::ProjectLocationInstanceSnapshotGetCall), [*locations instances snapshots list*](api::ProjectLocationInstanceSnapshotListCall), [*locations instances snapshots patch*](api::ProjectLocationInstanceSnapshotPatchCall), [*locations list*](api::ProjectLocationListCall), [*locations operations cancel*](api::ProjectLocationOperationCancelCall), [*locations operations delete*](api::ProjectLocationOperationDeleteCall), [*locations operations get*](api::ProjectLocationOperationGetCall) and [*locations operations list*](api::ProjectLocationOperationListCall) @@ -64,8 +64,8 @@ //! let r = hub.projects().locations_operations_get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -94,12 +94,12 @@ //! use std::default::Default; //! use file1_beta1::{CloudFilestore, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -141,10 +141,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -154,25 +154,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/firebase1_beta1/README.md b/gen/firebase1_beta1/README.md index b9784192cb..4de0e543d4 100644 --- a/gen/firebase1_beta1/README.md +++ b/gen/firebase1_beta1/README.md @@ -11,7 +11,7 @@ Everything else about the *Firebase Management* *v1_beta1* API can be found at t [official documentation site](https://firebase.google.com). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-firebase1_beta1/5.0.3+20230123/google_firebase1_beta1/FirebaseManagement) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-firebase1_beta1/5.0.3+20230123/google_firebase1_beta1/FirebaseManagement) ... * available projects * [*list*](https://docs.rs/google-firebase1_beta1/5.0.3+20230123/google_firebase1_beta1/api::AvailableProjectListCall) @@ -66,8 +66,8 @@ let r = hub.projects().add_firebase(...).doit().await let r = hub.projects().add_google_analytics(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -95,12 +95,12 @@ use firebase1_beta1::{Result, Error}; use std::default::Default; use firebase1_beta1::{FirebaseManagement, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -141,10 +141,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-firebase1_beta1/5.0.3+20230123/google_firebase1_beta1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-firebase1_beta1/5.0.3+20230123/google_firebase1_beta1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -154,25 +154,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-fireba You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-firebase1_beta1/5.0.3+20230123/google_firebase1_beta1/client::Delegate) to the -[Method Builder](https://docs.rs/google-firebase1_beta1/5.0.3+20230123/google_firebase1_beta1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-firebase1_beta1/5.0.3+20230123/google_firebase1_beta1/client::Delegate) to the +[Method Builder](https://docs.rs/google-firebase1_beta1/5.0.3+20230123/google_firebase1_beta1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-firebase1_beta1/5.0.3+20230123/google_firebase1_beta1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-firebase1_beta1/5.0.3+20230123/google_firebase1_beta1/client::RequestValue) and -[decodable](https://docs.rs/google-firebase1_beta1/5.0.3+20230123/google_firebase1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-firebase1_beta1/5.0.3+20230123/google_firebase1_beta1/client::RequestValue) and +[decodable](https://docs.rs/google-firebase1_beta1/5.0.3+20230123/google_firebase1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-firebase1_beta1/5.0.3+20230123/google_firebase1_beta1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-firebase1_beta1/5.0.3+20230123/google_firebase1_beta1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -191,7 +191,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **firebase1_beta1** library was generated by Sebastian Thiel, and is placed +The **firebase1_beta1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/firebase1_beta1/src/api.rs b/gen/firebase1_beta1/src/api.rs index 301739e640..0d6c008c76 100644 --- a/gen/firebase1_beta1/src/api.rs +++ b/gen/firebase1_beta1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -77,12 +77,12 @@ impl Default for Scope { /// use std::default::Default; /// use firebase1_beta1::{FirebaseManagement, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/firebase1_beta1/src/lib.rs b/gen/firebase1_beta1/src/lib.rs index a575c7dd03..4948931f53 100644 --- a/gen/firebase1_beta1/src/lib.rs +++ b/gen/firebase1_beta1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/firebase1_beta1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](FirebaseManagement) ... +//! Handle the following *Resources* with ease from the central [hub](FirebaseManagement) ... //! //! * available projects //! * [*list*](api::AvailableProjectListCall) @@ -66,8 +66,8 @@ //! let r = hub.projects().add_google_analytics(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -96,12 +96,12 @@ //! use std::default::Default; //! use firebase1_beta1::{FirebaseManagement, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -142,10 +142,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -155,25 +155,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/firebaseappcheck1_beta/README.md b/gen/firebaseappcheck1_beta/README.md index f2f414a424..3b598860a4 100644 --- a/gen/firebaseappcheck1_beta/README.md +++ b/gen/firebaseappcheck1_beta/README.md @@ -11,7 +11,7 @@ Everything else about the *Firebaseappcheck* *v1_beta* API can be found at the [official documentation site](https://firebase.google.com/docs/app-check). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-firebaseappcheck1_beta/5.0.3+20230116/google_firebaseappcheck1_beta/Firebaseappcheck) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-firebaseappcheck1_beta/5.0.3+20230116/google_firebaseappcheck1_beta/Firebaseappcheck) ... * jwks * [*get*](https://docs.rs/google-firebaseappcheck1_beta/5.0.3+20230116/google_firebaseappcheck1_beta/api::JwkGetCall) @@ -60,8 +60,8 @@ let r = hub.projects().apps_exchange_recaptcha_v3_token(...).doit().await let r = hub.projects().apps_exchange_safety_net_token(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -89,12 +89,12 @@ use firebaseappcheck1_beta::{Result, Error}; use std::default::Default; use firebaseappcheck1_beta::{Firebaseappcheck, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -135,10 +135,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-firebaseappcheck1_beta/5.0.3+20230116/google_firebaseappcheck1_beta/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-firebaseappcheck1_beta/5.0.3+20230116/google_firebaseappcheck1_beta/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -148,25 +148,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-fireba You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-firebaseappcheck1_beta/5.0.3+20230116/google_firebaseappcheck1_beta/client::Delegate) to the -[Method Builder](https://docs.rs/google-firebaseappcheck1_beta/5.0.3+20230116/google_firebaseappcheck1_beta/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-firebaseappcheck1_beta/5.0.3+20230116/google_firebaseappcheck1_beta/client::Delegate) to the +[Method Builder](https://docs.rs/google-firebaseappcheck1_beta/5.0.3+20230116/google_firebaseappcheck1_beta/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-firebaseappcheck1_beta/5.0.3+20230116/google_firebaseappcheck1_beta/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-firebaseappcheck1_beta/5.0.3+20230116/google_firebaseappcheck1_beta/client::RequestValue) and -[decodable](https://docs.rs/google-firebaseappcheck1_beta/5.0.3+20230116/google_firebaseappcheck1_beta/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-firebaseappcheck1_beta/5.0.3+20230116/google_firebaseappcheck1_beta/client::RequestValue) and +[decodable](https://docs.rs/google-firebaseappcheck1_beta/5.0.3+20230116/google_firebaseappcheck1_beta/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-firebaseappcheck1_beta/5.0.3+20230116/google_firebaseappcheck1_beta/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-firebaseappcheck1_beta/5.0.3+20230116/google_firebaseappcheck1_beta/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -185,7 +185,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **firebaseappcheck1_beta** library was generated by Sebastian Thiel, and is placed +The **firebaseappcheck1_beta** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/firebaseappcheck1_beta/src/api.rs b/gen/firebaseappcheck1_beta/src/api.rs index 3e4f5cc792..760e8647b3 100644 --- a/gen/firebaseappcheck1_beta/src/api.rs +++ b/gen/firebaseappcheck1_beta/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use firebaseappcheck1_beta::{Firebaseappcheck, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/firebaseappcheck1_beta/src/lib.rs b/gen/firebaseappcheck1_beta/src/lib.rs index 3a3eb02b17..09c3dc72ff 100644 --- a/gen/firebaseappcheck1_beta/src/lib.rs +++ b/gen/firebaseappcheck1_beta/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/firebaseappcheck1_beta). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Firebaseappcheck) ... +//! Handle the following *Resources* with ease from the central [hub](Firebaseappcheck) ... //! //! * jwks //! * [*get*](api::JwkGetCall) @@ -60,8 +60,8 @@ //! let r = hub.projects().apps_exchange_safety_net_token(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -90,12 +90,12 @@ //! use std::default::Default; //! use firebaseappcheck1_beta::{Firebaseappcheck, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -136,10 +136,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -149,25 +149,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/firebasedatabase1_beta/README.md b/gen/firebasedatabase1_beta/README.md index 9a27b85c86..cf7d588242 100644 --- a/gen/firebasedatabase1_beta/README.md +++ b/gen/firebasedatabase1_beta/README.md @@ -11,7 +11,7 @@ Everything else about the *Firebase Realtime Database* *v1_beta* API can be foun [official documentation site](https://firebase.google.com/docs/reference/rest/database/database-management/rest/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-firebasedatabase1_beta/5.0.3+20230123/google_firebasedatabase1_beta/FirebaseRealtimeDatabase) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-firebasedatabase1_beta/5.0.3+20230123/google_firebasedatabase1_beta/FirebaseRealtimeDatabase) ... * projects * [*locations instances create*](https://docs.rs/google-firebasedatabase1_beta/5.0.3+20230123/google_firebasedatabase1_beta/api::ProjectLocationInstanceCreateCall), [*locations instances delete*](https://docs.rs/google-firebasedatabase1_beta/5.0.3+20230123/google_firebasedatabase1_beta/api::ProjectLocationInstanceDeleteCall), [*locations instances disable*](https://docs.rs/google-firebasedatabase1_beta/5.0.3+20230123/google_firebasedatabase1_beta/api::ProjectLocationInstanceDisableCall), [*locations instances get*](https://docs.rs/google-firebasedatabase1_beta/5.0.3+20230123/google_firebasedatabase1_beta/api::ProjectLocationInstanceGetCall), [*locations instances list*](https://docs.rs/google-firebasedatabase1_beta/5.0.3+20230123/google_firebasedatabase1_beta/api::ProjectLocationInstanceListCall), [*locations instances reenable*](https://docs.rs/google-firebasedatabase1_beta/5.0.3+20230123/google_firebasedatabase1_beta/api::ProjectLocationInstanceReenableCall) and [*locations instances undelete*](https://docs.rs/google-firebasedatabase1_beta/5.0.3+20230123/google_firebasedatabase1_beta/api::ProjectLocationInstanceUndeleteCall) @@ -55,8 +55,8 @@ let r = hub.projects().locations_instances_reenable(...).doit().await let r = hub.projects().locations_instances_undelete(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -84,12 +84,12 @@ use firebasedatabase1_beta::{Result, Error}; use std::default::Default; use firebasedatabase1_beta::{FirebaseRealtimeDatabase, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -132,10 +132,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-firebasedatabase1_beta/5.0.3+20230123/google_firebasedatabase1_beta/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-firebasedatabase1_beta/5.0.3+20230123/google_firebasedatabase1_beta/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -145,25 +145,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-fireba You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-firebasedatabase1_beta/5.0.3+20230123/google_firebasedatabase1_beta/client::Delegate) to the -[Method Builder](https://docs.rs/google-firebasedatabase1_beta/5.0.3+20230123/google_firebasedatabase1_beta/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-firebasedatabase1_beta/5.0.3+20230123/google_firebasedatabase1_beta/client::Delegate) to the +[Method Builder](https://docs.rs/google-firebasedatabase1_beta/5.0.3+20230123/google_firebasedatabase1_beta/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-firebasedatabase1_beta/5.0.3+20230123/google_firebasedatabase1_beta/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-firebasedatabase1_beta/5.0.3+20230123/google_firebasedatabase1_beta/client::RequestValue) and -[decodable](https://docs.rs/google-firebasedatabase1_beta/5.0.3+20230123/google_firebasedatabase1_beta/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-firebasedatabase1_beta/5.0.3+20230123/google_firebasedatabase1_beta/client::RequestValue) and +[decodable](https://docs.rs/google-firebasedatabase1_beta/5.0.3+20230123/google_firebasedatabase1_beta/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-firebasedatabase1_beta/5.0.3+20230123/google_firebasedatabase1_beta/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-firebasedatabase1_beta/5.0.3+20230123/google_firebasedatabase1_beta/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -182,7 +182,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **firebasedatabase1_beta** library was generated by Sebastian Thiel, and is placed +The **firebasedatabase1_beta** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/firebasedatabase1_beta/src/api.rs b/gen/firebasedatabase1_beta/src/api.rs index 1dfd940357..66c1962ddb 100644 --- a/gen/firebasedatabase1_beta/src/api.rs +++ b/gen/firebasedatabase1_beta/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -77,12 +77,12 @@ impl Default for Scope { /// use std::default::Default; /// use firebasedatabase1_beta::{FirebaseRealtimeDatabase, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/firebasedatabase1_beta/src/lib.rs b/gen/firebasedatabase1_beta/src/lib.rs index a6140d997f..b7dac32487 100644 --- a/gen/firebasedatabase1_beta/src/lib.rs +++ b/gen/firebasedatabase1_beta/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/firebasedatabase1_beta). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](FirebaseRealtimeDatabase) ... +//! Handle the following *Resources* with ease from the central [hub](FirebaseRealtimeDatabase) ... //! //! * projects //! * [*locations instances create*](api::ProjectLocationInstanceCreateCall), [*locations instances delete*](api::ProjectLocationInstanceDeleteCall), [*locations instances disable*](api::ProjectLocationInstanceDisableCall), [*locations instances get*](api::ProjectLocationInstanceGetCall), [*locations instances list*](api::ProjectLocationInstanceListCall), [*locations instances reenable*](api::ProjectLocationInstanceReenableCall) and [*locations instances undelete*](api::ProjectLocationInstanceUndeleteCall) @@ -55,8 +55,8 @@ //! let r = hub.projects().locations_instances_undelete(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -85,12 +85,12 @@ //! use std::default::Default; //! use firebasedatabase1_beta::{FirebaseRealtimeDatabase, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -133,10 +133,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -146,25 +146,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/firebasedynamiclinks1/README.md b/gen/firebasedynamiclinks1/README.md index 1f34d18bf2..9c1c25c4db 100644 --- a/gen/firebasedynamiclinks1/README.md +++ b/gen/firebasedynamiclinks1/README.md @@ -11,7 +11,7 @@ Everything else about the *Firebase Dynamic Links* *v1* API can be found at the [official documentation site](https://firebase.google.com/docs/dynamic-links/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-firebasedynamiclinks1/5.0.3+20230123/google_firebasedynamiclinks1/FirebaseDynamicLinks) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-firebasedynamiclinks1/5.0.3+20230123/google_firebasedynamiclinks1/FirebaseDynamicLinks) ... * [managed short links](https://docs.rs/google-firebasedynamiclinks1/5.0.3+20230123/google_firebasedynamiclinks1/api::ManagedShortLink) * [*create*](https://docs.rs/google-firebasedynamiclinks1/5.0.3+20230123/google_firebasedynamiclinks1/api::ManagedShortLinkCreateCall) @@ -57,8 +57,8 @@ Or specifically ... let r = hub.methods().install_attribution(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -86,12 +86,12 @@ use firebasedynamiclinks1::{Result, Error}; use std::default::Default; use firebasedynamiclinks1::{FirebaseDynamicLinks, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -132,10 +132,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-firebasedynamiclinks1/5.0.3+20230123/google_firebasedynamiclinks1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-firebasedynamiclinks1/5.0.3+20230123/google_firebasedynamiclinks1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -145,25 +145,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-fireba You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-firebasedynamiclinks1/5.0.3+20230123/google_firebasedynamiclinks1/client::Delegate) to the -[Method Builder](https://docs.rs/google-firebasedynamiclinks1/5.0.3+20230123/google_firebasedynamiclinks1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-firebasedynamiclinks1/5.0.3+20230123/google_firebasedynamiclinks1/client::Delegate) to the +[Method Builder](https://docs.rs/google-firebasedynamiclinks1/5.0.3+20230123/google_firebasedynamiclinks1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-firebasedynamiclinks1/5.0.3+20230123/google_firebasedynamiclinks1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-firebasedynamiclinks1/5.0.3+20230123/google_firebasedynamiclinks1/client::RequestValue) and -[decodable](https://docs.rs/google-firebasedynamiclinks1/5.0.3+20230123/google_firebasedynamiclinks1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-firebasedynamiclinks1/5.0.3+20230123/google_firebasedynamiclinks1/client::RequestValue) and +[decodable](https://docs.rs/google-firebasedynamiclinks1/5.0.3+20230123/google_firebasedynamiclinks1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-firebasedynamiclinks1/5.0.3+20230123/google_firebasedynamiclinks1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-firebasedynamiclinks1/5.0.3+20230123/google_firebasedynamiclinks1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -182,7 +182,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **firebasedynamiclinks1** library was generated by Sebastian Thiel, and is placed +The **firebasedynamiclinks1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/firebasedynamiclinks1/src/api.rs b/gen/firebasedynamiclinks1/src/api.rs index d9feb690cc..c1cc66ca7b 100644 --- a/gen/firebasedynamiclinks1/src/api.rs +++ b/gen/firebasedynamiclinks1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and administer all your Firebase data and settings Firebase, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use firebasedynamiclinks1::{FirebaseDynamicLinks, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/firebasedynamiclinks1/src/lib.rs b/gen/firebasedynamiclinks1/src/lib.rs index 68be2505a2..8e33a45a9a 100644 --- a/gen/firebasedynamiclinks1/src/lib.rs +++ b/gen/firebasedynamiclinks1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/firebasedynamiclinks1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](FirebaseDynamicLinks) ... +//! Handle the following *Resources* with ease from the central [hub](FirebaseDynamicLinks) ... //! //! * [managed short links](api::ManagedShortLink) //! * [*create*](api::ManagedShortLinkCreateCall) @@ -57,8 +57,8 @@ //! let r = hub.methods().install_attribution(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -87,12 +87,12 @@ //! use std::default::Default; //! use firebasedynamiclinks1::{FirebaseDynamicLinks, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -133,10 +133,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -146,25 +146,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/firebasehosting1/README.md b/gen/firebasehosting1/README.md index 3950873c67..805090303a 100644 --- a/gen/firebasehosting1/README.md +++ b/gen/firebasehosting1/README.md @@ -11,7 +11,7 @@ Everything else about the *Firebase Hosting* *v1* API can be found at the [official documentation site](https://firebase.google.com/docs/hosting/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-firebasehosting1/5.0.3+20230123/google_firebasehosting1/FirebaseHosting) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-firebasehosting1/5.0.3+20230123/google_firebasehosting1/FirebaseHosting) ... * [operations](https://docs.rs/google-firebasehosting1/5.0.3+20230123/google_firebasehosting1/api::Operation) * [*cancel*](https://docs.rs/google-firebasehosting1/5.0.3+20230123/google_firebasehosting1/api::OperationCancelCall), [*delete*](https://docs.rs/google-firebasehosting1/5.0.3+20230123/google_firebasehosting1/api::OperationDeleteCall) and [*list*](https://docs.rs/google-firebasehosting1/5.0.3+20230123/google_firebasehosting1/api::OperationListCall) @@ -52,8 +52,8 @@ let r = hub.operations().delete(...).doit().await let r = hub.operations().list(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -80,12 +80,12 @@ use firebasehosting1::{Result, Error}; use std::default::Default; use firebasehosting1::{FirebaseHosting, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -124,10 +124,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-firebasehosting1/5.0.3+20230123/google_firebasehosting1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-firebasehosting1/5.0.3+20230123/google_firebasehosting1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -137,25 +137,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-fireba You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-firebasehosting1/5.0.3+20230123/google_firebasehosting1/client::Delegate) to the -[Method Builder](https://docs.rs/google-firebasehosting1/5.0.3+20230123/google_firebasehosting1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-firebasehosting1/5.0.3+20230123/google_firebasehosting1/client::Delegate) to the +[Method Builder](https://docs.rs/google-firebasehosting1/5.0.3+20230123/google_firebasehosting1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-firebasehosting1/5.0.3+20230123/google_firebasehosting1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-firebasehosting1/5.0.3+20230123/google_firebasehosting1/client::RequestValue) and -[decodable](https://docs.rs/google-firebasehosting1/5.0.3+20230123/google_firebasehosting1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-firebasehosting1/5.0.3+20230123/google_firebasehosting1/client::RequestValue) and +[decodable](https://docs.rs/google-firebasehosting1/5.0.3+20230123/google_firebasehosting1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-firebasehosting1/5.0.3+20230123/google_firebasehosting1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-firebasehosting1/5.0.3+20230123/google_firebasehosting1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -174,7 +174,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **firebasehosting1** library was generated by Sebastian Thiel, and is placed +The **firebasehosting1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/firebasehosting1/src/api.rs b/gen/firebasehosting1/src/api.rs index 3f75fe8084..dcf2488594 100644 --- a/gen/firebasehosting1/src/api.rs +++ b/gen/firebasehosting1/src/api.rs @@ -42,12 +42,12 @@ use crate::{client, client::GetToken, client::serde_with}; /// use std::default::Default; /// use firebasehosting1::{FirebaseHosting, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/firebasehosting1/src/lib.rs b/gen/firebasehosting1/src/lib.rs index 31563088b1..d92bfe8dd9 100644 --- a/gen/firebasehosting1/src/lib.rs +++ b/gen/firebasehosting1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/firebasehosting1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](FirebaseHosting) ... +//! Handle the following *Resources* with ease from the central [hub](FirebaseHosting) ... //! //! * [operations](api::Operation) //! * [*cancel*](api::OperationCancelCall), [*delete*](api::OperationDeleteCall) and [*list*](api::OperationListCall) @@ -52,8 +52,8 @@ //! let r = hub.operations().list(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -81,12 +81,12 @@ //! use std::default::Default; //! use firebasehosting1::{FirebaseHosting, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -125,10 +125,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -138,25 +138,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/firebasehosting1_beta1/README.md b/gen/firebasehosting1_beta1/README.md index 6ab1c4adae..488d352675 100644 --- a/gen/firebasehosting1_beta1/README.md +++ b/gen/firebasehosting1_beta1/README.md @@ -11,7 +11,7 @@ Everything else about the *Firebase Hosting* *v1_beta1* API can be found at the [official documentation site](https://firebase.google.com/docs/hosting/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-firebasehosting1_beta1/5.0.3+20230123/google_firebasehosting1_beta1/FirebaseHosting) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-firebasehosting1_beta1/5.0.3+20230123/google_firebasehosting1_beta1/FirebaseHosting) ... * projects * [*operations get*](https://docs.rs/google-firebasehosting1_beta1/5.0.3+20230123/google_firebasehosting1_beta1/api::ProjectOperationGetCall), [*sites channels create*](https://docs.rs/google-firebasehosting1_beta1/5.0.3+20230123/google_firebasehosting1_beta1/api::ProjectSiteChannelCreateCall), [*sites channels delete*](https://docs.rs/google-firebasehosting1_beta1/5.0.3+20230123/google_firebasehosting1_beta1/api::ProjectSiteChannelDeleteCall), [*sites channels get*](https://docs.rs/google-firebasehosting1_beta1/5.0.3+20230123/google_firebasehosting1_beta1/api::ProjectSiteChannelGetCall), [*sites channels list*](https://docs.rs/google-firebasehosting1_beta1/5.0.3+20230123/google_firebasehosting1_beta1/api::ProjectSiteChannelListCall), [*sites channels patch*](https://docs.rs/google-firebasehosting1_beta1/5.0.3+20230123/google_firebasehosting1_beta1/api::ProjectSiteChannelPatchCall), [*sites channels releases create*](https://docs.rs/google-firebasehosting1_beta1/5.0.3+20230123/google_firebasehosting1_beta1/api::ProjectSiteChannelReleaseCreateCall), [*sites channels releases list*](https://docs.rs/google-firebasehosting1_beta1/5.0.3+20230123/google_firebasehosting1_beta1/api::ProjectSiteChannelReleaseListCall), [*sites create*](https://docs.rs/google-firebasehosting1_beta1/5.0.3+20230123/google_firebasehosting1_beta1/api::ProjectSiteCreateCall), [*sites delete*](https://docs.rs/google-firebasehosting1_beta1/5.0.3+20230123/google_firebasehosting1_beta1/api::ProjectSiteDeleteCall), [*sites domains create*](https://docs.rs/google-firebasehosting1_beta1/5.0.3+20230123/google_firebasehosting1_beta1/api::ProjectSiteDomainCreateCall), [*sites domains delete*](https://docs.rs/google-firebasehosting1_beta1/5.0.3+20230123/google_firebasehosting1_beta1/api::ProjectSiteDomainDeleteCall), [*sites domains get*](https://docs.rs/google-firebasehosting1_beta1/5.0.3+20230123/google_firebasehosting1_beta1/api::ProjectSiteDomainGetCall), [*sites domains list*](https://docs.rs/google-firebasehosting1_beta1/5.0.3+20230123/google_firebasehosting1_beta1/api::ProjectSiteDomainListCall), [*sites domains update*](https://docs.rs/google-firebasehosting1_beta1/5.0.3+20230123/google_firebasehosting1_beta1/api::ProjectSiteDomainUpdateCall), [*sites get*](https://docs.rs/google-firebasehosting1_beta1/5.0.3+20230123/google_firebasehosting1_beta1/api::ProjectSiteGetCall), [*sites get config*](https://docs.rs/google-firebasehosting1_beta1/5.0.3+20230123/google_firebasehosting1_beta1/api::ProjectSiteGetConfigCall), [*sites list*](https://docs.rs/google-firebasehosting1_beta1/5.0.3+20230123/google_firebasehosting1_beta1/api::ProjectSiteListCall), [*sites patch*](https://docs.rs/google-firebasehosting1_beta1/5.0.3+20230123/google_firebasehosting1_beta1/api::ProjectSitePatchCall), [*sites releases create*](https://docs.rs/google-firebasehosting1_beta1/5.0.3+20230123/google_firebasehosting1_beta1/api::ProjectSiteReleaseCreateCall), [*sites releases list*](https://docs.rs/google-firebasehosting1_beta1/5.0.3+20230123/google_firebasehosting1_beta1/api::ProjectSiteReleaseListCall), [*sites update config*](https://docs.rs/google-firebasehosting1_beta1/5.0.3+20230123/google_firebasehosting1_beta1/api::ProjectSiteUpdateConfigCall), [*sites versions clone*](https://docs.rs/google-firebasehosting1_beta1/5.0.3+20230123/google_firebasehosting1_beta1/api::ProjectSiteVersionCloneCall), [*sites versions create*](https://docs.rs/google-firebasehosting1_beta1/5.0.3+20230123/google_firebasehosting1_beta1/api::ProjectSiteVersionCreateCall), [*sites versions delete*](https://docs.rs/google-firebasehosting1_beta1/5.0.3+20230123/google_firebasehosting1_beta1/api::ProjectSiteVersionDeleteCall), [*sites versions files list*](https://docs.rs/google-firebasehosting1_beta1/5.0.3+20230123/google_firebasehosting1_beta1/api::ProjectSiteVersionFileListCall), [*sites versions list*](https://docs.rs/google-firebasehosting1_beta1/5.0.3+20230123/google_firebasehosting1_beta1/api::ProjectSiteVersionListCall), [*sites versions patch*](https://docs.rs/google-firebasehosting1_beta1/5.0.3+20230123/google_firebasehosting1_beta1/api::ProjectSiteVersionPatchCall) and [*sites versions populate files*](https://docs.rs/google-firebasehosting1_beta1/5.0.3+20230123/google_firebasehosting1_beta1/api::ProjectSiteVersionPopulateFileCall) @@ -77,8 +77,8 @@ let r = hub.sites().get_config(...).doit().await let r = hub.sites().update_config(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -105,12 +105,12 @@ use firebasehosting1_beta1::{Result, Error}; use std::default::Default; use firebasehosting1_beta1::{FirebaseHosting, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -149,10 +149,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-firebasehosting1_beta1/5.0.3+20230123/google_firebasehosting1_beta1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-firebasehosting1_beta1/5.0.3+20230123/google_firebasehosting1_beta1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -162,25 +162,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-fireba You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-firebasehosting1_beta1/5.0.3+20230123/google_firebasehosting1_beta1/client::Delegate) to the -[Method Builder](https://docs.rs/google-firebasehosting1_beta1/5.0.3+20230123/google_firebasehosting1_beta1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-firebasehosting1_beta1/5.0.3+20230123/google_firebasehosting1_beta1/client::Delegate) to the +[Method Builder](https://docs.rs/google-firebasehosting1_beta1/5.0.3+20230123/google_firebasehosting1_beta1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-firebasehosting1_beta1/5.0.3+20230123/google_firebasehosting1_beta1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-firebasehosting1_beta1/5.0.3+20230123/google_firebasehosting1_beta1/client::RequestValue) and -[decodable](https://docs.rs/google-firebasehosting1_beta1/5.0.3+20230123/google_firebasehosting1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-firebasehosting1_beta1/5.0.3+20230123/google_firebasehosting1_beta1/client::RequestValue) and +[decodable](https://docs.rs/google-firebasehosting1_beta1/5.0.3+20230123/google_firebasehosting1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-firebasehosting1_beta1/5.0.3+20230123/google_firebasehosting1_beta1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-firebasehosting1_beta1/5.0.3+20230123/google_firebasehosting1_beta1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -199,7 +199,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **firebasehosting1_beta1** library was generated by Sebastian Thiel, and is placed +The **firebasehosting1_beta1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/firebasehosting1_beta1/src/api.rs b/gen/firebasehosting1_beta1/src/api.rs index acedb778c1..48e3d18099 100644 --- a/gen/firebasehosting1_beta1/src/api.rs +++ b/gen/firebasehosting1_beta1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -76,12 +76,12 @@ impl Default for Scope { /// use std::default::Default; /// use firebasehosting1_beta1::{FirebaseHosting, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/firebasehosting1_beta1/src/lib.rs b/gen/firebasehosting1_beta1/src/lib.rs index 7438d75e6c..a53f6d6531 100644 --- a/gen/firebasehosting1_beta1/src/lib.rs +++ b/gen/firebasehosting1_beta1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/firebasehosting1_beta1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](FirebaseHosting) ... +//! Handle the following *Resources* with ease from the central [hub](FirebaseHosting) ... //! //! * projects //! * [*operations get*](api::ProjectOperationGetCall), [*sites channels create*](api::ProjectSiteChannelCreateCall), [*sites channels delete*](api::ProjectSiteChannelDeleteCall), [*sites channels get*](api::ProjectSiteChannelGetCall), [*sites channels list*](api::ProjectSiteChannelListCall), [*sites channels patch*](api::ProjectSiteChannelPatchCall), [*sites channels releases create*](api::ProjectSiteChannelReleaseCreateCall), [*sites channels releases list*](api::ProjectSiteChannelReleaseListCall), [*sites create*](api::ProjectSiteCreateCall), [*sites delete*](api::ProjectSiteDeleteCall), [*sites domains create*](api::ProjectSiteDomainCreateCall), [*sites domains delete*](api::ProjectSiteDomainDeleteCall), [*sites domains get*](api::ProjectSiteDomainGetCall), [*sites domains list*](api::ProjectSiteDomainListCall), [*sites domains update*](api::ProjectSiteDomainUpdateCall), [*sites get*](api::ProjectSiteGetCall), [*sites get config*](api::ProjectSiteGetConfigCall), [*sites list*](api::ProjectSiteListCall), [*sites patch*](api::ProjectSitePatchCall), [*sites releases create*](api::ProjectSiteReleaseCreateCall), [*sites releases list*](api::ProjectSiteReleaseListCall), [*sites update config*](api::ProjectSiteUpdateConfigCall), [*sites versions clone*](api::ProjectSiteVersionCloneCall), [*sites versions create*](api::ProjectSiteVersionCreateCall), [*sites versions delete*](api::ProjectSiteVersionDeleteCall), [*sites versions files list*](api::ProjectSiteVersionFileListCall), [*sites versions list*](api::ProjectSiteVersionListCall), [*sites versions patch*](api::ProjectSiteVersionPatchCall) and [*sites versions populate files*](api::ProjectSiteVersionPopulateFileCall) @@ -77,8 +77,8 @@ //! let r = hub.sites().update_config(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -106,12 +106,12 @@ //! use std::default::Default; //! use firebasehosting1_beta1::{FirebaseHosting, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -150,10 +150,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -163,25 +163,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/firebaseml1/README.md b/gen/firebaseml1/README.md index fb7fe37e63..2f794261e7 100644 --- a/gen/firebaseml1/README.md +++ b/gen/firebaseml1/README.md @@ -11,7 +11,7 @@ Everything else about the *Firebase ML* *v1* API can be found at the [official documentation site](https://firebase.google.com). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-firebaseml1/5.0.3+20230123/google_firebaseml1/FirebaseML) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-firebaseml1/5.0.3+20230123/google_firebaseml1/FirebaseML) ... * [operations](https://docs.rs/google-firebaseml1/5.0.3+20230123/google_firebaseml1/api::Operation) * [*cancel*](https://docs.rs/google-firebaseml1/5.0.3+20230123/google_firebaseml1/api::OperationCancelCall), [*delete*](https://docs.rs/google-firebaseml1/5.0.3+20230123/google_firebaseml1/api::OperationDeleteCall) and [*list*](https://docs.rs/google-firebaseml1/5.0.3+20230123/google_firebaseml1/api::OperationListCall) @@ -52,8 +52,8 @@ let r = hub.operations().delete(...).doit().await let r = hub.operations().list(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -80,12 +80,12 @@ use firebaseml1::{Result, Error}; use std::default::Default; use firebaseml1::{FirebaseML, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -124,10 +124,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-firebaseml1/5.0.3+20230123/google_firebaseml1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-firebaseml1/5.0.3+20230123/google_firebaseml1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -137,25 +137,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-fireba You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-firebaseml1/5.0.3+20230123/google_firebaseml1/client::Delegate) to the -[Method Builder](https://docs.rs/google-firebaseml1/5.0.3+20230123/google_firebaseml1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-firebaseml1/5.0.3+20230123/google_firebaseml1/client::Delegate) to the +[Method Builder](https://docs.rs/google-firebaseml1/5.0.3+20230123/google_firebaseml1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-firebaseml1/5.0.3+20230123/google_firebaseml1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-firebaseml1/5.0.3+20230123/google_firebaseml1/client::RequestValue) and -[decodable](https://docs.rs/google-firebaseml1/5.0.3+20230123/google_firebaseml1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-firebaseml1/5.0.3+20230123/google_firebaseml1/client::RequestValue) and +[decodable](https://docs.rs/google-firebaseml1/5.0.3+20230123/google_firebaseml1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-firebaseml1/5.0.3+20230123/google_firebaseml1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-firebaseml1/5.0.3+20230123/google_firebaseml1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -174,7 +174,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **firebaseml1** library was generated by Sebastian Thiel, and is placed +The **firebaseml1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/firebaseml1/src/api.rs b/gen/firebaseml1/src/api.rs index 4759e7cf46..4c7f102846 100644 --- a/gen/firebaseml1/src/api.rs +++ b/gen/firebaseml1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use firebaseml1::{FirebaseML, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/firebaseml1/src/lib.rs b/gen/firebaseml1/src/lib.rs index 0ffaf09133..fb215a7294 100644 --- a/gen/firebaseml1/src/lib.rs +++ b/gen/firebaseml1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/firebaseml1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](FirebaseML) ... +//! Handle the following *Resources* with ease from the central [hub](FirebaseML) ... //! //! * [operations](api::Operation) //! * [*cancel*](api::OperationCancelCall), [*delete*](api::OperationDeleteCall) and [*list*](api::OperationListCall) @@ -52,8 +52,8 @@ //! let r = hub.operations().list(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -81,12 +81,12 @@ //! use std::default::Default; //! use firebaseml1::{FirebaseML, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -125,10 +125,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -138,25 +138,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/firebaseremoteconfig1/README.md b/gen/firebaseremoteconfig1/README.md index a0d2af5310..fea79cc947 100644 --- a/gen/firebaseremoteconfig1/README.md +++ b/gen/firebaseremoteconfig1/README.md @@ -11,7 +11,7 @@ Everything else about the *Firebase Remote Config* *v1* API can be found at the [official documentation site](https://firebase.google.com/docs/remote-config/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-firebaseremoteconfig1/5.0.3+20171129/google_firebaseremoteconfig1/FirebaseRemoteConfig) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-firebaseremoteconfig1/5.0.3+20171129/google_firebaseremoteconfig1/FirebaseRemoteConfig) ... * projects * [*get remote config*](https://docs.rs/google-firebaseremoteconfig1/5.0.3+20171129/google_firebaseremoteconfig1/api::ProjectGetRemoteConfigCall) and [*update remote config*](https://docs.rs/google-firebaseremoteconfig1/5.0.3+20171129/google_firebaseremoteconfig1/api::ProjectUpdateRemoteConfigCall) @@ -51,8 +51,8 @@ let r = hub.projects().get_remote_config(...).doit().await let r = hub.projects().update_remote_config(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -80,12 +80,12 @@ use firebaseremoteconfig1::{Result, Error}; use std::default::Default; use firebaseremoteconfig1::{FirebaseRemoteConfig, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -127,10 +127,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-firebaseremoteconfig1/5.0.3+20171129/google_firebaseremoteconfig1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-firebaseremoteconfig1/5.0.3+20171129/google_firebaseremoteconfig1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -140,25 +140,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-fireba You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-firebaseremoteconfig1/5.0.3+20171129/google_firebaseremoteconfig1/client::Delegate) to the -[Method Builder](https://docs.rs/google-firebaseremoteconfig1/5.0.3+20171129/google_firebaseremoteconfig1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-firebaseremoteconfig1/5.0.3+20171129/google_firebaseremoteconfig1/client::Delegate) to the +[Method Builder](https://docs.rs/google-firebaseremoteconfig1/5.0.3+20171129/google_firebaseremoteconfig1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-firebaseremoteconfig1/5.0.3+20171129/google_firebaseremoteconfig1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-firebaseremoteconfig1/5.0.3+20171129/google_firebaseremoteconfig1/client::RequestValue) and -[decodable](https://docs.rs/google-firebaseremoteconfig1/5.0.3+20171129/google_firebaseremoteconfig1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-firebaseremoteconfig1/5.0.3+20171129/google_firebaseremoteconfig1/client::RequestValue) and +[decodable](https://docs.rs/google-firebaseremoteconfig1/5.0.3+20171129/google_firebaseremoteconfig1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-firebaseremoteconfig1/5.0.3+20171129/google_firebaseremoteconfig1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-firebaseremoteconfig1/5.0.3+20171129/google_firebaseremoteconfig1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -177,7 +177,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **firebaseremoteconfig1** library was generated by Sebastian Thiel, and is placed +The **firebaseremoteconfig1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/firebaseremoteconfig1/src/api.rs b/gen/firebaseremoteconfig1/src/api.rs index d12aea3d8d..d46bb94d03 100644 --- a/gen/firebaseremoteconfig1/src/api.rs +++ b/gen/firebaseremoteconfig1/src/api.rs @@ -43,12 +43,12 @@ use crate::{client, client::GetToken, client::serde_with}; /// use std::default::Default; /// use firebaseremoteconfig1::{FirebaseRemoteConfig, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/firebaseremoteconfig1/src/lib.rs b/gen/firebaseremoteconfig1/src/lib.rs index 54e6db9b2d..be29f3ad6a 100644 --- a/gen/firebaseremoteconfig1/src/lib.rs +++ b/gen/firebaseremoteconfig1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/firebaseremoteconfig1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](FirebaseRemoteConfig) ... +//! Handle the following *Resources* with ease from the central [hub](FirebaseRemoteConfig) ... //! //! * projects //! * [*get remote config*](api::ProjectGetRemoteConfigCall) and [*update remote config*](api::ProjectUpdateRemoteConfigCall) @@ -51,8 +51,8 @@ //! let r = hub.projects().update_remote_config(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -81,12 +81,12 @@ //! use std::default::Default; //! use firebaseremoteconfig1::{FirebaseRemoteConfig, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -128,10 +128,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -141,25 +141,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/firebasestorage1_beta/README.md b/gen/firebasestorage1_beta/README.md index 2f14b8a837..c75d98ad9d 100644 --- a/gen/firebasestorage1_beta/README.md +++ b/gen/firebasestorage1_beta/README.md @@ -11,7 +11,7 @@ Everything else about the *Firebasestorage* *v1_beta* API can be found at the [official documentation site](https://firebase.google.com/docs/storage). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-firebasestorage1_beta/5.0.3+20230106/google_firebasestorage1_beta/Firebasestorage) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-firebasestorage1_beta/5.0.3+20230106/google_firebasestorage1_beta/Firebasestorage) ... * projects * [*buckets add firebase*](https://docs.rs/google-firebasestorage1_beta/5.0.3+20230106/google_firebasestorage1_beta/api::ProjectBucketAddFirebaseCall), [*buckets get*](https://docs.rs/google-firebasestorage1_beta/5.0.3+20230106/google_firebasestorage1_beta/api::ProjectBucketGetCall), [*buckets list*](https://docs.rs/google-firebasestorage1_beta/5.0.3+20230106/google_firebasestorage1_beta/api::ProjectBucketListCall) and [*buckets remove firebase*](https://docs.rs/google-firebasestorage1_beta/5.0.3+20230106/google_firebasestorage1_beta/api::ProjectBucketRemoveFirebaseCall) @@ -51,8 +51,8 @@ let r = hub.projects().buckets_add_firebase(...).doit().await let r = hub.projects().buckets_get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -80,12 +80,12 @@ use firebasestorage1_beta::{Result, Error}; use std::default::Default; use firebasestorage1_beta::{Firebasestorage, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -126,10 +126,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-firebasestorage1_beta/5.0.3+20230106/google_firebasestorage1_beta/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-firebasestorage1_beta/5.0.3+20230106/google_firebasestorage1_beta/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -139,25 +139,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-fireba You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-firebasestorage1_beta/5.0.3+20230106/google_firebasestorage1_beta/client::Delegate) to the -[Method Builder](https://docs.rs/google-firebasestorage1_beta/5.0.3+20230106/google_firebasestorage1_beta/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-firebasestorage1_beta/5.0.3+20230106/google_firebasestorage1_beta/client::Delegate) to the +[Method Builder](https://docs.rs/google-firebasestorage1_beta/5.0.3+20230106/google_firebasestorage1_beta/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-firebasestorage1_beta/5.0.3+20230106/google_firebasestorage1_beta/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-firebasestorage1_beta/5.0.3+20230106/google_firebasestorage1_beta/client::RequestValue) and -[decodable](https://docs.rs/google-firebasestorage1_beta/5.0.3+20230106/google_firebasestorage1_beta/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-firebasestorage1_beta/5.0.3+20230106/google_firebasestorage1_beta/client::RequestValue) and +[decodable](https://docs.rs/google-firebasestorage1_beta/5.0.3+20230106/google_firebasestorage1_beta/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-firebasestorage1_beta/5.0.3+20230106/google_firebasestorage1_beta/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-firebasestorage1_beta/5.0.3+20230106/google_firebasestorage1_beta/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -176,7 +176,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **firebasestorage1_beta** library was generated by Sebastian Thiel, and is placed +The **firebasestorage1_beta** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/firebasestorage1_beta/src/api.rs b/gen/firebasestorage1_beta/src/api.rs index 4b5b1b9eac..1320ae3258 100644 --- a/gen/firebasestorage1_beta/src/api.rs +++ b/gen/firebasestorage1_beta/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use firebasestorage1_beta::{Firebasestorage, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/firebasestorage1_beta/src/lib.rs b/gen/firebasestorage1_beta/src/lib.rs index 347d0ad876..4235b04531 100644 --- a/gen/firebasestorage1_beta/src/lib.rs +++ b/gen/firebasestorage1_beta/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/firebasestorage1_beta). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Firebasestorage) ... +//! Handle the following *Resources* with ease from the central [hub](Firebasestorage) ... //! //! * projects //! * [*buckets add firebase*](api::ProjectBucketAddFirebaseCall), [*buckets get*](api::ProjectBucketGetCall), [*buckets list*](api::ProjectBucketListCall) and [*buckets remove firebase*](api::ProjectBucketRemoveFirebaseCall) @@ -51,8 +51,8 @@ //! let r = hub.projects().buckets_get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -81,12 +81,12 @@ //! use std::default::Default; //! use firebasestorage1_beta::{Firebasestorage, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -127,10 +127,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -140,25 +140,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/firestore1/README.md b/gen/firestore1/README.md index 0927cae8e2..2e9d79224a 100644 --- a/gen/firestore1/README.md +++ b/gen/firestore1/README.md @@ -11,7 +11,7 @@ Everything else about the *Firestore* *v1* API can be found at the [official documentation site](https://cloud.google.com/firestore). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/Firestore) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/Firestore) ... * projects * [*databases collection groups fields get*](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/api::ProjectDatabaseCollectionGroupFieldGetCall), [*databases collection groups fields list*](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/api::ProjectDatabaseCollectionGroupFieldListCall), [*databases collection groups fields patch*](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/api::ProjectDatabaseCollectionGroupFieldPatchCall), [*databases collection groups indexes create*](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/api::ProjectDatabaseCollectionGroupIndexCreateCall), [*databases collection groups indexes delete*](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/api::ProjectDatabaseCollectionGroupIndexDeleteCall), [*databases collection groups indexes get*](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/api::ProjectDatabaseCollectionGroupIndexGetCall), [*databases collection groups indexes list*](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/api::ProjectDatabaseCollectionGroupIndexListCall), [*databases create*](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/api::ProjectDatabaseCreateCall), [*databases delete*](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/api::ProjectDatabaseDeleteCall), [*databases documents batch get*](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/api::ProjectDatabaseDocumentBatchGetCall), [*databases documents batch write*](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/api::ProjectDatabaseDocumentBatchWriteCall), [*databases documents begin transaction*](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/api::ProjectDatabaseDocumentBeginTransactionCall), [*databases documents commit*](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/api::ProjectDatabaseDocumentCommitCall), [*databases documents create document*](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/api::ProjectDatabaseDocumentCreateDocumentCall), [*databases documents delete*](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/api::ProjectDatabaseDocumentDeleteCall), [*databases documents get*](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/api::ProjectDatabaseDocumentGetCall), [*databases documents list*](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/api::ProjectDatabaseDocumentListCall), [*databases documents list collection ids*](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/api::ProjectDatabaseDocumentListCollectionIdCall), [*databases documents list documents*](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/api::ProjectDatabaseDocumentListDocumentCall), [*databases documents listen*](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/api::ProjectDatabaseDocumentListenCall), [*databases documents partition query*](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/api::ProjectDatabaseDocumentPartitionQueryCall), [*databases documents patch*](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/api::ProjectDatabaseDocumentPatchCall), [*databases documents rollback*](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/api::ProjectDatabaseDocumentRollbackCall), [*databases documents run aggregation query*](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/api::ProjectDatabaseDocumentRunAggregationQueryCall), [*databases documents run query*](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/api::ProjectDatabaseDocumentRunQueryCall), [*databases documents write*](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/api::ProjectDatabaseDocumentWriteCall), [*databases export documents*](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/api::ProjectDatabaseExportDocumentCall), [*databases get*](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/api::ProjectDatabaseGetCall), [*databases import documents*](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/api::ProjectDatabaseImportDocumentCall), [*databases list*](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/api::ProjectDatabaseListCall), [*databases operations cancel*](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/api::ProjectDatabaseOperationCancelCall), [*databases operations delete*](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/api::ProjectDatabaseOperationDeleteCall), [*databases operations get*](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/api::ProjectDatabaseOperationGetCall), [*databases operations list*](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/api::ProjectDatabaseOperationListCall), [*databases patch*](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/api::ProjectDatabasePatchCall), [*locations get*](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/api::ProjectLocationGetCall) and [*locations list*](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/api::ProjectLocationListCall) @@ -57,8 +57,8 @@ let r = hub.projects().databases_import_documents(...).doit().await let r = hub.projects().databases_patch(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -85,12 +85,12 @@ use firestore1::{Result, Error}; use std::default::Default; use firestore1::{Firestore, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -130,10 +130,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -143,25 +143,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-firest You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/client::Delegate) to the -[Method Builder](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/client::Delegate) to the +[Method Builder](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/client::RequestValue) and -[decodable](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/client::RequestValue) and +[decodable](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-firestore1/5.0.3+20230118/google_firestore1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -180,7 +180,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **firestore1** library was generated by Sebastian Thiel, and is placed +The **firestore1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/firestore1/src/api.rs b/gen/firestore1/src/api.rs index d0889a8e0b..8e4565cc44 100644 --- a/gen/firestore1/src/api.rs +++ b/gen/firestore1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -68,12 +68,12 @@ impl Default for Scope { /// use std::default::Default; /// use firestore1::{Firestore, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/firestore1/src/lib.rs b/gen/firestore1/src/lib.rs index d0ee3aef32..64b267c9da 100644 --- a/gen/firestore1/src/lib.rs +++ b/gen/firestore1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/firestore1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Firestore) ... +//! Handle the following *Resources* with ease from the central [hub](Firestore) ... //! //! * projects //! * [*databases collection groups fields get*](api::ProjectDatabaseCollectionGroupFieldGetCall), [*databases collection groups fields list*](api::ProjectDatabaseCollectionGroupFieldListCall), [*databases collection groups fields patch*](api::ProjectDatabaseCollectionGroupFieldPatchCall), [*databases collection groups indexes create*](api::ProjectDatabaseCollectionGroupIndexCreateCall), [*databases collection groups indexes delete*](api::ProjectDatabaseCollectionGroupIndexDeleteCall), [*databases collection groups indexes get*](api::ProjectDatabaseCollectionGroupIndexGetCall), [*databases collection groups indexes list*](api::ProjectDatabaseCollectionGroupIndexListCall), [*databases create*](api::ProjectDatabaseCreateCall), [*databases delete*](api::ProjectDatabaseDeleteCall), [*databases documents batch get*](api::ProjectDatabaseDocumentBatchGetCall), [*databases documents batch write*](api::ProjectDatabaseDocumentBatchWriteCall), [*databases documents begin transaction*](api::ProjectDatabaseDocumentBeginTransactionCall), [*databases documents commit*](api::ProjectDatabaseDocumentCommitCall), [*databases documents create document*](api::ProjectDatabaseDocumentCreateDocumentCall), [*databases documents delete*](api::ProjectDatabaseDocumentDeleteCall), [*databases documents get*](api::ProjectDatabaseDocumentGetCall), [*databases documents list*](api::ProjectDatabaseDocumentListCall), [*databases documents list collection ids*](api::ProjectDatabaseDocumentListCollectionIdCall), [*databases documents list documents*](api::ProjectDatabaseDocumentListDocumentCall), [*databases documents listen*](api::ProjectDatabaseDocumentListenCall), [*databases documents partition query*](api::ProjectDatabaseDocumentPartitionQueryCall), [*databases documents patch*](api::ProjectDatabaseDocumentPatchCall), [*databases documents rollback*](api::ProjectDatabaseDocumentRollbackCall), [*databases documents run aggregation query*](api::ProjectDatabaseDocumentRunAggregationQueryCall), [*databases documents run query*](api::ProjectDatabaseDocumentRunQueryCall), [*databases documents write*](api::ProjectDatabaseDocumentWriteCall), [*databases export documents*](api::ProjectDatabaseExportDocumentCall), [*databases get*](api::ProjectDatabaseGetCall), [*databases import documents*](api::ProjectDatabaseImportDocumentCall), [*databases list*](api::ProjectDatabaseListCall), [*databases operations cancel*](api::ProjectDatabaseOperationCancelCall), [*databases operations delete*](api::ProjectDatabaseOperationDeleteCall), [*databases operations get*](api::ProjectDatabaseOperationGetCall), [*databases operations list*](api::ProjectDatabaseOperationListCall), [*databases patch*](api::ProjectDatabasePatchCall), [*locations get*](api::ProjectLocationGetCall) and [*locations list*](api::ProjectLocationListCall) @@ -57,8 +57,8 @@ //! let r = hub.projects().databases_patch(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -86,12 +86,12 @@ //! use std::default::Default; //! use firestore1::{Firestore, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -131,10 +131,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -144,25 +144,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/firestore1_beta1/README.md b/gen/firestore1_beta1/README.md index 458d845021..9dd751025b 100644 --- a/gen/firestore1_beta1/README.md +++ b/gen/firestore1_beta1/README.md @@ -11,7 +11,7 @@ Everything else about the *Firestore* *v1_beta1* API can be found at the [official documentation site](https://cloud.google.com/firestore). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-firestore1_beta1/5.0.3+20230118/google_firestore1_beta1/Firestore) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-firestore1_beta1/5.0.3+20230118/google_firestore1_beta1/Firestore) ... * projects * [*databases documents batch get*](https://docs.rs/google-firestore1_beta1/5.0.3+20230118/google_firestore1_beta1/api::ProjectDatabaseDocumentBatchGetCall), [*databases documents batch write*](https://docs.rs/google-firestore1_beta1/5.0.3+20230118/google_firestore1_beta1/api::ProjectDatabaseDocumentBatchWriteCall), [*databases documents begin transaction*](https://docs.rs/google-firestore1_beta1/5.0.3+20230118/google_firestore1_beta1/api::ProjectDatabaseDocumentBeginTransactionCall), [*databases documents commit*](https://docs.rs/google-firestore1_beta1/5.0.3+20230118/google_firestore1_beta1/api::ProjectDatabaseDocumentCommitCall), [*databases documents create document*](https://docs.rs/google-firestore1_beta1/5.0.3+20230118/google_firestore1_beta1/api::ProjectDatabaseDocumentCreateDocumentCall), [*databases documents delete*](https://docs.rs/google-firestore1_beta1/5.0.3+20230118/google_firestore1_beta1/api::ProjectDatabaseDocumentDeleteCall), [*databases documents get*](https://docs.rs/google-firestore1_beta1/5.0.3+20230118/google_firestore1_beta1/api::ProjectDatabaseDocumentGetCall), [*databases documents list*](https://docs.rs/google-firestore1_beta1/5.0.3+20230118/google_firestore1_beta1/api::ProjectDatabaseDocumentListCall), [*databases documents list collection ids*](https://docs.rs/google-firestore1_beta1/5.0.3+20230118/google_firestore1_beta1/api::ProjectDatabaseDocumentListCollectionIdCall), [*databases documents list documents*](https://docs.rs/google-firestore1_beta1/5.0.3+20230118/google_firestore1_beta1/api::ProjectDatabaseDocumentListDocumentCall), [*databases documents listen*](https://docs.rs/google-firestore1_beta1/5.0.3+20230118/google_firestore1_beta1/api::ProjectDatabaseDocumentListenCall), [*databases documents partition query*](https://docs.rs/google-firestore1_beta1/5.0.3+20230118/google_firestore1_beta1/api::ProjectDatabaseDocumentPartitionQueryCall), [*databases documents patch*](https://docs.rs/google-firestore1_beta1/5.0.3+20230118/google_firestore1_beta1/api::ProjectDatabaseDocumentPatchCall), [*databases documents rollback*](https://docs.rs/google-firestore1_beta1/5.0.3+20230118/google_firestore1_beta1/api::ProjectDatabaseDocumentRollbackCall), [*databases documents run aggregation query*](https://docs.rs/google-firestore1_beta1/5.0.3+20230118/google_firestore1_beta1/api::ProjectDatabaseDocumentRunAggregationQueryCall), [*databases documents run query*](https://docs.rs/google-firestore1_beta1/5.0.3+20230118/google_firestore1_beta1/api::ProjectDatabaseDocumentRunQueryCall), [*databases documents write*](https://docs.rs/google-firestore1_beta1/5.0.3+20230118/google_firestore1_beta1/api::ProjectDatabaseDocumentWriteCall), [*databases export documents*](https://docs.rs/google-firestore1_beta1/5.0.3+20230118/google_firestore1_beta1/api::ProjectDatabaseExportDocumentCall), [*databases import documents*](https://docs.rs/google-firestore1_beta1/5.0.3+20230118/google_firestore1_beta1/api::ProjectDatabaseImportDocumentCall), [*databases indexes create*](https://docs.rs/google-firestore1_beta1/5.0.3+20230118/google_firestore1_beta1/api::ProjectDatabaseIndexCreateCall), [*databases indexes delete*](https://docs.rs/google-firestore1_beta1/5.0.3+20230118/google_firestore1_beta1/api::ProjectDatabaseIndexDeleteCall), [*databases indexes get*](https://docs.rs/google-firestore1_beta1/5.0.3+20230118/google_firestore1_beta1/api::ProjectDatabaseIndexGetCall) and [*databases indexes list*](https://docs.rs/google-firestore1_beta1/5.0.3+20230118/google_firestore1_beta1/api::ProjectDatabaseIndexListCall) @@ -52,8 +52,8 @@ let r = hub.projects().databases_export_documents(...).doit().await let r = hub.projects().databases_import_documents(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -81,12 +81,12 @@ use firestore1_beta1::{Result, Error}; use std::default::Default; use firestore1_beta1::{Firestore, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -127,10 +127,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-firestore1_beta1/5.0.3+20230118/google_firestore1_beta1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-firestore1_beta1/5.0.3+20230118/google_firestore1_beta1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -140,25 +140,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-firest You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-firestore1_beta1/5.0.3+20230118/google_firestore1_beta1/client::Delegate) to the -[Method Builder](https://docs.rs/google-firestore1_beta1/5.0.3+20230118/google_firestore1_beta1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-firestore1_beta1/5.0.3+20230118/google_firestore1_beta1/client::Delegate) to the +[Method Builder](https://docs.rs/google-firestore1_beta1/5.0.3+20230118/google_firestore1_beta1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-firestore1_beta1/5.0.3+20230118/google_firestore1_beta1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-firestore1_beta1/5.0.3+20230118/google_firestore1_beta1/client::RequestValue) and -[decodable](https://docs.rs/google-firestore1_beta1/5.0.3+20230118/google_firestore1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-firestore1_beta1/5.0.3+20230118/google_firestore1_beta1/client::RequestValue) and +[decodable](https://docs.rs/google-firestore1_beta1/5.0.3+20230118/google_firestore1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-firestore1_beta1/5.0.3+20230118/google_firestore1_beta1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-firestore1_beta1/5.0.3+20230118/google_firestore1_beta1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -177,7 +177,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **firestore1_beta1** library was generated by Sebastian Thiel, and is placed +The **firestore1_beta1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/firestore1_beta1/src/api.rs b/gen/firestore1_beta1/src/api.rs index bbb0692708..405609e739 100644 --- a/gen/firestore1_beta1/src/api.rs +++ b/gen/firestore1_beta1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use firestore1_beta1::{Firestore, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/firestore1_beta1/src/lib.rs b/gen/firestore1_beta1/src/lib.rs index a3cfe305a9..20ad5ccbd2 100644 --- a/gen/firestore1_beta1/src/lib.rs +++ b/gen/firestore1_beta1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/firestore1_beta1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Firestore) ... +//! Handle the following *Resources* with ease from the central [hub](Firestore) ... //! //! * projects //! * [*databases documents batch get*](api::ProjectDatabaseDocumentBatchGetCall), [*databases documents batch write*](api::ProjectDatabaseDocumentBatchWriteCall), [*databases documents begin transaction*](api::ProjectDatabaseDocumentBeginTransactionCall), [*databases documents commit*](api::ProjectDatabaseDocumentCommitCall), [*databases documents create document*](api::ProjectDatabaseDocumentCreateDocumentCall), [*databases documents delete*](api::ProjectDatabaseDocumentDeleteCall), [*databases documents get*](api::ProjectDatabaseDocumentGetCall), [*databases documents list*](api::ProjectDatabaseDocumentListCall), [*databases documents list collection ids*](api::ProjectDatabaseDocumentListCollectionIdCall), [*databases documents list documents*](api::ProjectDatabaseDocumentListDocumentCall), [*databases documents listen*](api::ProjectDatabaseDocumentListenCall), [*databases documents partition query*](api::ProjectDatabaseDocumentPartitionQueryCall), [*databases documents patch*](api::ProjectDatabaseDocumentPatchCall), [*databases documents rollback*](api::ProjectDatabaseDocumentRollbackCall), [*databases documents run aggregation query*](api::ProjectDatabaseDocumentRunAggregationQueryCall), [*databases documents run query*](api::ProjectDatabaseDocumentRunQueryCall), [*databases documents write*](api::ProjectDatabaseDocumentWriteCall), [*databases export documents*](api::ProjectDatabaseExportDocumentCall), [*databases import documents*](api::ProjectDatabaseImportDocumentCall), [*databases indexes create*](api::ProjectDatabaseIndexCreateCall), [*databases indexes delete*](api::ProjectDatabaseIndexDeleteCall), [*databases indexes get*](api::ProjectDatabaseIndexGetCall) and [*databases indexes list*](api::ProjectDatabaseIndexListCall) @@ -52,8 +52,8 @@ //! let r = hub.projects().databases_import_documents(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -82,12 +82,12 @@ //! use std::default::Default; //! use firestore1_beta1::{Firestore, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -128,10 +128,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -141,25 +141,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/fitness1/README.md b/gen/fitness1/README.md index 8c8426a562..9837ef7165 100644 --- a/gen/fitness1/README.md +++ b/gen/fitness1/README.md @@ -11,7 +11,7 @@ Everything else about the *fitness* *v1* API can be found at the [official documentation site](https://developers.google.com/fit/rest/v1/get-started). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-fitness1/5.0.3+20230120/google_fitness1/Fitness) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-fitness1/5.0.3+20230120/google_fitness1/Fitness) ... * users * [*data sources create*](https://docs.rs/google-fitness1/5.0.3+20230120/google_fitness1/api::UserDataSourceCreateCall), [*data sources data point changes list*](https://docs.rs/google-fitness1/5.0.3+20230120/google_fitness1/api::UserDataSourceDataPointChangeListCall), [*data sources datasets delete*](https://docs.rs/google-fitness1/5.0.3+20230120/google_fitness1/api::UserDataSourceDatasetDeleteCall), [*data sources datasets get*](https://docs.rs/google-fitness1/5.0.3+20230120/google_fitness1/api::UserDataSourceDatasetGetCall), [*data sources datasets patch*](https://docs.rs/google-fitness1/5.0.3+20230120/google_fitness1/api::UserDataSourceDatasetPatchCall), [*data sources delete*](https://docs.rs/google-fitness1/5.0.3+20230120/google_fitness1/api::UserDataSourceDeleteCall), [*data sources get*](https://docs.rs/google-fitness1/5.0.3+20230120/google_fitness1/api::UserDataSourceGetCall), [*data sources list*](https://docs.rs/google-fitness1/5.0.3+20230120/google_fitness1/api::UserDataSourceListCall), [*data sources update*](https://docs.rs/google-fitness1/5.0.3+20230120/google_fitness1/api::UserDataSourceUpdateCall), [*dataset aggregate*](https://docs.rs/google-fitness1/5.0.3+20230120/google_fitness1/api::UserDatasetAggregateCall), [*sessions delete*](https://docs.rs/google-fitness1/5.0.3+20230120/google_fitness1/api::UserSessionDeleteCall), [*sessions list*](https://docs.rs/google-fitness1/5.0.3+20230120/google_fitness1/api::UserSessionListCall) and [*sessions update*](https://docs.rs/google-fitness1/5.0.3+20230120/google_fitness1/api::UserSessionUpdateCall) @@ -53,8 +53,8 @@ let r = hub.users().data_sources_get(...).doit().await let r = hub.users().data_sources_update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -82,12 +82,12 @@ use fitness1::{Result, Error}; use std::default::Default; use fitness1::{Fitness, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -128,10 +128,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-fitness1/5.0.3+20230120/google_fitness1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-fitness1/5.0.3+20230120/google_fitness1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -141,25 +141,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-fitnes You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-fitness1/5.0.3+20230120/google_fitness1/client::Delegate) to the -[Method Builder](https://docs.rs/google-fitness1/5.0.3+20230120/google_fitness1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-fitness1/5.0.3+20230120/google_fitness1/client::Delegate) to the +[Method Builder](https://docs.rs/google-fitness1/5.0.3+20230120/google_fitness1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-fitness1/5.0.3+20230120/google_fitness1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-fitness1/5.0.3+20230120/google_fitness1/client::RequestValue) and -[decodable](https://docs.rs/google-fitness1/5.0.3+20230120/google_fitness1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-fitness1/5.0.3+20230120/google_fitness1/client::RequestValue) and +[decodable](https://docs.rs/google-fitness1/5.0.3+20230120/google_fitness1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-fitness1/5.0.3+20230120/google_fitness1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-fitness1/5.0.3+20230120/google_fitness1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -178,7 +178,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **fitness1** library was generated by Sebastian Thiel, and is placed +The **fitness1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/fitness1/src/api.rs b/gen/fitness1/src/api.rs index 0c629d9e06..d649eb5520 100644 --- a/gen/fitness1/src/api.rs +++ b/gen/fitness1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// Use Google Fit to see and store your physical activity data ActivityRead, @@ -149,12 +149,12 @@ impl Default for Scope { /// use std::default::Default; /// use fitness1::{Fitness, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/fitness1/src/lib.rs b/gen/fitness1/src/lib.rs index 565ca4a157..f09843e56c 100644 --- a/gen/fitness1/src/lib.rs +++ b/gen/fitness1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/fitness1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Fitness) ... +//! Handle the following *Resources* with ease from the central [hub](Fitness) ... //! //! * users //! * [*data sources create*](api::UserDataSourceCreateCall), [*data sources data point changes list*](api::UserDataSourceDataPointChangeListCall), [*data sources datasets delete*](api::UserDataSourceDatasetDeleteCall), [*data sources datasets get*](api::UserDataSourceDatasetGetCall), [*data sources datasets patch*](api::UserDataSourceDatasetPatchCall), [*data sources delete*](api::UserDataSourceDeleteCall), [*data sources get*](api::UserDataSourceGetCall), [*data sources list*](api::UserDataSourceListCall), [*data sources update*](api::UserDataSourceUpdateCall), [*dataset aggregate*](api::UserDatasetAggregateCall), [*sessions delete*](api::UserSessionDeleteCall), [*sessions list*](api::UserSessionListCall) and [*sessions update*](api::UserSessionUpdateCall) @@ -53,8 +53,8 @@ //! let r = hub.users().data_sources_update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -83,12 +83,12 @@ //! use std::default::Default; //! use fitness1::{Fitness, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -129,10 +129,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -142,25 +142,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/fusiontables2/README.md b/gen/fusiontables2/README.md index 3d2ebd1ce1..77b0d0fc88 100644 --- a/gen/fusiontables2/README.md +++ b/gen/fusiontables2/README.md @@ -11,7 +11,7 @@ Everything else about the *fusiontables* *v2* API can be found at the [official documentation site](https://developers.google.com/fusiontables). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-fusiontables2/5.0.3+20171117/google_fusiontables2/Fusiontables) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-fusiontables2/5.0.3+20171117/google_fusiontables2/Fusiontables) ... * [column](https://docs.rs/google-fusiontables2/5.0.3+20171117/google_fusiontables2/api::Column) * [*delete*](https://docs.rs/google-fusiontables2/5.0.3+20171117/google_fusiontables2/api::ColumnDeleteCall), [*get*](https://docs.rs/google-fusiontables2/5.0.3+20171117/google_fusiontables2/api::ColumnGetCall), [*insert*](https://docs.rs/google-fusiontables2/5.0.3+20171117/google_fusiontables2/api::ColumnInsertCall), [*list*](https://docs.rs/google-fusiontables2/5.0.3+20171117/google_fusiontables2/api::ColumnListCall), [*patch*](https://docs.rs/google-fusiontables2/5.0.3+20171117/google_fusiontables2/api::ColumnPatchCall) and [*update*](https://docs.rs/google-fusiontables2/5.0.3+20171117/google_fusiontables2/api::ColumnUpdateCall) @@ -76,8 +76,8 @@ let r = hub.table().patch(...).doit().await let r = hub.table().update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -105,12 +105,12 @@ use std::fs; use std::default::Default; use fusiontables2::{Fusiontables, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -148,10 +148,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-fusiontables2/5.0.3+20171117/google_fusiontables2/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-fusiontables2/5.0.3+20171117/google_fusiontables2/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -161,25 +161,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-fusion You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-fusiontables2/5.0.3+20171117/google_fusiontables2/client::Delegate) to the -[Method Builder](https://docs.rs/google-fusiontables2/5.0.3+20171117/google_fusiontables2/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-fusiontables2/5.0.3+20171117/google_fusiontables2/client::Delegate) to the +[Method Builder](https://docs.rs/google-fusiontables2/5.0.3+20171117/google_fusiontables2/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-fusiontables2/5.0.3+20171117/google_fusiontables2/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-fusiontables2/5.0.3+20171117/google_fusiontables2/client::RequestValue) and -[decodable](https://docs.rs/google-fusiontables2/5.0.3+20171117/google_fusiontables2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-fusiontables2/5.0.3+20171117/google_fusiontables2/client::RequestValue) and +[decodable](https://docs.rs/google-fusiontables2/5.0.3+20171117/google_fusiontables2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-fusiontables2/5.0.3+20171117/google_fusiontables2/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-fusiontables2/5.0.3+20171117/google_fusiontables2/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -198,7 +198,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **fusiontables2** library was generated by Sebastian Thiel, and is placed +The **fusiontables2** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/fusiontables2/src/api.rs b/gen/fusiontables2/src/api.rs index 2d472c1d42..73eccd3872 100644 --- a/gen/fusiontables2/src/api.rs +++ b/gen/fusiontables2/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// Manage your Fusion Tables Full, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use fusiontables2::{Fusiontables, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/fusiontables2/src/lib.rs b/gen/fusiontables2/src/lib.rs index 016e2df9ac..3eae958f3f 100644 --- a/gen/fusiontables2/src/lib.rs +++ b/gen/fusiontables2/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/fusiontables2). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Fusiontables) ... +//! Handle the following *Resources* with ease from the central [hub](Fusiontables) ... //! //! * [column](api::Column) //! * [*delete*](api::ColumnDeleteCall), [*get*](api::ColumnGetCall), [*insert*](api::ColumnInsertCall), [*list*](api::ColumnListCall), [*patch*](api::ColumnPatchCall) and [*update*](api::ColumnUpdateCall) @@ -76,8 +76,8 @@ //! let r = hub.table().update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -106,12 +106,12 @@ //! use std::default::Default; //! use fusiontables2::{Fusiontables, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -149,10 +149,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -162,25 +162,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/games1/README.md b/gen/games1/README.md index baca422ccd..3915960b6e 100644 --- a/gen/games1/README.md +++ b/gen/games1/README.md @@ -11,7 +11,7 @@ Everything else about the *Games* *v1* API can be found at the [official documentation site](https://developers.google.com/games/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-games1/5.0.3+20230112/google_games1/Games) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-games1/5.0.3+20230112/google_games1/Games) ... * [achievement definitions](https://docs.rs/google-games1/5.0.3+20230112/google_games1/api::AchievementDefinition) * [*list*](https://docs.rs/google-games1/5.0.3+20230112/google_games1/api::AchievementDefinitionListCall) @@ -73,8 +73,8 @@ let r = hub.applications().played(...).doit().await let r = hub.applications().verify(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -101,12 +101,12 @@ use games1::{Result, Error}; use std::default::Default; use games1::{Games, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -144,10 +144,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-games1/5.0.3+20230112/google_games1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-games1/5.0.3+20230112/google_games1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -157,25 +157,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-games1 You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-games1/5.0.3+20230112/google_games1/client::Delegate) to the -[Method Builder](https://docs.rs/google-games1/5.0.3+20230112/google_games1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-games1/5.0.3+20230112/google_games1/client::Delegate) to the +[Method Builder](https://docs.rs/google-games1/5.0.3+20230112/google_games1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-games1/5.0.3+20230112/google_games1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-games1/5.0.3+20230112/google_games1/client::RequestValue) and -[decodable](https://docs.rs/google-games1/5.0.3+20230112/google_games1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-games1/5.0.3+20230112/google_games1/client::RequestValue) and +[decodable](https://docs.rs/google-games1/5.0.3+20230112/google_games1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-games1/5.0.3+20230112/google_games1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-games1/5.0.3+20230112/google_games1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -194,7 +194,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **games1** library was generated by Sebastian Thiel, and is placed +The **games1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/games1/src/api.rs b/gen/games1/src/api.rs index b50521e4f5..6993f20ab9 100644 --- a/gen/games1/src/api.rs +++ b/gen/games1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, create, and delete its own configuration data in your Google Drive DriveAppdata, @@ -68,12 +68,12 @@ impl Default for Scope { /// use std::default::Default; /// use games1::{Games, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/games1/src/lib.rs b/gen/games1/src/lib.rs index 81ebaaa853..52f492205c 100644 --- a/gen/games1/src/lib.rs +++ b/gen/games1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/games1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Games) ... +//! Handle the following *Resources* with ease from the central [hub](Games) ... //! //! * [achievement definitions](api::AchievementDefinition) //! * [*list*](api::AchievementDefinitionListCall) @@ -73,8 +73,8 @@ //! let r = hub.applications().verify(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -102,12 +102,12 @@ //! use std::default::Default; //! use games1::{Games, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -145,10 +145,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -158,25 +158,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/gamesconfiguration1_configuration/README.md b/gen/gamesconfiguration1_configuration/README.md index 36c5f00c3b..a5e1d5033b 100644 --- a/gen/gamesconfiguration1_configuration/README.md +++ b/gen/gamesconfiguration1_configuration/README.md @@ -11,7 +11,7 @@ Everything else about the *Games Configuration* *v1_configuration* API can be fo [official documentation site](https://developers.google.com/games/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-gamesconfiguration1_configuration/5.0.3+20230112/google_gamesconfiguration1_configuration/GamesConfiguration) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-gamesconfiguration1_configuration/5.0.3+20230112/google_gamesconfiguration1_configuration/GamesConfiguration) ... * [achievement configurations](https://docs.rs/google-gamesconfiguration1_configuration/5.0.3+20230112/google_gamesconfiguration1_configuration/api::AchievementConfiguration) * [*delete*](https://docs.rs/google-gamesconfiguration1_configuration/5.0.3+20230112/google_gamesconfiguration1_configuration/api::AchievementConfigurationDeleteCall), [*get*](https://docs.rs/google-gamesconfiguration1_configuration/5.0.3+20230112/google_gamesconfiguration1_configuration/api::AchievementConfigurationGetCall), [*insert*](https://docs.rs/google-gamesconfiguration1_configuration/5.0.3+20230112/google_gamesconfiguration1_configuration/api::AchievementConfigurationInsertCall), [*list*](https://docs.rs/google-gamesconfiguration1_configuration/5.0.3+20230112/google_gamesconfiguration1_configuration/api::AchievementConfigurationListCall) and [*update*](https://docs.rs/google-gamesconfiguration1_configuration/5.0.3+20230112/google_gamesconfiguration1_configuration/api::AchievementConfigurationUpdateCall) @@ -56,8 +56,8 @@ let r = hub.achievement_configurations().list(...).doit().await let r = hub.achievement_configurations().update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -84,12 +84,12 @@ use gamesconfiguration1_configuration::{Result, Error}; use std::default::Default; use gamesconfiguration1_configuration::{GamesConfiguration, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -127,10 +127,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-gamesconfiguration1_configuration/5.0.3+20230112/google_gamesconfiguration1_configuration/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-gamesconfiguration1_configuration/5.0.3+20230112/google_gamesconfiguration1_configuration/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -140,25 +140,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-gamesc You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-gamesconfiguration1_configuration/5.0.3+20230112/google_gamesconfiguration1_configuration/client::Delegate) to the -[Method Builder](https://docs.rs/google-gamesconfiguration1_configuration/5.0.3+20230112/google_gamesconfiguration1_configuration/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-gamesconfiguration1_configuration/5.0.3+20230112/google_gamesconfiguration1_configuration/client::Delegate) to the +[Method Builder](https://docs.rs/google-gamesconfiguration1_configuration/5.0.3+20230112/google_gamesconfiguration1_configuration/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-gamesconfiguration1_configuration/5.0.3+20230112/google_gamesconfiguration1_configuration/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-gamesconfiguration1_configuration/5.0.3+20230112/google_gamesconfiguration1_configuration/client::RequestValue) and -[decodable](https://docs.rs/google-gamesconfiguration1_configuration/5.0.3+20230112/google_gamesconfiguration1_configuration/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-gamesconfiguration1_configuration/5.0.3+20230112/google_gamesconfiguration1_configuration/client::RequestValue) and +[decodable](https://docs.rs/google-gamesconfiguration1_configuration/5.0.3+20230112/google_gamesconfiguration1_configuration/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-gamesconfiguration1_configuration/5.0.3+20230112/google_gamesconfiguration1_configuration/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-gamesconfiguration1_configuration/5.0.3+20230112/google_gamesconfiguration1_configuration/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -177,7 +177,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **gamesconfiguration1_configuration** library was generated by Sebastian Thiel, and is placed +The **gamesconfiguration1_configuration** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/gamesconfiguration1_configuration/src/api.rs b/gen/gamesconfiguration1_configuration/src/api.rs index c1d764472c..7b5f7a456a 100644 --- a/gen/gamesconfiguration1_configuration/src/api.rs +++ b/gen/gamesconfiguration1_configuration/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your Google Play Developer account Androidpublisher, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use gamesconfiguration1_configuration::{GamesConfiguration, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/gamesconfiguration1_configuration/src/lib.rs b/gen/gamesconfiguration1_configuration/src/lib.rs index 471685bc69..fe70715af8 100644 --- a/gen/gamesconfiguration1_configuration/src/lib.rs +++ b/gen/gamesconfiguration1_configuration/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/gamesconfiguration1_configuration). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](GamesConfiguration) ... +//! Handle the following *Resources* with ease from the central [hub](GamesConfiguration) ... //! //! * [achievement configurations](api::AchievementConfiguration) //! * [*delete*](api::AchievementConfigurationDeleteCall), [*get*](api::AchievementConfigurationGetCall), [*insert*](api::AchievementConfigurationInsertCall), [*list*](api::AchievementConfigurationListCall) and [*update*](api::AchievementConfigurationUpdateCall) @@ -56,8 +56,8 @@ //! let r = hub.achievement_configurations().update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -85,12 +85,12 @@ //! use std::default::Default; //! use gamesconfiguration1_configuration::{GamesConfiguration, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -128,10 +128,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -141,25 +141,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/gameservices1/README.md b/gen/gameservices1/README.md index 41d0300f51..4b2326a13b 100644 --- a/gen/gameservices1/README.md +++ b/gen/gameservices1/README.md @@ -11,7 +11,7 @@ Everything else about the *Game Services* *v1* API can be found at the [official documentation site](https://cloud.google.com/solutions/gaming/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-gameservices1/5.0.3+20230105/google_gameservices1/GameServices) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-gameservices1/5.0.3+20230105/google_gameservices1/GameServices) ... * projects * [*locations game server deployments get iam policy*](https://docs.rs/google-gameservices1/5.0.3+20230105/google_gameservices1/api::ProjectLocationGameServerDeploymentGetIamPolicyCall), [*locations game server deployments set iam policy*](https://docs.rs/google-gameservices1/5.0.3+20230105/google_gameservices1/api::ProjectLocationGameServerDeploymentSetIamPolicyCall), [*locations game server deployments test iam permissions*](https://docs.rs/google-gameservices1/5.0.3+20230105/google_gameservices1/api::ProjectLocationGameServerDeploymentTestIamPermissionCall), [*locations get*](https://docs.rs/google-gameservices1/5.0.3+20230105/google_gameservices1/api::ProjectLocationGetCall), [*locations list*](https://docs.rs/google-gameservices1/5.0.3+20230105/google_gameservices1/api::ProjectLocationListCall), [*locations operations cancel*](https://docs.rs/google-gameservices1/5.0.3+20230105/google_gameservices1/api::ProjectLocationOperationCancelCall), [*locations operations delete*](https://docs.rs/google-gameservices1/5.0.3+20230105/google_gameservices1/api::ProjectLocationOperationDeleteCall), [*locations operations get*](https://docs.rs/google-gameservices1/5.0.3+20230105/google_gameservices1/api::ProjectLocationOperationGetCall) and [*locations operations list*](https://docs.rs/google-gameservices1/5.0.3+20230105/google_gameservices1/api::ProjectLocationOperationListCall) @@ -51,8 +51,8 @@ let r = hub.projects().locations_game_server_deployments_get_iam_policy(...).doi let r = hub.projects().locations_game_server_deployments_set_iam_policy(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -79,12 +79,12 @@ use gameservices1::{Result, Error}; use std::default::Default; use gameservices1::{GameServices, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -121,10 +121,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-gameservices1/5.0.3+20230105/google_gameservices1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-gameservices1/5.0.3+20230105/google_gameservices1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -134,25 +134,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-gamese You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-gameservices1/5.0.3+20230105/google_gameservices1/client::Delegate) to the -[Method Builder](https://docs.rs/google-gameservices1/5.0.3+20230105/google_gameservices1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-gameservices1/5.0.3+20230105/google_gameservices1/client::Delegate) to the +[Method Builder](https://docs.rs/google-gameservices1/5.0.3+20230105/google_gameservices1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-gameservices1/5.0.3+20230105/google_gameservices1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-gameservices1/5.0.3+20230105/google_gameservices1/client::RequestValue) and -[decodable](https://docs.rs/google-gameservices1/5.0.3+20230105/google_gameservices1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-gameservices1/5.0.3+20230105/google_gameservices1/client::RequestValue) and +[decodable](https://docs.rs/google-gameservices1/5.0.3+20230105/google_gameservices1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-gameservices1/5.0.3+20230105/google_gameservices1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-gameservices1/5.0.3+20230105/google_gameservices1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -171,7 +171,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **gameservices1** library was generated by Sebastian Thiel, and is placed +The **gameservices1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/gameservices1/src/api.rs b/gen/gameservices1/src/api.rs index 506e0db728..98937e758a 100644 --- a/gen/gameservices1/src/api.rs +++ b/gen/gameservices1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use gameservices1::{GameServices, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/gameservices1/src/lib.rs b/gen/gameservices1/src/lib.rs index 971e8b1caa..659e17c9fd 100644 --- a/gen/gameservices1/src/lib.rs +++ b/gen/gameservices1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/gameservices1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](GameServices) ... +//! Handle the following *Resources* with ease from the central [hub](GameServices) ... //! //! * projects //! * [*locations game server deployments get iam policy*](api::ProjectLocationGameServerDeploymentGetIamPolicyCall), [*locations game server deployments set iam policy*](api::ProjectLocationGameServerDeploymentSetIamPolicyCall), [*locations game server deployments test iam permissions*](api::ProjectLocationGameServerDeploymentTestIamPermissionCall), [*locations get*](api::ProjectLocationGetCall), [*locations list*](api::ProjectLocationListCall), [*locations operations cancel*](api::ProjectLocationOperationCancelCall), [*locations operations delete*](api::ProjectLocationOperationDeleteCall), [*locations operations get*](api::ProjectLocationOperationGetCall) and [*locations operations list*](api::ProjectLocationOperationListCall) @@ -51,8 +51,8 @@ //! let r = hub.projects().locations_game_server_deployments_set_iam_policy(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -80,12 +80,12 @@ //! use std::default::Default; //! use gameservices1::{GameServices, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -122,10 +122,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -135,25 +135,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/gamesmanagement1_management/README.md b/gen/gamesmanagement1_management/README.md index 9c147e297b..218337d088 100644 --- a/gen/gamesmanagement1_management/README.md +++ b/gen/gamesmanagement1_management/README.md @@ -11,7 +11,7 @@ Everything else about the *Games Management* *v1_management* API can be found at [official documentation site](https://developers.google.com/games/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-gamesmanagement1_management/5.0.3+20230112/google_gamesmanagement1_management/GamesManagement) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-gamesmanagement1_management/5.0.3+20230112/google_gamesmanagement1_management/GamesManagement) ... * achievements * [*reset*](https://docs.rs/google-gamesmanagement1_management/5.0.3+20230112/google_gamesmanagement1_management/api::AchievementResetCall), [*reset all*](https://docs.rs/google-gamesmanagement1_management/5.0.3+20230112/google_gamesmanagement1_management/api::AchievementResetAllCall), [*reset all for all players*](https://docs.rs/google-gamesmanagement1_management/5.0.3+20230112/google_gamesmanagement1_management/api::AchievementResetAllForAllPlayerCall), [*reset for all players*](https://docs.rs/google-gamesmanagement1_management/5.0.3+20230112/google_gamesmanagement1_management/api::AchievementResetForAllPlayerCall) and [*reset multiple for all players*](https://docs.rs/google-gamesmanagement1_management/5.0.3+20230112/google_gamesmanagement1_management/api::AchievementResetMultipleForAllPlayerCall) @@ -59,8 +59,8 @@ let r = hub.players().hide(...).doit().await let r = hub.players().unhide(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -87,12 +87,12 @@ use gamesmanagement1_management::{Result, Error}; use std::default::Default; use gamesmanagement1_management::{GamesManagement, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -128,10 +128,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-gamesmanagement1_management/5.0.3+20230112/google_gamesmanagement1_management/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-gamesmanagement1_management/5.0.3+20230112/google_gamesmanagement1_management/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -141,25 +141,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-gamesm You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-gamesmanagement1_management/5.0.3+20230112/google_gamesmanagement1_management/client::Delegate) to the -[Method Builder](https://docs.rs/google-gamesmanagement1_management/5.0.3+20230112/google_gamesmanagement1_management/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-gamesmanagement1_management/5.0.3+20230112/google_gamesmanagement1_management/client::Delegate) to the +[Method Builder](https://docs.rs/google-gamesmanagement1_management/5.0.3+20230112/google_gamesmanagement1_management/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-gamesmanagement1_management/5.0.3+20230112/google_gamesmanagement1_management/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-gamesmanagement1_management/5.0.3+20230112/google_gamesmanagement1_management/client::RequestValue) and -[decodable](https://docs.rs/google-gamesmanagement1_management/5.0.3+20230112/google_gamesmanagement1_management/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-gamesmanagement1_management/5.0.3+20230112/google_gamesmanagement1_management/client::RequestValue) and +[decodable](https://docs.rs/google-gamesmanagement1_management/5.0.3+20230112/google_gamesmanagement1_management/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-gamesmanagement1_management/5.0.3+20230112/google_gamesmanagement1_management/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-gamesmanagement1_management/5.0.3+20230112/google_gamesmanagement1_management/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -178,7 +178,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **gamesmanagement1_management** library was generated by Sebastian Thiel, and is placed +The **gamesmanagement1_management** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/gamesmanagement1_management/src/api.rs b/gen/gamesmanagement1_management/src/api.rs index 0a038de2cd..213694a409 100644 --- a/gen/gamesmanagement1_management/src/api.rs +++ b/gen/gamesmanagement1_management/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// Create, edit, and delete your Google Play Games activity Game, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use gamesmanagement1_management::{GamesManagement, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/gamesmanagement1_management/src/lib.rs b/gen/gamesmanagement1_management/src/lib.rs index fdb008f23e..bc3fccc2dd 100644 --- a/gen/gamesmanagement1_management/src/lib.rs +++ b/gen/gamesmanagement1_management/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/gamesmanagement1_management). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](GamesManagement) ... +//! Handle the following *Resources* with ease from the central [hub](GamesManagement) ... //! //! * achievements //! * [*reset*](api::AchievementResetCall), [*reset all*](api::AchievementResetAllCall), [*reset all for all players*](api::AchievementResetAllForAllPlayerCall), [*reset for all players*](api::AchievementResetForAllPlayerCall) and [*reset multiple for all players*](api::AchievementResetMultipleForAllPlayerCall) @@ -59,8 +59,8 @@ //! let r = hub.players().unhide(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -88,12 +88,12 @@ //! use std::default::Default; //! use gamesmanagement1_management::{GamesManagement, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -129,10 +129,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -142,25 +142,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/gan1_beta1/README.md b/gen/gan1_beta1/README.md index f497ceaa4a..d5d1d27a98 100644 --- a/gen/gan1_beta1/README.md +++ b/gen/gan1_beta1/README.md @@ -11,7 +11,7 @@ Everything else about the *gan* *v1_beta1* API can be found at the [official documentation site](https://developers.google.com/affiliate-network/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-gan1_beta1/5.0.3+20130205/google_gan1_beta1/Gan) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-gan1_beta1/5.0.3+20130205/google_gan1_beta1/Gan) ... * [advertisers](https://docs.rs/google-gan1_beta1/5.0.3+20130205/google_gan1_beta1/api::Advertiser) * [*get*](https://docs.rs/google-gan1_beta1/5.0.3+20130205/google_gan1_beta1/api::AdvertiserGetCall) and [*list*](https://docs.rs/google-gan1_beta1/5.0.3+20130205/google_gan1_beta1/api::AdvertiserListCall) @@ -62,8 +62,8 @@ let r = hub.links().insert(...).doit().await let r = hub.links().list(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -90,12 +90,12 @@ use gan1_beta1::{Result, Error}; use std::default::Default; use gan1_beta1::{Gan, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -144,10 +144,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-gan1_beta1/5.0.3+20130205/google_gan1_beta1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-gan1_beta1/5.0.3+20130205/google_gan1_beta1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -157,25 +157,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-gan1_b You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-gan1_beta1/5.0.3+20130205/google_gan1_beta1/client::Delegate) to the -[Method Builder](https://docs.rs/google-gan1_beta1/5.0.3+20130205/google_gan1_beta1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-gan1_beta1/5.0.3+20130205/google_gan1_beta1/client::Delegate) to the +[Method Builder](https://docs.rs/google-gan1_beta1/5.0.3+20130205/google_gan1_beta1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-gan1_beta1/5.0.3+20130205/google_gan1_beta1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-gan1_beta1/5.0.3+20130205/google_gan1_beta1/client::RequestValue) and -[decodable](https://docs.rs/google-gan1_beta1/5.0.3+20130205/google_gan1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-gan1_beta1/5.0.3+20130205/google_gan1_beta1/client::RequestValue) and +[decodable](https://docs.rs/google-gan1_beta1/5.0.3+20130205/google_gan1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-gan1_beta1/5.0.3+20130205/google_gan1_beta1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-gan1_beta1/5.0.3+20130205/google_gan1_beta1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -194,7 +194,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **gan1_beta1** library was generated by Sebastian Thiel, and is placed +The **gan1_beta1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/gan1_beta1/src/api.rs b/gen/gan1_beta1/src/api.rs index c37b409956..1736ace0fe 100644 --- a/gen/gan1_beta1/src/api.rs +++ b/gen/gan1_beta1/src/api.rs @@ -42,12 +42,12 @@ use crate::{client, client::GetToken, client::serde_with}; /// use std::default::Default; /// use gan1_beta1::{Gan, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/gan1_beta1/src/lib.rs b/gen/gan1_beta1/src/lib.rs index 03b495aaca..ff6273dc3a 100644 --- a/gen/gan1_beta1/src/lib.rs +++ b/gen/gan1_beta1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/gan1_beta1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Gan) ... +//! Handle the following *Resources* with ease from the central [hub](Gan) ... //! //! * [advertisers](api::Advertiser) //! * [*get*](api::AdvertiserGetCall) and [*list*](api::AdvertiserListCall) @@ -62,8 +62,8 @@ //! let r = hub.links().list(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -91,12 +91,12 @@ //! use std::default::Default; //! use gan1_beta1::{Gan, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -145,10 +145,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -158,25 +158,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/genomics1/README.md b/gen/genomics1/README.md index 7f332b7c95..4140d8dfec 100644 --- a/gen/genomics1/README.md +++ b/gen/genomics1/README.md @@ -11,7 +11,7 @@ Everything else about the *genomics* *v1* API can be found at the [official documentation site](https://cloud.google.com/genomics). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-genomics1/5.0.3+20210324/google_genomics1/Genomics) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-genomics1/5.0.3+20210324/google_genomics1/Genomics) ... * [operations](https://docs.rs/google-genomics1/5.0.3+20210324/google_genomics1/api::Operation) * [*cancel*](https://docs.rs/google-genomics1/5.0.3+20210324/google_genomics1/api::OperationCancelCall), [*get*](https://docs.rs/google-genomics1/5.0.3+20210324/google_genomics1/api::OperationGetCall) and [*list*](https://docs.rs/google-genomics1/5.0.3+20210324/google_genomics1/api::OperationListCall) @@ -52,8 +52,8 @@ let r = hub.operations().get(...).doit().await let r = hub.operations().list(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -80,12 +80,12 @@ use genomics1::{Result, Error}; use std::default::Default; use genomics1::{Genomics, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -124,10 +124,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-genomics1/5.0.3+20210324/google_genomics1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-genomics1/5.0.3+20210324/google_genomics1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -137,25 +137,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-genomi You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-genomics1/5.0.3+20210324/google_genomics1/client::Delegate) to the -[Method Builder](https://docs.rs/google-genomics1/5.0.3+20210324/google_genomics1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-genomics1/5.0.3+20210324/google_genomics1/client::Delegate) to the +[Method Builder](https://docs.rs/google-genomics1/5.0.3+20210324/google_genomics1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-genomics1/5.0.3+20210324/google_genomics1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-genomics1/5.0.3+20210324/google_genomics1/client::RequestValue) and -[decodable](https://docs.rs/google-genomics1/5.0.3+20210324/google_genomics1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-genomics1/5.0.3+20210324/google_genomics1/client::RequestValue) and +[decodable](https://docs.rs/google-genomics1/5.0.3+20210324/google_genomics1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-genomics1/5.0.3+20210324/google_genomics1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-genomics1/5.0.3+20210324/google_genomics1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -174,7 +174,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **genomics1** library was generated by Sebastian Thiel, and is placed +The **genomics1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/genomics1/src/api.rs b/gen/genomics1/src/api.rs index a252190bd3..cfd5e509ac 100644 --- a/gen/genomics1/src/api.rs +++ b/gen/genomics1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud Platform data CloudPlatform, @@ -68,12 +68,12 @@ impl Default for Scope { /// use std::default::Default; /// use genomics1::{Genomics, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/genomics1/src/lib.rs b/gen/genomics1/src/lib.rs index d68932279a..3b1ad0d433 100644 --- a/gen/genomics1/src/lib.rs +++ b/gen/genomics1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/genomics1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Genomics) ... +//! Handle the following *Resources* with ease from the central [hub](Genomics) ... //! //! * [operations](api::Operation) //! * [*cancel*](api::OperationCancelCall), [*get*](api::OperationGetCall) and [*list*](api::OperationListCall) @@ -52,8 +52,8 @@ //! let r = hub.operations().list(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -81,12 +81,12 @@ //! use std::default::Default; //! use genomics1::{Genomics, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -125,10 +125,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -138,25 +138,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/gkehub1/README.md b/gen/gkehub1/README.md index c37982d0a7..56a94b9398 100644 --- a/gen/gkehub1/README.md +++ b/gen/gkehub1/README.md @@ -11,7 +11,7 @@ Everything else about the *GKE Hub* *v1* API can be found at the [official documentation site](https://cloud.google.com/anthos/multicluster-management/connect/registering-a-cluster). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-gkehub1/5.0.3+20230106/google_gkehub1/GKEHub) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-gkehub1/5.0.3+20230106/google_gkehub1/GKEHub) ... * projects * [*locations features create*](https://docs.rs/google-gkehub1/5.0.3+20230106/google_gkehub1/api::ProjectLocationFeatureCreateCall), [*locations features delete*](https://docs.rs/google-gkehub1/5.0.3+20230106/google_gkehub1/api::ProjectLocationFeatureDeleteCall), [*locations features get*](https://docs.rs/google-gkehub1/5.0.3+20230106/google_gkehub1/api::ProjectLocationFeatureGetCall), [*locations features get iam policy*](https://docs.rs/google-gkehub1/5.0.3+20230106/google_gkehub1/api::ProjectLocationFeatureGetIamPolicyCall), [*locations features list*](https://docs.rs/google-gkehub1/5.0.3+20230106/google_gkehub1/api::ProjectLocationFeatureListCall), [*locations features patch*](https://docs.rs/google-gkehub1/5.0.3+20230106/google_gkehub1/api::ProjectLocationFeaturePatchCall), [*locations features set iam policy*](https://docs.rs/google-gkehub1/5.0.3+20230106/google_gkehub1/api::ProjectLocationFeatureSetIamPolicyCall), [*locations features test iam permissions*](https://docs.rs/google-gkehub1/5.0.3+20230106/google_gkehub1/api::ProjectLocationFeatureTestIamPermissionCall), [*locations get*](https://docs.rs/google-gkehub1/5.0.3+20230106/google_gkehub1/api::ProjectLocationGetCall), [*locations list*](https://docs.rs/google-gkehub1/5.0.3+20230106/google_gkehub1/api::ProjectLocationListCall), [*locations memberships create*](https://docs.rs/google-gkehub1/5.0.3+20230106/google_gkehub1/api::ProjectLocationMembershipCreateCall), [*locations memberships delete*](https://docs.rs/google-gkehub1/5.0.3+20230106/google_gkehub1/api::ProjectLocationMembershipDeleteCall), [*locations memberships generate connect manifest*](https://docs.rs/google-gkehub1/5.0.3+20230106/google_gkehub1/api::ProjectLocationMembershipGenerateConnectManifestCall), [*locations memberships get*](https://docs.rs/google-gkehub1/5.0.3+20230106/google_gkehub1/api::ProjectLocationMembershipGetCall), [*locations memberships get iam policy*](https://docs.rs/google-gkehub1/5.0.3+20230106/google_gkehub1/api::ProjectLocationMembershipGetIamPolicyCall), [*locations memberships list*](https://docs.rs/google-gkehub1/5.0.3+20230106/google_gkehub1/api::ProjectLocationMembershipListCall), [*locations memberships patch*](https://docs.rs/google-gkehub1/5.0.3+20230106/google_gkehub1/api::ProjectLocationMembershipPatchCall), [*locations memberships set iam policy*](https://docs.rs/google-gkehub1/5.0.3+20230106/google_gkehub1/api::ProjectLocationMembershipSetIamPolicyCall), [*locations memberships test iam permissions*](https://docs.rs/google-gkehub1/5.0.3+20230106/google_gkehub1/api::ProjectLocationMembershipTestIamPermissionCall), [*locations operations cancel*](https://docs.rs/google-gkehub1/5.0.3+20230106/google_gkehub1/api::ProjectLocationOperationCancelCall), [*locations operations delete*](https://docs.rs/google-gkehub1/5.0.3+20230106/google_gkehub1/api::ProjectLocationOperationDeleteCall), [*locations operations get*](https://docs.rs/google-gkehub1/5.0.3+20230106/google_gkehub1/api::ProjectLocationOperationGetCall) and [*locations operations list*](https://docs.rs/google-gkehub1/5.0.3+20230106/google_gkehub1/api::ProjectLocationOperationListCall) @@ -56,8 +56,8 @@ let r = hub.projects().locations_memberships_patch(...).doit().await let r = hub.projects().locations_operations_get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -85,12 +85,12 @@ use gkehub1::{Result, Error}; use std::default::Default; use gkehub1::{GKEHub, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -133,10 +133,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-gkehub1/5.0.3+20230106/google_gkehub1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-gkehub1/5.0.3+20230106/google_gkehub1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -146,25 +146,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-gkehub You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-gkehub1/5.0.3+20230106/google_gkehub1/client::Delegate) to the -[Method Builder](https://docs.rs/google-gkehub1/5.0.3+20230106/google_gkehub1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-gkehub1/5.0.3+20230106/google_gkehub1/client::Delegate) to the +[Method Builder](https://docs.rs/google-gkehub1/5.0.3+20230106/google_gkehub1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-gkehub1/5.0.3+20230106/google_gkehub1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-gkehub1/5.0.3+20230106/google_gkehub1/client::RequestValue) and -[decodable](https://docs.rs/google-gkehub1/5.0.3+20230106/google_gkehub1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-gkehub1/5.0.3+20230106/google_gkehub1/client::RequestValue) and +[decodable](https://docs.rs/google-gkehub1/5.0.3+20230106/google_gkehub1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-gkehub1/5.0.3+20230106/google_gkehub1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-gkehub1/5.0.3+20230106/google_gkehub1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -183,7 +183,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **gkehub1** library was generated by Sebastian Thiel, and is placed +The **gkehub1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/gkehub1/src/api.rs b/gen/gkehub1/src/api.rs index d49da272ad..d39b11d2f3 100644 --- a/gen/gkehub1/src/api.rs +++ b/gen/gkehub1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use gkehub1::{GKEHub, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/gkehub1/src/lib.rs b/gen/gkehub1/src/lib.rs index ca482f3367..a7ab69f98b 100644 --- a/gen/gkehub1/src/lib.rs +++ b/gen/gkehub1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/gkehub1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](GKEHub) ... +//! Handle the following *Resources* with ease from the central [hub](GKEHub) ... //! //! * projects //! * [*locations features create*](api::ProjectLocationFeatureCreateCall), [*locations features delete*](api::ProjectLocationFeatureDeleteCall), [*locations features get*](api::ProjectLocationFeatureGetCall), [*locations features get iam policy*](api::ProjectLocationFeatureGetIamPolicyCall), [*locations features list*](api::ProjectLocationFeatureListCall), [*locations features patch*](api::ProjectLocationFeaturePatchCall), [*locations features set iam policy*](api::ProjectLocationFeatureSetIamPolicyCall), [*locations features test iam permissions*](api::ProjectLocationFeatureTestIamPermissionCall), [*locations get*](api::ProjectLocationGetCall), [*locations list*](api::ProjectLocationListCall), [*locations memberships create*](api::ProjectLocationMembershipCreateCall), [*locations memberships delete*](api::ProjectLocationMembershipDeleteCall), [*locations memberships generate connect manifest*](api::ProjectLocationMembershipGenerateConnectManifestCall), [*locations memberships get*](api::ProjectLocationMembershipGetCall), [*locations memberships get iam policy*](api::ProjectLocationMembershipGetIamPolicyCall), [*locations memberships list*](api::ProjectLocationMembershipListCall), [*locations memberships patch*](api::ProjectLocationMembershipPatchCall), [*locations memberships set iam policy*](api::ProjectLocationMembershipSetIamPolicyCall), [*locations memberships test iam permissions*](api::ProjectLocationMembershipTestIamPermissionCall), [*locations operations cancel*](api::ProjectLocationOperationCancelCall), [*locations operations delete*](api::ProjectLocationOperationDeleteCall), [*locations operations get*](api::ProjectLocationOperationGetCall) and [*locations operations list*](api::ProjectLocationOperationListCall) @@ -56,8 +56,8 @@ //! let r = hub.projects().locations_operations_get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -86,12 +86,12 @@ //! use std::default::Default; //! use gkehub1::{GKEHub, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -134,10 +134,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -147,25 +147,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/gmail1/README.md b/gen/gmail1/README.md index 8e35e1afb0..f18940d8f0 100644 --- a/gen/gmail1/README.md +++ b/gen/gmail1/README.md @@ -11,7 +11,7 @@ Everything else about the *Gmail* *v1* API can be found at the [official documentation site](https://developers.google.com/gmail/api/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/Gmail) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/Gmail) ... * users * [*drafts create*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserDraftCreateCall), [*drafts delete*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserDraftDeleteCall), [*drafts get*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserDraftGetCall), [*drafts list*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserDraftListCall), [*drafts send*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserDraftSendCall), [*drafts update*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserDraftUpdateCall), [*get profile*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserGetProfileCall), [*history list*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserHistoryListCall), [*labels create*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserLabelCreateCall), [*labels delete*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserLabelDeleteCall), [*labels get*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserLabelGetCall), [*labels list*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserLabelListCall), [*labels patch*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserLabelPatchCall), [*labels update*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserLabelUpdateCall), [*messages attachments get*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserMessageAttachmentGetCall), [*messages batch delete*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserMessageBatchDeleteCall), [*messages batch modify*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserMessageBatchModifyCall), [*messages delete*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserMessageDeleteCall), [*messages get*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserMessageGetCall), [*messages import*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserMessageImportCall), [*messages insert*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserMessageInsertCall), [*messages list*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserMessageListCall), [*messages modify*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserMessageModifyCall), [*messages send*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserMessageSendCall), [*messages trash*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserMessageTrashCall), [*messages untrash*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserMessageUntrashCall), [*settings cse identities create*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserSettingCseIdentityCreateCall), [*settings cse identities delete*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserSettingCseIdentityDeleteCall), [*settings cse identities get*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserSettingCseIdentityGetCall), [*settings cse identities list*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserSettingCseIdentityListCall), [*settings cse identities patch*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserSettingCseIdentityPatchCall), [*settings cse keypairs create*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserSettingCseKeypairCreateCall), [*settings cse keypairs disable*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserSettingCseKeypairDisableCall), [*settings cse keypairs enable*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserSettingCseKeypairEnableCall), [*settings cse keypairs get*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserSettingCseKeypairGetCall), [*settings cse keypairs list*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserSettingCseKeypairListCall), [*settings cse keypairs obliterate*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserSettingCseKeypairObliterateCall), [*settings delegates create*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserSettingDelegateCreateCall), [*settings delegates delete*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserSettingDelegateDeleteCall), [*settings delegates get*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserSettingDelegateGetCall), [*settings delegates list*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserSettingDelegateListCall), [*settings filters create*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserSettingFilterCreateCall), [*settings filters delete*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserSettingFilterDeleteCall), [*settings filters get*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserSettingFilterGetCall), [*settings filters list*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserSettingFilterListCall), [*settings forwarding addresses create*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserSettingForwardingAddressCreateCall), [*settings forwarding addresses delete*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserSettingForwardingAddressDeleteCall), [*settings forwarding addresses get*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserSettingForwardingAddressGetCall), [*settings forwarding addresses list*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserSettingForwardingAddressListCall), [*settings get auto forwarding*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserSettingGetAutoForwardingCall), [*settings get imap*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserSettingGetImapCall), [*settings get language*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserSettingGetLanguageCall), [*settings get pop*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserSettingGetPopCall), [*settings get vacation*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserSettingGetVacationCall), [*settings send as create*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserSettingSendACreateCall), [*settings send as delete*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserSettingSendADeleteCall), [*settings send as get*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserSettingSendAGetCall), [*settings send as list*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserSettingSendAListCall), [*settings send as patch*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserSettingSendAPatchCall), [*settings send as smime info delete*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserSettingSendASmimeInfoDeleteCall), [*settings send as smime info get*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserSettingSendASmimeInfoGetCall), [*settings send as smime info insert*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserSettingSendASmimeInfoInsertCall), [*settings send as smime info list*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserSettingSendASmimeInfoListCall), [*settings send as smime info set default*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserSettingSendASmimeInfoSetDefaultCall), [*settings send as update*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserSettingSendAUpdateCall), [*settings send as verify*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserSettingSendAVerifyCall), [*settings update auto forwarding*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserSettingUpdateAutoForwardingCall), [*settings update imap*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserSettingUpdateImapCall), [*settings update language*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserSettingUpdateLanguageCall), [*settings update pop*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserSettingUpdatePopCall), [*settings update vacation*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserSettingUpdateVacationCall), [*stop*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserStopCall), [*threads delete*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserThreadDeleteCall), [*threads get*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserThreadGetCall), [*threads list*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserThreadListCall), [*threads modify*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserThreadModifyCall), [*threads trash*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserThreadTrashCall), [*threads untrash*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserThreadUntrashCall) and [*watch*](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/api::UserWatchCall) @@ -66,8 +66,8 @@ let r = hub.users().messages_trash(...).doit().await let r = hub.users().messages_untrash(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -96,12 +96,12 @@ use std::fs; use std::default::Default; use gmail1::{Gmail, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -146,10 +146,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -159,25 +159,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-gmail1 You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/client::Delegate) to the -[Method Builder](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/client::Delegate) to the +[Method Builder](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/client::RequestValue) and -[decodable](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/client::RequestValue) and +[decodable](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-gmail1/5.0.3+20230116/google_gmail1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -196,7 +196,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **gmail1** library was generated by Sebastian Thiel, and is placed +The **gmail1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/gmail1/src/api.rs b/gen/gmail1/src/api.rs index 293046da9d..ff78c55032 100644 --- a/gen/gmail1/src/api.rs +++ b/gen/gmail1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// Read, compose, send, and permanently delete all your email from Gmail Gmai, @@ -118,12 +118,12 @@ impl Default for Scope { /// use std::default::Default; /// use gmail1::{Gmail, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/gmail1/src/lib.rs b/gen/gmail1/src/lib.rs index 5e920a8f23..c0bd087e08 100644 --- a/gen/gmail1/src/lib.rs +++ b/gen/gmail1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/gmail1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Gmail) ... +//! Handle the following *Resources* with ease from the central [hub](Gmail) ... //! //! * users //! * [*drafts create*](api::UserDraftCreateCall), [*drafts delete*](api::UserDraftDeleteCall), [*drafts get*](api::UserDraftGetCall), [*drafts list*](api::UserDraftListCall), [*drafts send*](api::UserDraftSendCall), [*drafts update*](api::UserDraftUpdateCall), [*get profile*](api::UserGetProfileCall), [*history list*](api::UserHistoryListCall), [*labels create*](api::UserLabelCreateCall), [*labels delete*](api::UserLabelDeleteCall), [*labels get*](api::UserLabelGetCall), [*labels list*](api::UserLabelListCall), [*labels patch*](api::UserLabelPatchCall), [*labels update*](api::UserLabelUpdateCall), [*messages attachments get*](api::UserMessageAttachmentGetCall), [*messages batch delete*](api::UserMessageBatchDeleteCall), [*messages batch modify*](api::UserMessageBatchModifyCall), [*messages delete*](api::UserMessageDeleteCall), [*messages get*](api::UserMessageGetCall), [*messages import*](api::UserMessageImportCall), [*messages insert*](api::UserMessageInsertCall), [*messages list*](api::UserMessageListCall), [*messages modify*](api::UserMessageModifyCall), [*messages send*](api::UserMessageSendCall), [*messages trash*](api::UserMessageTrashCall), [*messages untrash*](api::UserMessageUntrashCall), [*settings cse identities create*](api::UserSettingCseIdentityCreateCall), [*settings cse identities delete*](api::UserSettingCseIdentityDeleteCall), [*settings cse identities get*](api::UserSettingCseIdentityGetCall), [*settings cse identities list*](api::UserSettingCseIdentityListCall), [*settings cse identities patch*](api::UserSettingCseIdentityPatchCall), [*settings cse keypairs create*](api::UserSettingCseKeypairCreateCall), [*settings cse keypairs disable*](api::UserSettingCseKeypairDisableCall), [*settings cse keypairs enable*](api::UserSettingCseKeypairEnableCall), [*settings cse keypairs get*](api::UserSettingCseKeypairGetCall), [*settings cse keypairs list*](api::UserSettingCseKeypairListCall), [*settings cse keypairs obliterate*](api::UserSettingCseKeypairObliterateCall), [*settings delegates create*](api::UserSettingDelegateCreateCall), [*settings delegates delete*](api::UserSettingDelegateDeleteCall), [*settings delegates get*](api::UserSettingDelegateGetCall), [*settings delegates list*](api::UserSettingDelegateListCall), [*settings filters create*](api::UserSettingFilterCreateCall), [*settings filters delete*](api::UserSettingFilterDeleteCall), [*settings filters get*](api::UserSettingFilterGetCall), [*settings filters list*](api::UserSettingFilterListCall), [*settings forwarding addresses create*](api::UserSettingForwardingAddressCreateCall), [*settings forwarding addresses delete*](api::UserSettingForwardingAddressDeleteCall), [*settings forwarding addresses get*](api::UserSettingForwardingAddressGetCall), [*settings forwarding addresses list*](api::UserSettingForwardingAddressListCall), [*settings get auto forwarding*](api::UserSettingGetAutoForwardingCall), [*settings get imap*](api::UserSettingGetImapCall), [*settings get language*](api::UserSettingGetLanguageCall), [*settings get pop*](api::UserSettingGetPopCall), [*settings get vacation*](api::UserSettingGetVacationCall), [*settings send as create*](api::UserSettingSendACreateCall), [*settings send as delete*](api::UserSettingSendADeleteCall), [*settings send as get*](api::UserSettingSendAGetCall), [*settings send as list*](api::UserSettingSendAListCall), [*settings send as patch*](api::UserSettingSendAPatchCall), [*settings send as smime info delete*](api::UserSettingSendASmimeInfoDeleteCall), [*settings send as smime info get*](api::UserSettingSendASmimeInfoGetCall), [*settings send as smime info insert*](api::UserSettingSendASmimeInfoInsertCall), [*settings send as smime info list*](api::UserSettingSendASmimeInfoListCall), [*settings send as smime info set default*](api::UserSettingSendASmimeInfoSetDefaultCall), [*settings send as update*](api::UserSettingSendAUpdateCall), [*settings send as verify*](api::UserSettingSendAVerifyCall), [*settings update auto forwarding*](api::UserSettingUpdateAutoForwardingCall), [*settings update imap*](api::UserSettingUpdateImapCall), [*settings update language*](api::UserSettingUpdateLanguageCall), [*settings update pop*](api::UserSettingUpdatePopCall), [*settings update vacation*](api::UserSettingUpdateVacationCall), [*stop*](api::UserStopCall), [*threads delete*](api::UserThreadDeleteCall), [*threads get*](api::UserThreadGetCall), [*threads list*](api::UserThreadListCall), [*threads modify*](api::UserThreadModifyCall), [*threads trash*](api::UserThreadTrashCall), [*threads untrash*](api::UserThreadUntrashCall) and [*watch*](api::UserWatchCall) @@ -66,8 +66,8 @@ //! let r = hub.users().messages_untrash(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -97,12 +97,12 @@ //! use std::default::Default; //! use gmail1::{Gmail, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -147,10 +147,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -160,25 +160,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/gmailpostmastertools1/README.md b/gen/gmailpostmastertools1/README.md index cac7c775f5..cf060328d4 100644 --- a/gen/gmailpostmastertools1/README.md +++ b/gen/gmailpostmastertools1/README.md @@ -11,7 +11,7 @@ Everything else about the *Postmaster Tools* *v1* API can be found at the [official documentation site](https://developers.google.com/gmail/postmaster). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-gmailpostmastertools1/5.0.3+20230123/google_gmailpostmastertools1/PostmasterTools) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-gmailpostmastertools1/5.0.3+20230123/google_gmailpostmastertools1/PostmasterTools) ... * [domains](https://docs.rs/google-gmailpostmastertools1/5.0.3+20230123/google_gmailpostmastertools1/api::Domain) * [*get*](https://docs.rs/google-gmailpostmastertools1/5.0.3+20230123/google_gmailpostmastertools1/api::DomainGetCall), [*list*](https://docs.rs/google-gmailpostmastertools1/5.0.3+20230123/google_gmailpostmastertools1/api::DomainListCall), [*traffic stats get*](https://docs.rs/google-gmailpostmastertools1/5.0.3+20230123/google_gmailpostmastertools1/api::DomainTrafficStatGetCall) and [*traffic stats list*](https://docs.rs/google-gmailpostmastertools1/5.0.3+20230123/google_gmailpostmastertools1/api::DomainTrafficStatListCall) @@ -53,8 +53,8 @@ let r = hub.domains().get(...).doit().await let r = hub.domains().list(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -81,12 +81,12 @@ use gmailpostmastertools1::{Result, Error}; use std::default::Default; use gmailpostmastertools1::{PostmasterTools, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -130,10 +130,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-gmailpostmastertools1/5.0.3+20230123/google_gmailpostmastertools1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-gmailpostmastertools1/5.0.3+20230123/google_gmailpostmastertools1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -143,25 +143,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-gmailp You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-gmailpostmastertools1/5.0.3+20230123/google_gmailpostmastertools1/client::Delegate) to the -[Method Builder](https://docs.rs/google-gmailpostmastertools1/5.0.3+20230123/google_gmailpostmastertools1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-gmailpostmastertools1/5.0.3+20230123/google_gmailpostmastertools1/client::Delegate) to the +[Method Builder](https://docs.rs/google-gmailpostmastertools1/5.0.3+20230123/google_gmailpostmastertools1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-gmailpostmastertools1/5.0.3+20230123/google_gmailpostmastertools1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-gmailpostmastertools1/5.0.3+20230123/google_gmailpostmastertools1/client::RequestValue) and -[decodable](https://docs.rs/google-gmailpostmastertools1/5.0.3+20230123/google_gmailpostmastertools1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-gmailpostmastertools1/5.0.3+20230123/google_gmailpostmastertools1/client::RequestValue) and +[decodable](https://docs.rs/google-gmailpostmastertools1/5.0.3+20230123/google_gmailpostmastertools1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-gmailpostmastertools1/5.0.3+20230123/google_gmailpostmastertools1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-gmailpostmastertools1/5.0.3+20230123/google_gmailpostmastertools1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -180,7 +180,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **gmailpostmastertools1** library was generated by Sebastian Thiel, and is placed +The **gmailpostmastertools1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/gmailpostmastertools1/src/api.rs b/gen/gmailpostmastertools1/src/api.rs index 8f0de73a35..12cffb1219 100644 --- a/gen/gmailpostmastertools1/src/api.rs +++ b/gen/gmailpostmastertools1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See email traffic metrics for the domains you have registered in Gmail Postmaster Tools PostmasterReadonly, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use gmailpostmastertools1::{PostmasterTools, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/gmailpostmastertools1/src/lib.rs b/gen/gmailpostmastertools1/src/lib.rs index 8b6dfdbda1..82d4856b00 100644 --- a/gen/gmailpostmastertools1/src/lib.rs +++ b/gen/gmailpostmastertools1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/gmailpostmastertools1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](PostmasterTools) ... +//! Handle the following *Resources* with ease from the central [hub](PostmasterTools) ... //! //! * [domains](api::Domain) //! * [*get*](api::DomainGetCall), [*list*](api::DomainListCall), [*traffic stats get*](api::DomainTrafficStatGetCall) and [*traffic stats list*](api::DomainTrafficStatListCall) @@ -53,8 +53,8 @@ //! let r = hub.domains().list(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -82,12 +82,12 @@ //! use std::default::Default; //! use gmailpostmastertools1::{PostmasterTools, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -131,10 +131,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -144,25 +144,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/gmailpostmastertools1_beta1/README.md b/gen/gmailpostmastertools1_beta1/README.md index f0aac8475b..b2b49a71e4 100644 --- a/gen/gmailpostmastertools1_beta1/README.md +++ b/gen/gmailpostmastertools1_beta1/README.md @@ -11,7 +11,7 @@ Everything else about the *Postmaster Tools* *v1_beta1* API can be found at the [official documentation site](https://developers.google.com/gmail/postmaster). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-gmailpostmastertools1_beta1/5.0.3+20230123/google_gmailpostmastertools1_beta1/PostmasterTools) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-gmailpostmastertools1_beta1/5.0.3+20230123/google_gmailpostmastertools1_beta1/PostmasterTools) ... * [domains](https://docs.rs/google-gmailpostmastertools1_beta1/5.0.3+20230123/google_gmailpostmastertools1_beta1/api::Domain) * [*get*](https://docs.rs/google-gmailpostmastertools1_beta1/5.0.3+20230123/google_gmailpostmastertools1_beta1/api::DomainGetCall), [*list*](https://docs.rs/google-gmailpostmastertools1_beta1/5.0.3+20230123/google_gmailpostmastertools1_beta1/api::DomainListCall), [*traffic stats get*](https://docs.rs/google-gmailpostmastertools1_beta1/5.0.3+20230123/google_gmailpostmastertools1_beta1/api::DomainTrafficStatGetCall) and [*traffic stats list*](https://docs.rs/google-gmailpostmastertools1_beta1/5.0.3+20230123/google_gmailpostmastertools1_beta1/api::DomainTrafficStatListCall) @@ -53,8 +53,8 @@ let r = hub.domains().get(...).doit().await let r = hub.domains().list(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -81,12 +81,12 @@ use gmailpostmastertools1_beta1::{Result, Error}; use std::default::Default; use gmailpostmastertools1_beta1::{PostmasterTools, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -130,10 +130,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-gmailpostmastertools1_beta1/5.0.3+20230123/google_gmailpostmastertools1_beta1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-gmailpostmastertools1_beta1/5.0.3+20230123/google_gmailpostmastertools1_beta1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -143,25 +143,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-gmailp You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-gmailpostmastertools1_beta1/5.0.3+20230123/google_gmailpostmastertools1_beta1/client::Delegate) to the -[Method Builder](https://docs.rs/google-gmailpostmastertools1_beta1/5.0.3+20230123/google_gmailpostmastertools1_beta1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-gmailpostmastertools1_beta1/5.0.3+20230123/google_gmailpostmastertools1_beta1/client::Delegate) to the +[Method Builder](https://docs.rs/google-gmailpostmastertools1_beta1/5.0.3+20230123/google_gmailpostmastertools1_beta1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-gmailpostmastertools1_beta1/5.0.3+20230123/google_gmailpostmastertools1_beta1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-gmailpostmastertools1_beta1/5.0.3+20230123/google_gmailpostmastertools1_beta1/client::RequestValue) and -[decodable](https://docs.rs/google-gmailpostmastertools1_beta1/5.0.3+20230123/google_gmailpostmastertools1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-gmailpostmastertools1_beta1/5.0.3+20230123/google_gmailpostmastertools1_beta1/client::RequestValue) and +[decodable](https://docs.rs/google-gmailpostmastertools1_beta1/5.0.3+20230123/google_gmailpostmastertools1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-gmailpostmastertools1_beta1/5.0.3+20230123/google_gmailpostmastertools1_beta1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-gmailpostmastertools1_beta1/5.0.3+20230123/google_gmailpostmastertools1_beta1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -180,7 +180,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **gmailpostmastertools1_beta1** library was generated by Sebastian Thiel, and is placed +The **gmailpostmastertools1_beta1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/gmailpostmastertools1_beta1/src/api.rs b/gen/gmailpostmastertools1_beta1/src/api.rs index c012e67852..02b45e8350 100644 --- a/gen/gmailpostmastertools1_beta1/src/api.rs +++ b/gen/gmailpostmastertools1_beta1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See email traffic metrics for the domains you have registered in Gmail Postmaster Tools PostmasterReadonly, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use gmailpostmastertools1_beta1::{PostmasterTools, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/gmailpostmastertools1_beta1/src/lib.rs b/gen/gmailpostmastertools1_beta1/src/lib.rs index 6461a05dec..2a8c2ad51c 100644 --- a/gen/gmailpostmastertools1_beta1/src/lib.rs +++ b/gen/gmailpostmastertools1_beta1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/gmailpostmastertools1_beta1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](PostmasterTools) ... +//! Handle the following *Resources* with ease from the central [hub](PostmasterTools) ... //! //! * [domains](api::Domain) //! * [*get*](api::DomainGetCall), [*list*](api::DomainListCall), [*traffic stats get*](api::DomainTrafficStatGetCall) and [*traffic stats list*](api::DomainTrafficStatListCall) @@ -53,8 +53,8 @@ //! let r = hub.domains().list(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -82,12 +82,12 @@ //! use std::default::Default; //! use gmailpostmastertools1_beta1::{PostmasterTools, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -131,10 +131,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -144,25 +144,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/groupsmigration1/README.md b/gen/groupsmigration1/README.md index 190cb9ae28..360bd1a454 100644 --- a/gen/groupsmigration1/README.md +++ b/gen/groupsmigration1/README.md @@ -11,7 +11,7 @@ Everything else about the *Groups Migration* *v1* API can be found at the [official documentation site](https://developers.google.com/google-apps/groups-migration/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-groupsmigration1/5.0.3+20230117/google_groupsmigration1/GroupsMigration) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-groupsmigration1/5.0.3+20230117/google_groupsmigration1/GroupsMigration) ... * archive * [*insert*](https://docs.rs/google-groupsmigration1/5.0.3+20230117/google_groupsmigration1/api::ArchiveInsertCall) @@ -54,8 +54,8 @@ Or specifically ... let r = hub.archive().insert(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -83,12 +83,12 @@ use std::fs; use std::default::Default; use groupsmigration1::{GroupsMigration, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -124,10 +124,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-groupsmigration1/5.0.3+20230117/google_groupsmigration1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-groupsmigration1/5.0.3+20230117/google_groupsmigration1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -137,25 +137,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-groups You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-groupsmigration1/5.0.3+20230117/google_groupsmigration1/client::Delegate) to the -[Method Builder](https://docs.rs/google-groupsmigration1/5.0.3+20230117/google_groupsmigration1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-groupsmigration1/5.0.3+20230117/google_groupsmigration1/client::Delegate) to the +[Method Builder](https://docs.rs/google-groupsmigration1/5.0.3+20230117/google_groupsmigration1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-groupsmigration1/5.0.3+20230117/google_groupsmigration1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-groupsmigration1/5.0.3+20230117/google_groupsmigration1/client::RequestValue) and -[decodable](https://docs.rs/google-groupsmigration1/5.0.3+20230117/google_groupsmigration1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-groupsmigration1/5.0.3+20230117/google_groupsmigration1/client::RequestValue) and +[decodable](https://docs.rs/google-groupsmigration1/5.0.3+20230117/google_groupsmigration1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-groupsmigration1/5.0.3+20230117/google_groupsmigration1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-groupsmigration1/5.0.3+20230117/google_groupsmigration1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -174,7 +174,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **groupsmigration1** library was generated by Sebastian Thiel, and is placed +The **groupsmigration1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/groupsmigration1/src/api.rs b/gen/groupsmigration1/src/api.rs index 407e32484f..e68be90fdf 100644 --- a/gen/groupsmigration1/src/api.rs +++ b/gen/groupsmigration1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// Upload messages to any Google group in your domain AppGroupMigration, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use groupsmigration1::{GroupsMigration, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/groupsmigration1/src/lib.rs b/gen/groupsmigration1/src/lib.rs index f95d8bb176..92c35a9857 100644 --- a/gen/groupsmigration1/src/lib.rs +++ b/gen/groupsmigration1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/groupsmigration1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](GroupsMigration) ... +//! Handle the following *Resources* with ease from the central [hub](GroupsMigration) ... //! //! * archive //! * [*insert*](api::ArchiveInsertCall) @@ -54,8 +54,8 @@ //! let r = hub.archive().insert(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -84,12 +84,12 @@ //! use std::default::Default; //! use groupsmigration1::{GroupsMigration, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -125,10 +125,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -138,25 +138,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/groupssettings1/README.md b/gen/groupssettings1/README.md index 22d332afa6..d41a87ed76 100644 --- a/gen/groupssettings1/README.md +++ b/gen/groupssettings1/README.md @@ -11,7 +11,7 @@ Everything else about the *groupssettings* *v1* API can be found at the [official documentation site](https://developers.google.com/google-apps/groups-settings/get_started). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-groupssettings1/5.0.3+20220614/google_groupssettings1/Groupssettings) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-groupssettings1/5.0.3+20220614/google_groupssettings1/Groupssettings) ... * groups * [*get*](https://docs.rs/google-groupssettings1/5.0.3+20220614/google_groupssettings1/api::GroupGetCall), [*patch*](https://docs.rs/google-groupssettings1/5.0.3+20220614/google_groupssettings1/api::GroupPatchCall) and [*update*](https://docs.rs/google-groupssettings1/5.0.3+20220614/google_groupssettings1/api::GroupUpdateCall) @@ -52,8 +52,8 @@ let r = hub.groups().patch(...).doit().await let r = hub.groups().update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -81,12 +81,12 @@ use groupssettings1::{Result, Error}; use std::default::Default; use groupssettings1::{Groupssettings, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -127,10 +127,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-groupssettings1/5.0.3+20220614/google_groupssettings1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-groupssettings1/5.0.3+20220614/google_groupssettings1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -140,25 +140,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-groups You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-groupssettings1/5.0.3+20220614/google_groupssettings1/client::Delegate) to the -[Method Builder](https://docs.rs/google-groupssettings1/5.0.3+20220614/google_groupssettings1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-groupssettings1/5.0.3+20220614/google_groupssettings1/client::Delegate) to the +[Method Builder](https://docs.rs/google-groupssettings1/5.0.3+20220614/google_groupssettings1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-groupssettings1/5.0.3+20220614/google_groupssettings1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-groupssettings1/5.0.3+20220614/google_groupssettings1/client::RequestValue) and -[decodable](https://docs.rs/google-groupssettings1/5.0.3+20220614/google_groupssettings1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-groupssettings1/5.0.3+20220614/google_groupssettings1/client::RequestValue) and +[decodable](https://docs.rs/google-groupssettings1/5.0.3+20220614/google_groupssettings1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-groupssettings1/5.0.3+20220614/google_groupssettings1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-groupssettings1/5.0.3+20220614/google_groupssettings1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -177,7 +177,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **groupssettings1** library was generated by Sebastian Thiel, and is placed +The **groupssettings1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/groupssettings1/src/api.rs b/gen/groupssettings1/src/api.rs index 615c3bd488..f26b106ae5 100644 --- a/gen/groupssettings1/src/api.rs +++ b/gen/groupssettings1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage the settings of a G Suite group AppGroupSetting, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use groupssettings1::{Groupssettings, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/groupssettings1/src/lib.rs b/gen/groupssettings1/src/lib.rs index 3d941501bf..0b0514957a 100644 --- a/gen/groupssettings1/src/lib.rs +++ b/gen/groupssettings1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/groupssettings1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Groupssettings) ... +//! Handle the following *Resources* with ease from the central [hub](Groupssettings) ... //! //! * groups //! * [*get*](api::GroupGetCall), [*patch*](api::GroupPatchCall) and [*update*](api::GroupUpdateCall) @@ -52,8 +52,8 @@ //! let r = hub.groups().update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -82,12 +82,12 @@ //! use std::default::Default; //! use groupssettings1::{Groupssettings, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -128,10 +128,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -141,25 +141,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/healthcare1/README.md b/gen/healthcare1/README.md index c22af41a34..32a7acac4f 100644 --- a/gen/healthcare1/README.md +++ b/gen/healthcare1/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Healthcare* *v1* API can be found at the [official documentation site](https://cloud.google.com/healthcare). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/CloudHealthcare) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/CloudHealthcare) ... * projects * [*locations datasets consent stores attribute definitions create*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetConsentStoreAttributeDefinitionCreateCall), [*locations datasets consent stores attribute definitions delete*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetConsentStoreAttributeDefinitionDeleteCall), [*locations datasets consent stores attribute definitions get*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetConsentStoreAttributeDefinitionGetCall), [*locations datasets consent stores attribute definitions list*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetConsentStoreAttributeDefinitionListCall), [*locations datasets consent stores attribute definitions patch*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetConsentStoreAttributeDefinitionPatchCall), [*locations datasets consent stores check data access*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetConsentStoreCheckDataAccesCall), [*locations datasets consent stores consent artifacts create*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetConsentStoreConsentArtifactCreateCall), [*locations datasets consent stores consent artifacts delete*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetConsentStoreConsentArtifactDeleteCall), [*locations datasets consent stores consent artifacts get*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetConsentStoreConsentArtifactGetCall), [*locations datasets consent stores consent artifacts list*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetConsentStoreConsentArtifactListCall), [*locations datasets consent stores consents activate*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetConsentStoreConsentActivateCall), [*locations datasets consent stores consents create*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetConsentStoreConsentCreateCall), [*locations datasets consent stores consents delete*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetConsentStoreConsentDeleteCall), [*locations datasets consent stores consents delete revision*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetConsentStoreConsentDeleteRevisionCall), [*locations datasets consent stores consents get*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetConsentStoreConsentGetCall), [*locations datasets consent stores consents list*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetConsentStoreConsentListCall), [*locations datasets consent stores consents list revisions*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetConsentStoreConsentListRevisionCall), [*locations datasets consent stores consents patch*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetConsentStoreConsentPatchCall), [*locations datasets consent stores consents reject*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetConsentStoreConsentRejectCall), [*locations datasets consent stores consents revoke*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetConsentStoreConsentRevokeCall), [*locations datasets consent stores create*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetConsentStoreCreateCall), [*locations datasets consent stores delete*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetConsentStoreDeleteCall), [*locations datasets consent stores evaluate user consents*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetConsentStoreEvaluateUserConsentCall), [*locations datasets consent stores get*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetConsentStoreGetCall), [*locations datasets consent stores get iam policy*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetConsentStoreGetIamPolicyCall), [*locations datasets consent stores list*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetConsentStoreListCall), [*locations datasets consent stores patch*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetConsentStorePatchCall), [*locations datasets consent stores query accessible data*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetConsentStoreQueryAccessibleDataCall), [*locations datasets consent stores set iam policy*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetConsentStoreSetIamPolicyCall), [*locations datasets consent stores test iam permissions*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetConsentStoreTestIamPermissionCall), [*locations datasets consent stores user data mappings archive*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetConsentStoreUserDataMappingArchiveCall), [*locations datasets consent stores user data mappings create*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetConsentStoreUserDataMappingCreateCall), [*locations datasets consent stores user data mappings delete*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetConsentStoreUserDataMappingDeleteCall), [*locations datasets consent stores user data mappings get*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetConsentStoreUserDataMappingGetCall), [*locations datasets consent stores user data mappings list*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetConsentStoreUserDataMappingListCall), [*locations datasets consent stores user data mappings patch*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetConsentStoreUserDataMappingPatchCall), [*locations datasets create*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetCreateCall), [*locations datasets deidentify*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetDeidentifyCall), [*locations datasets delete*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetDeleteCall), [*locations datasets dicom stores create*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetDicomStoreCreateCall), [*locations datasets dicom stores deidentify*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetDicomStoreDeidentifyCall), [*locations datasets dicom stores delete*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetDicomStoreDeleteCall), [*locations datasets dicom stores export*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetDicomStoreExportCall), [*locations datasets dicom stores get*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetDicomStoreGetCall), [*locations datasets dicom stores get iam policy*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetDicomStoreGetIamPolicyCall), [*locations datasets dicom stores import*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetDicomStoreImportCall), [*locations datasets dicom stores list*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetDicomStoreListCall), [*locations datasets dicom stores patch*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetDicomStorePatchCall), [*locations datasets dicom stores search for instances*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetDicomStoreSearchForInstanceCall), [*locations datasets dicom stores search for series*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetDicomStoreSearchForSeryCall), [*locations datasets dicom stores search for studies*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetDicomStoreSearchForStudyCall), [*locations datasets dicom stores set iam policy*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetDicomStoreSetIamPolicyCall), [*locations datasets dicom stores store instances*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetDicomStoreStoreInstanceCall), [*locations datasets dicom stores studies delete*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetDicomStoreStudyDeleteCall), [*locations datasets dicom stores studies retrieve metadata*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetDicomStoreStudyRetrieveMetadataCall), [*locations datasets dicom stores studies retrieve study*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetDicomStoreStudyRetrieveStudyCall), [*locations datasets dicom stores studies search for instances*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetDicomStoreStudySearchForInstanceCall), [*locations datasets dicom stores studies search for series*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetDicomStoreStudySearchForSeryCall), [*locations datasets dicom stores studies series delete*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetDicomStoreStudySeriesDeleteCall), [*locations datasets dicom stores studies series instances delete*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetDicomStoreStudySeriesInstanceDeleteCall), [*locations datasets dicom stores studies series instances frames retrieve frames*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetDicomStoreStudySeriesInstanceFrameRetrieveFrameCall), [*locations datasets dicom stores studies series instances frames retrieve rendered*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetDicomStoreStudySeriesInstanceFrameRetrieveRenderedCall), [*locations datasets dicom stores studies series instances retrieve instance*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetDicomStoreStudySeriesInstanceRetrieveInstanceCall), [*locations datasets dicom stores studies series instances retrieve metadata*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetDicomStoreStudySeriesInstanceRetrieveMetadataCall), [*locations datasets dicom stores studies series instances retrieve rendered*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetDicomStoreStudySeriesInstanceRetrieveRenderedCall), [*locations datasets dicom stores studies series retrieve metadata*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetDicomStoreStudySeriesRetrieveMetadataCall), [*locations datasets dicom stores studies series retrieve series*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetDicomStoreStudySeriesRetrieveSeryCall), [*locations datasets dicom stores studies series search for instances*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetDicomStoreStudySeriesSearchForInstanceCall), [*locations datasets dicom stores studies store instances*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetDicomStoreStudyStoreInstanceCall), [*locations datasets dicom stores test iam permissions*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetDicomStoreTestIamPermissionCall), [*locations datasets fhir stores create*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetFhirStoreCreateCall), [*locations datasets fhir stores deidentify*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetFhirStoreDeidentifyCall), [*locations datasets fhir stores delete*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetFhirStoreDeleteCall), [*locations datasets fhir stores export*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetFhirStoreExportCall), [*locations datasets fhir stores fhir patient-everything*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetFhirStoreFhirPatientEverythingCall), [*locations datasets fhir stores fhir resource-purge*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetFhirStoreFhirResourcePurgeCall), [*locations datasets fhir stores fhir resource-validate*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetFhirStoreFhirResourceValidateCall), [*locations datasets fhir stores fhir capabilities*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetFhirStoreFhirCapabilityCall), [*locations datasets fhir stores fhir create*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetFhirStoreFhirCreateCall), [*locations datasets fhir stores fhir delete*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetFhirStoreFhirDeleteCall), [*locations datasets fhir stores fhir execute bundle*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetFhirStoreFhirExecuteBundleCall), [*locations datasets fhir stores fhir history*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetFhirStoreFhirHistoryCall), [*locations datasets fhir stores fhir patch*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetFhirStoreFhirPatchCall), [*locations datasets fhir stores fhir read*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetFhirStoreFhirReadCall), [*locations datasets fhir stores fhir search*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetFhirStoreFhirSearchCall), [*locations datasets fhir stores fhir search-type*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetFhirStoreFhirSearchTypeCall), [*locations datasets fhir stores fhir update*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetFhirStoreFhirUpdateCall), [*locations datasets fhir stores fhir vread*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetFhirStoreFhirVreadCall), [*locations datasets fhir stores get*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetFhirStoreGetCall), [*locations datasets fhir stores get iam policy*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetFhirStoreGetIamPolicyCall), [*locations datasets fhir stores import*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetFhirStoreImportCall), [*locations datasets fhir stores list*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetFhirStoreListCall), [*locations datasets fhir stores patch*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetFhirStorePatchCall), [*locations datasets fhir stores set iam policy*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetFhirStoreSetIamPolicyCall), [*locations datasets fhir stores test iam permissions*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetFhirStoreTestIamPermissionCall), [*locations datasets get*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetGetCall), [*locations datasets get iam policy*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetGetIamPolicyCall), [*locations datasets hl7 v2 stores create*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetHl7V2StoreCreateCall), [*locations datasets hl7 v2 stores delete*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetHl7V2StoreDeleteCall), [*locations datasets hl7 v2 stores export*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetHl7V2StoreExportCall), [*locations datasets hl7 v2 stores get*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetHl7V2StoreGetCall), [*locations datasets hl7 v2 stores get iam policy*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetHl7V2StoreGetIamPolicyCall), [*locations datasets hl7 v2 stores import*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetHl7V2StoreImportCall), [*locations datasets hl7 v2 stores list*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetHl7V2StoreListCall), [*locations datasets hl7 v2 stores messages create*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetHl7V2StoreMessageCreateCall), [*locations datasets hl7 v2 stores messages delete*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetHl7V2StoreMessageDeleteCall), [*locations datasets hl7 v2 stores messages get*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetHl7V2StoreMessageGetCall), [*locations datasets hl7 v2 stores messages ingest*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetHl7V2StoreMessageIngestCall), [*locations datasets hl7 v2 stores messages list*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetHl7V2StoreMessageListCall), [*locations datasets hl7 v2 stores messages patch*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetHl7V2StoreMessagePatchCall), [*locations datasets hl7 v2 stores patch*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetHl7V2StorePatchCall), [*locations datasets hl7 v2 stores set iam policy*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetHl7V2StoreSetIamPolicyCall), [*locations datasets hl7 v2 stores test iam permissions*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetHl7V2StoreTestIamPermissionCall), [*locations datasets list*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetListCall), [*locations datasets operations cancel*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetOperationCancelCall), [*locations datasets operations get*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetOperationGetCall), [*locations datasets operations list*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetOperationListCall), [*locations datasets patch*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetPatchCall), [*locations datasets set iam policy*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetSetIamPolicyCall), [*locations datasets test iam permissions*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationDatasetTestIamPermissionCall), [*locations get*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationGetCall), [*locations list*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationListCall) and [*locations services nlp analyze entities*](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/api::ProjectLocationServiceNlpAnalyzeEntityCall) @@ -79,8 +79,8 @@ let r = hub.projects().locations_datasets_fhir_stores_fhir_update(...).doit().aw let r = hub.projects().locations_datasets_fhir_stores_fhir_vread(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -107,12 +107,12 @@ use healthcare1::{Result, Error}; use std::default::Default; use healthcare1::{CloudHealthcare, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -154,10 +154,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -167,25 +167,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-health You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/client::Delegate) to the -[Method Builder](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/client::Delegate) to the +[Method Builder](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/client::RequestValue) and -[decodable](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/client::RequestValue) and +[decodable](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-healthcare1/5.0.3+20221220/google_healthcare1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -204,7 +204,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **healthcare1** library was generated by Sebastian Thiel, and is placed +The **healthcare1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/healthcare1/src/api.rs b/gen/healthcare1/src/api.rs index bdc0a888ed..270bf42306 100644 --- a/gen/healthcare1/src/api.rs +++ b/gen/healthcare1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use healthcare1::{CloudHealthcare, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/healthcare1/src/lib.rs b/gen/healthcare1/src/lib.rs index d1150b7d96..66b8fcf3ec 100644 --- a/gen/healthcare1/src/lib.rs +++ b/gen/healthcare1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/healthcare1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudHealthcare) ... +//! Handle the following *Resources* with ease from the central [hub](CloudHealthcare) ... //! //! * projects //! * [*locations datasets consent stores attribute definitions create*](api::ProjectLocationDatasetConsentStoreAttributeDefinitionCreateCall), [*locations datasets consent stores attribute definitions delete*](api::ProjectLocationDatasetConsentStoreAttributeDefinitionDeleteCall), [*locations datasets consent stores attribute definitions get*](api::ProjectLocationDatasetConsentStoreAttributeDefinitionGetCall), [*locations datasets consent stores attribute definitions list*](api::ProjectLocationDatasetConsentStoreAttributeDefinitionListCall), [*locations datasets consent stores attribute definitions patch*](api::ProjectLocationDatasetConsentStoreAttributeDefinitionPatchCall), [*locations datasets consent stores check data access*](api::ProjectLocationDatasetConsentStoreCheckDataAccesCall), [*locations datasets consent stores consent artifacts create*](api::ProjectLocationDatasetConsentStoreConsentArtifactCreateCall), [*locations datasets consent stores consent artifacts delete*](api::ProjectLocationDatasetConsentStoreConsentArtifactDeleteCall), [*locations datasets consent stores consent artifacts get*](api::ProjectLocationDatasetConsentStoreConsentArtifactGetCall), [*locations datasets consent stores consent artifacts list*](api::ProjectLocationDatasetConsentStoreConsentArtifactListCall), [*locations datasets consent stores consents activate*](api::ProjectLocationDatasetConsentStoreConsentActivateCall), [*locations datasets consent stores consents create*](api::ProjectLocationDatasetConsentStoreConsentCreateCall), [*locations datasets consent stores consents delete*](api::ProjectLocationDatasetConsentStoreConsentDeleteCall), [*locations datasets consent stores consents delete revision*](api::ProjectLocationDatasetConsentStoreConsentDeleteRevisionCall), [*locations datasets consent stores consents get*](api::ProjectLocationDatasetConsentStoreConsentGetCall), [*locations datasets consent stores consents list*](api::ProjectLocationDatasetConsentStoreConsentListCall), [*locations datasets consent stores consents list revisions*](api::ProjectLocationDatasetConsentStoreConsentListRevisionCall), [*locations datasets consent stores consents patch*](api::ProjectLocationDatasetConsentStoreConsentPatchCall), [*locations datasets consent stores consents reject*](api::ProjectLocationDatasetConsentStoreConsentRejectCall), [*locations datasets consent stores consents revoke*](api::ProjectLocationDatasetConsentStoreConsentRevokeCall), [*locations datasets consent stores create*](api::ProjectLocationDatasetConsentStoreCreateCall), [*locations datasets consent stores delete*](api::ProjectLocationDatasetConsentStoreDeleteCall), [*locations datasets consent stores evaluate user consents*](api::ProjectLocationDatasetConsentStoreEvaluateUserConsentCall), [*locations datasets consent stores get*](api::ProjectLocationDatasetConsentStoreGetCall), [*locations datasets consent stores get iam policy*](api::ProjectLocationDatasetConsentStoreGetIamPolicyCall), [*locations datasets consent stores list*](api::ProjectLocationDatasetConsentStoreListCall), [*locations datasets consent stores patch*](api::ProjectLocationDatasetConsentStorePatchCall), [*locations datasets consent stores query accessible data*](api::ProjectLocationDatasetConsentStoreQueryAccessibleDataCall), [*locations datasets consent stores set iam policy*](api::ProjectLocationDatasetConsentStoreSetIamPolicyCall), [*locations datasets consent stores test iam permissions*](api::ProjectLocationDatasetConsentStoreTestIamPermissionCall), [*locations datasets consent stores user data mappings archive*](api::ProjectLocationDatasetConsentStoreUserDataMappingArchiveCall), [*locations datasets consent stores user data mappings create*](api::ProjectLocationDatasetConsentStoreUserDataMappingCreateCall), [*locations datasets consent stores user data mappings delete*](api::ProjectLocationDatasetConsentStoreUserDataMappingDeleteCall), [*locations datasets consent stores user data mappings get*](api::ProjectLocationDatasetConsentStoreUserDataMappingGetCall), [*locations datasets consent stores user data mappings list*](api::ProjectLocationDatasetConsentStoreUserDataMappingListCall), [*locations datasets consent stores user data mappings patch*](api::ProjectLocationDatasetConsentStoreUserDataMappingPatchCall), [*locations datasets create*](api::ProjectLocationDatasetCreateCall), [*locations datasets deidentify*](api::ProjectLocationDatasetDeidentifyCall), [*locations datasets delete*](api::ProjectLocationDatasetDeleteCall), [*locations datasets dicom stores create*](api::ProjectLocationDatasetDicomStoreCreateCall), [*locations datasets dicom stores deidentify*](api::ProjectLocationDatasetDicomStoreDeidentifyCall), [*locations datasets dicom stores delete*](api::ProjectLocationDatasetDicomStoreDeleteCall), [*locations datasets dicom stores export*](api::ProjectLocationDatasetDicomStoreExportCall), [*locations datasets dicom stores get*](api::ProjectLocationDatasetDicomStoreGetCall), [*locations datasets dicom stores get iam policy*](api::ProjectLocationDatasetDicomStoreGetIamPolicyCall), [*locations datasets dicom stores import*](api::ProjectLocationDatasetDicomStoreImportCall), [*locations datasets dicom stores list*](api::ProjectLocationDatasetDicomStoreListCall), [*locations datasets dicom stores patch*](api::ProjectLocationDatasetDicomStorePatchCall), [*locations datasets dicom stores search for instances*](api::ProjectLocationDatasetDicomStoreSearchForInstanceCall), [*locations datasets dicom stores search for series*](api::ProjectLocationDatasetDicomStoreSearchForSeryCall), [*locations datasets dicom stores search for studies*](api::ProjectLocationDatasetDicomStoreSearchForStudyCall), [*locations datasets dicom stores set iam policy*](api::ProjectLocationDatasetDicomStoreSetIamPolicyCall), [*locations datasets dicom stores store instances*](api::ProjectLocationDatasetDicomStoreStoreInstanceCall), [*locations datasets dicom stores studies delete*](api::ProjectLocationDatasetDicomStoreStudyDeleteCall), [*locations datasets dicom stores studies retrieve metadata*](api::ProjectLocationDatasetDicomStoreStudyRetrieveMetadataCall), [*locations datasets dicom stores studies retrieve study*](api::ProjectLocationDatasetDicomStoreStudyRetrieveStudyCall), [*locations datasets dicom stores studies search for instances*](api::ProjectLocationDatasetDicomStoreStudySearchForInstanceCall), [*locations datasets dicom stores studies search for series*](api::ProjectLocationDatasetDicomStoreStudySearchForSeryCall), [*locations datasets dicom stores studies series delete*](api::ProjectLocationDatasetDicomStoreStudySeriesDeleteCall), [*locations datasets dicom stores studies series instances delete*](api::ProjectLocationDatasetDicomStoreStudySeriesInstanceDeleteCall), [*locations datasets dicom stores studies series instances frames retrieve frames*](api::ProjectLocationDatasetDicomStoreStudySeriesInstanceFrameRetrieveFrameCall), [*locations datasets dicom stores studies series instances frames retrieve rendered*](api::ProjectLocationDatasetDicomStoreStudySeriesInstanceFrameRetrieveRenderedCall), [*locations datasets dicom stores studies series instances retrieve instance*](api::ProjectLocationDatasetDicomStoreStudySeriesInstanceRetrieveInstanceCall), [*locations datasets dicom stores studies series instances retrieve metadata*](api::ProjectLocationDatasetDicomStoreStudySeriesInstanceRetrieveMetadataCall), [*locations datasets dicom stores studies series instances retrieve rendered*](api::ProjectLocationDatasetDicomStoreStudySeriesInstanceRetrieveRenderedCall), [*locations datasets dicom stores studies series retrieve metadata*](api::ProjectLocationDatasetDicomStoreStudySeriesRetrieveMetadataCall), [*locations datasets dicom stores studies series retrieve series*](api::ProjectLocationDatasetDicomStoreStudySeriesRetrieveSeryCall), [*locations datasets dicom stores studies series search for instances*](api::ProjectLocationDatasetDicomStoreStudySeriesSearchForInstanceCall), [*locations datasets dicom stores studies store instances*](api::ProjectLocationDatasetDicomStoreStudyStoreInstanceCall), [*locations datasets dicom stores test iam permissions*](api::ProjectLocationDatasetDicomStoreTestIamPermissionCall), [*locations datasets fhir stores create*](api::ProjectLocationDatasetFhirStoreCreateCall), [*locations datasets fhir stores deidentify*](api::ProjectLocationDatasetFhirStoreDeidentifyCall), [*locations datasets fhir stores delete*](api::ProjectLocationDatasetFhirStoreDeleteCall), [*locations datasets fhir stores export*](api::ProjectLocationDatasetFhirStoreExportCall), [*locations datasets fhir stores fhir patient-everything*](api::ProjectLocationDatasetFhirStoreFhirPatientEverythingCall), [*locations datasets fhir stores fhir resource-purge*](api::ProjectLocationDatasetFhirStoreFhirResourcePurgeCall), [*locations datasets fhir stores fhir resource-validate*](api::ProjectLocationDatasetFhirStoreFhirResourceValidateCall), [*locations datasets fhir stores fhir capabilities*](api::ProjectLocationDatasetFhirStoreFhirCapabilityCall), [*locations datasets fhir stores fhir create*](api::ProjectLocationDatasetFhirStoreFhirCreateCall), [*locations datasets fhir stores fhir delete*](api::ProjectLocationDatasetFhirStoreFhirDeleteCall), [*locations datasets fhir stores fhir execute bundle*](api::ProjectLocationDatasetFhirStoreFhirExecuteBundleCall), [*locations datasets fhir stores fhir history*](api::ProjectLocationDatasetFhirStoreFhirHistoryCall), [*locations datasets fhir stores fhir patch*](api::ProjectLocationDatasetFhirStoreFhirPatchCall), [*locations datasets fhir stores fhir read*](api::ProjectLocationDatasetFhirStoreFhirReadCall), [*locations datasets fhir stores fhir search*](api::ProjectLocationDatasetFhirStoreFhirSearchCall), [*locations datasets fhir stores fhir search-type*](api::ProjectLocationDatasetFhirStoreFhirSearchTypeCall), [*locations datasets fhir stores fhir update*](api::ProjectLocationDatasetFhirStoreFhirUpdateCall), [*locations datasets fhir stores fhir vread*](api::ProjectLocationDatasetFhirStoreFhirVreadCall), [*locations datasets fhir stores get*](api::ProjectLocationDatasetFhirStoreGetCall), [*locations datasets fhir stores get iam policy*](api::ProjectLocationDatasetFhirStoreGetIamPolicyCall), [*locations datasets fhir stores import*](api::ProjectLocationDatasetFhirStoreImportCall), [*locations datasets fhir stores list*](api::ProjectLocationDatasetFhirStoreListCall), [*locations datasets fhir stores patch*](api::ProjectLocationDatasetFhirStorePatchCall), [*locations datasets fhir stores set iam policy*](api::ProjectLocationDatasetFhirStoreSetIamPolicyCall), [*locations datasets fhir stores test iam permissions*](api::ProjectLocationDatasetFhirStoreTestIamPermissionCall), [*locations datasets get*](api::ProjectLocationDatasetGetCall), [*locations datasets get iam policy*](api::ProjectLocationDatasetGetIamPolicyCall), [*locations datasets hl7 v2 stores create*](api::ProjectLocationDatasetHl7V2StoreCreateCall), [*locations datasets hl7 v2 stores delete*](api::ProjectLocationDatasetHl7V2StoreDeleteCall), [*locations datasets hl7 v2 stores export*](api::ProjectLocationDatasetHl7V2StoreExportCall), [*locations datasets hl7 v2 stores get*](api::ProjectLocationDatasetHl7V2StoreGetCall), [*locations datasets hl7 v2 stores get iam policy*](api::ProjectLocationDatasetHl7V2StoreGetIamPolicyCall), [*locations datasets hl7 v2 stores import*](api::ProjectLocationDatasetHl7V2StoreImportCall), [*locations datasets hl7 v2 stores list*](api::ProjectLocationDatasetHl7V2StoreListCall), [*locations datasets hl7 v2 stores messages create*](api::ProjectLocationDatasetHl7V2StoreMessageCreateCall), [*locations datasets hl7 v2 stores messages delete*](api::ProjectLocationDatasetHl7V2StoreMessageDeleteCall), [*locations datasets hl7 v2 stores messages get*](api::ProjectLocationDatasetHl7V2StoreMessageGetCall), [*locations datasets hl7 v2 stores messages ingest*](api::ProjectLocationDatasetHl7V2StoreMessageIngestCall), [*locations datasets hl7 v2 stores messages list*](api::ProjectLocationDatasetHl7V2StoreMessageListCall), [*locations datasets hl7 v2 stores messages patch*](api::ProjectLocationDatasetHl7V2StoreMessagePatchCall), [*locations datasets hl7 v2 stores patch*](api::ProjectLocationDatasetHl7V2StorePatchCall), [*locations datasets hl7 v2 stores set iam policy*](api::ProjectLocationDatasetHl7V2StoreSetIamPolicyCall), [*locations datasets hl7 v2 stores test iam permissions*](api::ProjectLocationDatasetHl7V2StoreTestIamPermissionCall), [*locations datasets list*](api::ProjectLocationDatasetListCall), [*locations datasets operations cancel*](api::ProjectLocationDatasetOperationCancelCall), [*locations datasets operations get*](api::ProjectLocationDatasetOperationGetCall), [*locations datasets operations list*](api::ProjectLocationDatasetOperationListCall), [*locations datasets patch*](api::ProjectLocationDatasetPatchCall), [*locations datasets set iam policy*](api::ProjectLocationDatasetSetIamPolicyCall), [*locations datasets test iam permissions*](api::ProjectLocationDatasetTestIamPermissionCall), [*locations get*](api::ProjectLocationGetCall), [*locations list*](api::ProjectLocationListCall) and [*locations services nlp analyze entities*](api::ProjectLocationServiceNlpAnalyzeEntityCall) @@ -79,8 +79,8 @@ //! let r = hub.projects().locations_datasets_fhir_stores_fhir_vread(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -108,12 +108,12 @@ //! use std::default::Default; //! use healthcare1::{CloudHealthcare, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -155,10 +155,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -168,25 +168,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/healthcare1_beta1/README.md b/gen/healthcare1_beta1/README.md index e4841ee8dd..bd095312f8 100644 --- a/gen/healthcare1_beta1/README.md +++ b/gen/healthcare1_beta1/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Healthcare* *v1_beta1* API can be found at the [official documentation site](https://cloud.google.com/healthcare). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/CloudHealthcare) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/CloudHealthcare) ... * projects * [*locations datasets annotation stores annotations create*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetAnnotationStoreAnnotationCreateCall), [*locations datasets annotation stores annotations delete*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetAnnotationStoreAnnotationDeleteCall), [*locations datasets annotation stores annotations get*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetAnnotationStoreAnnotationGetCall), [*locations datasets annotation stores annotations list*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetAnnotationStoreAnnotationListCall), [*locations datasets annotation stores annotations patch*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetAnnotationStoreAnnotationPatchCall), [*locations datasets annotation stores create*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetAnnotationStoreCreateCall), [*locations datasets annotation stores delete*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetAnnotationStoreDeleteCall), [*locations datasets annotation stores evaluate*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetAnnotationStoreEvaluateCall), [*locations datasets annotation stores export*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetAnnotationStoreExportCall), [*locations datasets annotation stores get*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetAnnotationStoreGetCall), [*locations datasets annotation stores get iam policy*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetAnnotationStoreGetIamPolicyCall), [*locations datasets annotation stores import*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetAnnotationStoreImportCall), [*locations datasets annotation stores list*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetAnnotationStoreListCall), [*locations datasets annotation stores patch*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetAnnotationStorePatchCall), [*locations datasets annotation stores set iam policy*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetAnnotationStoreSetIamPolicyCall), [*locations datasets annotation stores test iam permissions*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetAnnotationStoreTestIamPermissionCall), [*locations datasets consent stores attribute definitions create*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetConsentStoreAttributeDefinitionCreateCall), [*locations datasets consent stores attribute definitions delete*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetConsentStoreAttributeDefinitionDeleteCall), [*locations datasets consent stores attribute definitions get*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetConsentStoreAttributeDefinitionGetCall), [*locations datasets consent stores attribute definitions list*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetConsentStoreAttributeDefinitionListCall), [*locations datasets consent stores attribute definitions patch*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetConsentStoreAttributeDefinitionPatchCall), [*locations datasets consent stores check data access*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetConsentStoreCheckDataAccesCall), [*locations datasets consent stores consent artifacts create*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetConsentStoreConsentArtifactCreateCall), [*locations datasets consent stores consent artifacts delete*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetConsentStoreConsentArtifactDeleteCall), [*locations datasets consent stores consent artifacts get*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetConsentStoreConsentArtifactGetCall), [*locations datasets consent stores consent artifacts list*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetConsentStoreConsentArtifactListCall), [*locations datasets consent stores consents activate*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetConsentStoreConsentActivateCall), [*locations datasets consent stores consents create*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetConsentStoreConsentCreateCall), [*locations datasets consent stores consents delete*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetConsentStoreConsentDeleteCall), [*locations datasets consent stores consents delete revision*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetConsentStoreConsentDeleteRevisionCall), [*locations datasets consent stores consents get*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetConsentStoreConsentGetCall), [*locations datasets consent stores consents list*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetConsentStoreConsentListCall), [*locations datasets consent stores consents list revisions*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetConsentStoreConsentListRevisionCall), [*locations datasets consent stores consents patch*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetConsentStoreConsentPatchCall), [*locations datasets consent stores consents reject*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetConsentStoreConsentRejectCall), [*locations datasets consent stores consents revoke*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetConsentStoreConsentRevokeCall), [*locations datasets consent stores create*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetConsentStoreCreateCall), [*locations datasets consent stores delete*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetConsentStoreDeleteCall), [*locations datasets consent stores evaluate user consents*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetConsentStoreEvaluateUserConsentCall), [*locations datasets consent stores get*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetConsentStoreGetCall), [*locations datasets consent stores get iam policy*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetConsentStoreGetIamPolicyCall), [*locations datasets consent stores list*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetConsentStoreListCall), [*locations datasets consent stores patch*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetConsentStorePatchCall), [*locations datasets consent stores query accessible data*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetConsentStoreQueryAccessibleDataCall), [*locations datasets consent stores set iam policy*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetConsentStoreSetIamPolicyCall), [*locations datasets consent stores test iam permissions*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetConsentStoreTestIamPermissionCall), [*locations datasets consent stores user data mappings archive*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetConsentStoreUserDataMappingArchiveCall), [*locations datasets consent stores user data mappings create*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetConsentStoreUserDataMappingCreateCall), [*locations datasets consent stores user data mappings delete*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetConsentStoreUserDataMappingDeleteCall), [*locations datasets consent stores user data mappings get*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetConsentStoreUserDataMappingGetCall), [*locations datasets consent stores user data mappings list*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetConsentStoreUserDataMappingListCall), [*locations datasets consent stores user data mappings patch*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetConsentStoreUserDataMappingPatchCall), [*locations datasets create*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetCreateCall), [*locations datasets deidentify*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetDeidentifyCall), [*locations datasets delete*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetDeleteCall), [*locations datasets dicom stores create*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetDicomStoreCreateCall), [*locations datasets dicom stores deidentify*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetDicomStoreDeidentifyCall), [*locations datasets dicom stores delete*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetDicomStoreDeleteCall), [*locations datasets dicom stores export*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetDicomStoreExportCall), [*locations datasets dicom stores get*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetDicomStoreGetCall), [*locations datasets dicom stores get iam policy*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetDicomStoreGetIamPolicyCall), [*locations datasets dicom stores import*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetDicomStoreImportCall), [*locations datasets dicom stores list*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetDicomStoreListCall), [*locations datasets dicom stores patch*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetDicomStorePatchCall), [*locations datasets dicom stores search for instances*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetDicomStoreSearchForInstanceCall), [*locations datasets dicom stores search for series*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetDicomStoreSearchForSeryCall), [*locations datasets dicom stores search for studies*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetDicomStoreSearchForStudyCall), [*locations datasets dicom stores set iam policy*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetDicomStoreSetIamPolicyCall), [*locations datasets dicom stores store instances*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetDicomStoreStoreInstanceCall), [*locations datasets dicom stores studies delete*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetDicomStoreStudyDeleteCall), [*locations datasets dicom stores studies retrieve metadata*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetDicomStoreStudyRetrieveMetadataCall), [*locations datasets dicom stores studies retrieve study*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetDicomStoreStudyRetrieveStudyCall), [*locations datasets dicom stores studies search for instances*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetDicomStoreStudySearchForInstanceCall), [*locations datasets dicom stores studies search for series*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetDicomStoreStudySearchForSeryCall), [*locations datasets dicom stores studies series delete*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetDicomStoreStudySeriesDeleteCall), [*locations datasets dicom stores studies series instances delete*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetDicomStoreStudySeriesInstanceDeleteCall), [*locations datasets dicom stores studies series instances frames retrieve frames*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetDicomStoreStudySeriesInstanceFrameRetrieveFrameCall), [*locations datasets dicom stores studies series instances frames retrieve rendered*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetDicomStoreStudySeriesInstanceFrameRetrieveRenderedCall), [*locations datasets dicom stores studies series instances retrieve instance*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetDicomStoreStudySeriesInstanceRetrieveInstanceCall), [*locations datasets dicom stores studies series instances retrieve metadata*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetDicomStoreStudySeriesInstanceRetrieveMetadataCall), [*locations datasets dicom stores studies series instances retrieve rendered*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetDicomStoreStudySeriesInstanceRetrieveRenderedCall), [*locations datasets dicom stores studies series retrieve metadata*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetDicomStoreStudySeriesRetrieveMetadataCall), [*locations datasets dicom stores studies series retrieve series*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetDicomStoreStudySeriesRetrieveSeryCall), [*locations datasets dicom stores studies series search for instances*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetDicomStoreStudySeriesSearchForInstanceCall), [*locations datasets dicom stores studies store instances*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetDicomStoreStudyStoreInstanceCall), [*locations datasets dicom stores test iam permissions*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetDicomStoreTestIamPermissionCall), [*locations datasets fhir stores configure search*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetFhirStoreConfigureSearchCall), [*locations datasets fhir stores create*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetFhirStoreCreateCall), [*locations datasets fhir stores deidentify*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetFhirStoreDeidentifyCall), [*locations datasets fhir stores delete*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetFhirStoreDeleteCall), [*locations datasets fhir stores export*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetFhirStoreExportCall), [*locations datasets fhir stores fhir concept map-search-translate*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetFhirStoreFhirConceptMapSearchTranslateCall), [*locations datasets fhir stores fhir concept map-translate*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetFhirStoreFhirConceptMapTranslateCall), [*locations datasets fhir stores fhir observation-lastn*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetFhirStoreFhirObservationLastnCall), [*locations datasets fhir stores fhir patient-everything*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetFhirStoreFhirPatientEverythingCall), [*locations datasets fhir stores fhir resource-purge*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetFhirStoreFhirResourcePurgeCall), [*locations datasets fhir stores fhir resource-validate*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetFhirStoreFhirResourceValidateCall), [*locations datasets fhir stores fhir capabilities*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetFhirStoreFhirCapabilityCall), [*locations datasets fhir stores fhir conditional delete*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetFhirStoreFhirConditionalDeleteCall), [*locations datasets fhir stores fhir conditional patch*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetFhirStoreFhirConditionalPatchCall), [*locations datasets fhir stores fhir conditional update*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetFhirStoreFhirConditionalUpdateCall), [*locations datasets fhir stores fhir create*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetFhirStoreFhirCreateCall), [*locations datasets fhir stores fhir delete*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetFhirStoreFhirDeleteCall), [*locations datasets fhir stores fhir execute bundle*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetFhirStoreFhirExecuteBundleCall), [*locations datasets fhir stores fhir history*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetFhirStoreFhirHistoryCall), [*locations datasets fhir stores fhir patch*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetFhirStoreFhirPatchCall), [*locations datasets fhir stores fhir read*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetFhirStoreFhirReadCall), [*locations datasets fhir stores fhir search*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetFhirStoreFhirSearchCall), [*locations datasets fhir stores fhir search-type*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetFhirStoreFhirSearchTypeCall), [*locations datasets fhir stores fhir update*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetFhirStoreFhirUpdateCall), [*locations datasets fhir stores fhir vread*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetFhirStoreFhirVreadCall), [*locations datasets fhir stores get*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetFhirStoreGetCall), [*locations datasets fhir stores get iam policy*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetFhirStoreGetIamPolicyCall), [*locations datasets fhir stores import*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetFhirStoreImportCall), [*locations datasets fhir stores list*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetFhirStoreListCall), [*locations datasets fhir stores patch*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetFhirStorePatchCall), [*locations datasets fhir stores set iam policy*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetFhirStoreSetIamPolicyCall), [*locations datasets fhir stores test iam permissions*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetFhirStoreTestIamPermissionCall), [*locations datasets get*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetGetCall), [*locations datasets get iam policy*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetGetIamPolicyCall), [*locations datasets hl7 v2 stores create*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetHl7V2StoreCreateCall), [*locations datasets hl7 v2 stores delete*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetHl7V2StoreDeleteCall), [*locations datasets hl7 v2 stores export*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetHl7V2StoreExportCall), [*locations datasets hl7 v2 stores get*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetHl7V2StoreGetCall), [*locations datasets hl7 v2 stores get iam policy*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetHl7V2StoreGetIamPolicyCall), [*locations datasets hl7 v2 stores import*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetHl7V2StoreImportCall), [*locations datasets hl7 v2 stores list*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetHl7V2StoreListCall), [*locations datasets hl7 v2 stores messages batch get*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetHl7V2StoreMessageBatchGetCall), [*locations datasets hl7 v2 stores messages create*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetHl7V2StoreMessageCreateCall), [*locations datasets hl7 v2 stores messages delete*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetHl7V2StoreMessageDeleteCall), [*locations datasets hl7 v2 stores messages get*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetHl7V2StoreMessageGetCall), [*locations datasets hl7 v2 stores messages ingest*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetHl7V2StoreMessageIngestCall), [*locations datasets hl7 v2 stores messages list*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetHl7V2StoreMessageListCall), [*locations datasets hl7 v2 stores messages patch*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetHl7V2StoreMessagePatchCall), [*locations datasets hl7 v2 stores patch*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetHl7V2StorePatchCall), [*locations datasets hl7 v2 stores set iam policy*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetHl7V2StoreSetIamPolicyCall), [*locations datasets hl7 v2 stores test iam permissions*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetHl7V2StoreTestIamPermissionCall), [*locations datasets list*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetListCall), [*locations datasets operations cancel*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetOperationCancelCall), [*locations datasets operations get*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetOperationGetCall), [*locations datasets operations list*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetOperationListCall), [*locations datasets patch*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetPatchCall), [*locations datasets set iam policy*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetSetIamPolicyCall), [*locations datasets test iam permissions*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationDatasetTestIamPermissionCall), [*locations get*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationGetCall), [*locations list*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationListCall) and [*locations services nlp analyze entities*](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/api::ProjectLocationServiceNlpAnalyzeEntityCall) @@ -84,8 +84,8 @@ let r = hub.projects().locations_datasets_fhir_stores_fhir_update(...).doit().aw let r = hub.projects().locations_datasets_fhir_stores_fhir_vread(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -112,12 +112,12 @@ use healthcare1_beta1::{Result, Error}; use std::default::Default; use healthcare1_beta1::{CloudHealthcare, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -159,10 +159,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -172,25 +172,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-health You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/client::Delegate) to the -[Method Builder](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/client::Delegate) to the +[Method Builder](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/client::RequestValue) and -[decodable](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/client::RequestValue) and +[decodable](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-healthcare1_beta1/5.0.3+20221220/google_healthcare1_beta1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -209,7 +209,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **healthcare1_beta1** library was generated by Sebastian Thiel, and is placed +The **healthcare1_beta1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/healthcare1_beta1/src/api.rs b/gen/healthcare1_beta1/src/api.rs index 40a39c4a7a..8f02787650 100644 --- a/gen/healthcare1_beta1/src/api.rs +++ b/gen/healthcare1_beta1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use healthcare1_beta1::{CloudHealthcare, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/healthcare1_beta1/src/lib.rs b/gen/healthcare1_beta1/src/lib.rs index 8141830f1b..19284e504d 100644 --- a/gen/healthcare1_beta1/src/lib.rs +++ b/gen/healthcare1_beta1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/healthcare1_beta1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudHealthcare) ... +//! Handle the following *Resources* with ease from the central [hub](CloudHealthcare) ... //! //! * projects //! * [*locations datasets annotation stores annotations create*](api::ProjectLocationDatasetAnnotationStoreAnnotationCreateCall), [*locations datasets annotation stores annotations delete*](api::ProjectLocationDatasetAnnotationStoreAnnotationDeleteCall), [*locations datasets annotation stores annotations get*](api::ProjectLocationDatasetAnnotationStoreAnnotationGetCall), [*locations datasets annotation stores annotations list*](api::ProjectLocationDatasetAnnotationStoreAnnotationListCall), [*locations datasets annotation stores annotations patch*](api::ProjectLocationDatasetAnnotationStoreAnnotationPatchCall), [*locations datasets annotation stores create*](api::ProjectLocationDatasetAnnotationStoreCreateCall), [*locations datasets annotation stores delete*](api::ProjectLocationDatasetAnnotationStoreDeleteCall), [*locations datasets annotation stores evaluate*](api::ProjectLocationDatasetAnnotationStoreEvaluateCall), [*locations datasets annotation stores export*](api::ProjectLocationDatasetAnnotationStoreExportCall), [*locations datasets annotation stores get*](api::ProjectLocationDatasetAnnotationStoreGetCall), [*locations datasets annotation stores get iam policy*](api::ProjectLocationDatasetAnnotationStoreGetIamPolicyCall), [*locations datasets annotation stores import*](api::ProjectLocationDatasetAnnotationStoreImportCall), [*locations datasets annotation stores list*](api::ProjectLocationDatasetAnnotationStoreListCall), [*locations datasets annotation stores patch*](api::ProjectLocationDatasetAnnotationStorePatchCall), [*locations datasets annotation stores set iam policy*](api::ProjectLocationDatasetAnnotationStoreSetIamPolicyCall), [*locations datasets annotation stores test iam permissions*](api::ProjectLocationDatasetAnnotationStoreTestIamPermissionCall), [*locations datasets consent stores attribute definitions create*](api::ProjectLocationDatasetConsentStoreAttributeDefinitionCreateCall), [*locations datasets consent stores attribute definitions delete*](api::ProjectLocationDatasetConsentStoreAttributeDefinitionDeleteCall), [*locations datasets consent stores attribute definitions get*](api::ProjectLocationDatasetConsentStoreAttributeDefinitionGetCall), [*locations datasets consent stores attribute definitions list*](api::ProjectLocationDatasetConsentStoreAttributeDefinitionListCall), [*locations datasets consent stores attribute definitions patch*](api::ProjectLocationDatasetConsentStoreAttributeDefinitionPatchCall), [*locations datasets consent stores check data access*](api::ProjectLocationDatasetConsentStoreCheckDataAccesCall), [*locations datasets consent stores consent artifacts create*](api::ProjectLocationDatasetConsentStoreConsentArtifactCreateCall), [*locations datasets consent stores consent artifacts delete*](api::ProjectLocationDatasetConsentStoreConsentArtifactDeleteCall), [*locations datasets consent stores consent artifacts get*](api::ProjectLocationDatasetConsentStoreConsentArtifactGetCall), [*locations datasets consent stores consent artifacts list*](api::ProjectLocationDatasetConsentStoreConsentArtifactListCall), [*locations datasets consent stores consents activate*](api::ProjectLocationDatasetConsentStoreConsentActivateCall), [*locations datasets consent stores consents create*](api::ProjectLocationDatasetConsentStoreConsentCreateCall), [*locations datasets consent stores consents delete*](api::ProjectLocationDatasetConsentStoreConsentDeleteCall), [*locations datasets consent stores consents delete revision*](api::ProjectLocationDatasetConsentStoreConsentDeleteRevisionCall), [*locations datasets consent stores consents get*](api::ProjectLocationDatasetConsentStoreConsentGetCall), [*locations datasets consent stores consents list*](api::ProjectLocationDatasetConsentStoreConsentListCall), [*locations datasets consent stores consents list revisions*](api::ProjectLocationDatasetConsentStoreConsentListRevisionCall), [*locations datasets consent stores consents patch*](api::ProjectLocationDatasetConsentStoreConsentPatchCall), [*locations datasets consent stores consents reject*](api::ProjectLocationDatasetConsentStoreConsentRejectCall), [*locations datasets consent stores consents revoke*](api::ProjectLocationDatasetConsentStoreConsentRevokeCall), [*locations datasets consent stores create*](api::ProjectLocationDatasetConsentStoreCreateCall), [*locations datasets consent stores delete*](api::ProjectLocationDatasetConsentStoreDeleteCall), [*locations datasets consent stores evaluate user consents*](api::ProjectLocationDatasetConsentStoreEvaluateUserConsentCall), [*locations datasets consent stores get*](api::ProjectLocationDatasetConsentStoreGetCall), [*locations datasets consent stores get iam policy*](api::ProjectLocationDatasetConsentStoreGetIamPolicyCall), [*locations datasets consent stores list*](api::ProjectLocationDatasetConsentStoreListCall), [*locations datasets consent stores patch*](api::ProjectLocationDatasetConsentStorePatchCall), [*locations datasets consent stores query accessible data*](api::ProjectLocationDatasetConsentStoreQueryAccessibleDataCall), [*locations datasets consent stores set iam policy*](api::ProjectLocationDatasetConsentStoreSetIamPolicyCall), [*locations datasets consent stores test iam permissions*](api::ProjectLocationDatasetConsentStoreTestIamPermissionCall), [*locations datasets consent stores user data mappings archive*](api::ProjectLocationDatasetConsentStoreUserDataMappingArchiveCall), [*locations datasets consent stores user data mappings create*](api::ProjectLocationDatasetConsentStoreUserDataMappingCreateCall), [*locations datasets consent stores user data mappings delete*](api::ProjectLocationDatasetConsentStoreUserDataMappingDeleteCall), [*locations datasets consent stores user data mappings get*](api::ProjectLocationDatasetConsentStoreUserDataMappingGetCall), [*locations datasets consent stores user data mappings list*](api::ProjectLocationDatasetConsentStoreUserDataMappingListCall), [*locations datasets consent stores user data mappings patch*](api::ProjectLocationDatasetConsentStoreUserDataMappingPatchCall), [*locations datasets create*](api::ProjectLocationDatasetCreateCall), [*locations datasets deidentify*](api::ProjectLocationDatasetDeidentifyCall), [*locations datasets delete*](api::ProjectLocationDatasetDeleteCall), [*locations datasets dicom stores create*](api::ProjectLocationDatasetDicomStoreCreateCall), [*locations datasets dicom stores deidentify*](api::ProjectLocationDatasetDicomStoreDeidentifyCall), [*locations datasets dicom stores delete*](api::ProjectLocationDatasetDicomStoreDeleteCall), [*locations datasets dicom stores export*](api::ProjectLocationDatasetDicomStoreExportCall), [*locations datasets dicom stores get*](api::ProjectLocationDatasetDicomStoreGetCall), [*locations datasets dicom stores get iam policy*](api::ProjectLocationDatasetDicomStoreGetIamPolicyCall), [*locations datasets dicom stores import*](api::ProjectLocationDatasetDicomStoreImportCall), [*locations datasets dicom stores list*](api::ProjectLocationDatasetDicomStoreListCall), [*locations datasets dicom stores patch*](api::ProjectLocationDatasetDicomStorePatchCall), [*locations datasets dicom stores search for instances*](api::ProjectLocationDatasetDicomStoreSearchForInstanceCall), [*locations datasets dicom stores search for series*](api::ProjectLocationDatasetDicomStoreSearchForSeryCall), [*locations datasets dicom stores search for studies*](api::ProjectLocationDatasetDicomStoreSearchForStudyCall), [*locations datasets dicom stores set iam policy*](api::ProjectLocationDatasetDicomStoreSetIamPolicyCall), [*locations datasets dicom stores store instances*](api::ProjectLocationDatasetDicomStoreStoreInstanceCall), [*locations datasets dicom stores studies delete*](api::ProjectLocationDatasetDicomStoreStudyDeleteCall), [*locations datasets dicom stores studies retrieve metadata*](api::ProjectLocationDatasetDicomStoreStudyRetrieveMetadataCall), [*locations datasets dicom stores studies retrieve study*](api::ProjectLocationDatasetDicomStoreStudyRetrieveStudyCall), [*locations datasets dicom stores studies search for instances*](api::ProjectLocationDatasetDicomStoreStudySearchForInstanceCall), [*locations datasets dicom stores studies search for series*](api::ProjectLocationDatasetDicomStoreStudySearchForSeryCall), [*locations datasets dicom stores studies series delete*](api::ProjectLocationDatasetDicomStoreStudySeriesDeleteCall), [*locations datasets dicom stores studies series instances delete*](api::ProjectLocationDatasetDicomStoreStudySeriesInstanceDeleteCall), [*locations datasets dicom stores studies series instances frames retrieve frames*](api::ProjectLocationDatasetDicomStoreStudySeriesInstanceFrameRetrieveFrameCall), [*locations datasets dicom stores studies series instances frames retrieve rendered*](api::ProjectLocationDatasetDicomStoreStudySeriesInstanceFrameRetrieveRenderedCall), [*locations datasets dicom stores studies series instances retrieve instance*](api::ProjectLocationDatasetDicomStoreStudySeriesInstanceRetrieveInstanceCall), [*locations datasets dicom stores studies series instances retrieve metadata*](api::ProjectLocationDatasetDicomStoreStudySeriesInstanceRetrieveMetadataCall), [*locations datasets dicom stores studies series instances retrieve rendered*](api::ProjectLocationDatasetDicomStoreStudySeriesInstanceRetrieveRenderedCall), [*locations datasets dicom stores studies series retrieve metadata*](api::ProjectLocationDatasetDicomStoreStudySeriesRetrieveMetadataCall), [*locations datasets dicom stores studies series retrieve series*](api::ProjectLocationDatasetDicomStoreStudySeriesRetrieveSeryCall), [*locations datasets dicom stores studies series search for instances*](api::ProjectLocationDatasetDicomStoreStudySeriesSearchForInstanceCall), [*locations datasets dicom stores studies store instances*](api::ProjectLocationDatasetDicomStoreStudyStoreInstanceCall), [*locations datasets dicom stores test iam permissions*](api::ProjectLocationDatasetDicomStoreTestIamPermissionCall), [*locations datasets fhir stores configure search*](api::ProjectLocationDatasetFhirStoreConfigureSearchCall), [*locations datasets fhir stores create*](api::ProjectLocationDatasetFhirStoreCreateCall), [*locations datasets fhir stores deidentify*](api::ProjectLocationDatasetFhirStoreDeidentifyCall), [*locations datasets fhir stores delete*](api::ProjectLocationDatasetFhirStoreDeleteCall), [*locations datasets fhir stores export*](api::ProjectLocationDatasetFhirStoreExportCall), [*locations datasets fhir stores fhir concept map-search-translate*](api::ProjectLocationDatasetFhirStoreFhirConceptMapSearchTranslateCall), [*locations datasets fhir stores fhir concept map-translate*](api::ProjectLocationDatasetFhirStoreFhirConceptMapTranslateCall), [*locations datasets fhir stores fhir observation-lastn*](api::ProjectLocationDatasetFhirStoreFhirObservationLastnCall), [*locations datasets fhir stores fhir patient-everything*](api::ProjectLocationDatasetFhirStoreFhirPatientEverythingCall), [*locations datasets fhir stores fhir resource-purge*](api::ProjectLocationDatasetFhirStoreFhirResourcePurgeCall), [*locations datasets fhir stores fhir resource-validate*](api::ProjectLocationDatasetFhirStoreFhirResourceValidateCall), [*locations datasets fhir stores fhir capabilities*](api::ProjectLocationDatasetFhirStoreFhirCapabilityCall), [*locations datasets fhir stores fhir conditional delete*](api::ProjectLocationDatasetFhirStoreFhirConditionalDeleteCall), [*locations datasets fhir stores fhir conditional patch*](api::ProjectLocationDatasetFhirStoreFhirConditionalPatchCall), [*locations datasets fhir stores fhir conditional update*](api::ProjectLocationDatasetFhirStoreFhirConditionalUpdateCall), [*locations datasets fhir stores fhir create*](api::ProjectLocationDatasetFhirStoreFhirCreateCall), [*locations datasets fhir stores fhir delete*](api::ProjectLocationDatasetFhirStoreFhirDeleteCall), [*locations datasets fhir stores fhir execute bundle*](api::ProjectLocationDatasetFhirStoreFhirExecuteBundleCall), [*locations datasets fhir stores fhir history*](api::ProjectLocationDatasetFhirStoreFhirHistoryCall), [*locations datasets fhir stores fhir patch*](api::ProjectLocationDatasetFhirStoreFhirPatchCall), [*locations datasets fhir stores fhir read*](api::ProjectLocationDatasetFhirStoreFhirReadCall), [*locations datasets fhir stores fhir search*](api::ProjectLocationDatasetFhirStoreFhirSearchCall), [*locations datasets fhir stores fhir search-type*](api::ProjectLocationDatasetFhirStoreFhirSearchTypeCall), [*locations datasets fhir stores fhir update*](api::ProjectLocationDatasetFhirStoreFhirUpdateCall), [*locations datasets fhir stores fhir vread*](api::ProjectLocationDatasetFhirStoreFhirVreadCall), [*locations datasets fhir stores get*](api::ProjectLocationDatasetFhirStoreGetCall), [*locations datasets fhir stores get iam policy*](api::ProjectLocationDatasetFhirStoreGetIamPolicyCall), [*locations datasets fhir stores import*](api::ProjectLocationDatasetFhirStoreImportCall), [*locations datasets fhir stores list*](api::ProjectLocationDatasetFhirStoreListCall), [*locations datasets fhir stores patch*](api::ProjectLocationDatasetFhirStorePatchCall), [*locations datasets fhir stores set iam policy*](api::ProjectLocationDatasetFhirStoreSetIamPolicyCall), [*locations datasets fhir stores test iam permissions*](api::ProjectLocationDatasetFhirStoreTestIamPermissionCall), [*locations datasets get*](api::ProjectLocationDatasetGetCall), [*locations datasets get iam policy*](api::ProjectLocationDatasetGetIamPolicyCall), [*locations datasets hl7 v2 stores create*](api::ProjectLocationDatasetHl7V2StoreCreateCall), [*locations datasets hl7 v2 stores delete*](api::ProjectLocationDatasetHl7V2StoreDeleteCall), [*locations datasets hl7 v2 stores export*](api::ProjectLocationDatasetHl7V2StoreExportCall), [*locations datasets hl7 v2 stores get*](api::ProjectLocationDatasetHl7V2StoreGetCall), [*locations datasets hl7 v2 stores get iam policy*](api::ProjectLocationDatasetHl7V2StoreGetIamPolicyCall), [*locations datasets hl7 v2 stores import*](api::ProjectLocationDatasetHl7V2StoreImportCall), [*locations datasets hl7 v2 stores list*](api::ProjectLocationDatasetHl7V2StoreListCall), [*locations datasets hl7 v2 stores messages batch get*](api::ProjectLocationDatasetHl7V2StoreMessageBatchGetCall), [*locations datasets hl7 v2 stores messages create*](api::ProjectLocationDatasetHl7V2StoreMessageCreateCall), [*locations datasets hl7 v2 stores messages delete*](api::ProjectLocationDatasetHl7V2StoreMessageDeleteCall), [*locations datasets hl7 v2 stores messages get*](api::ProjectLocationDatasetHl7V2StoreMessageGetCall), [*locations datasets hl7 v2 stores messages ingest*](api::ProjectLocationDatasetHl7V2StoreMessageIngestCall), [*locations datasets hl7 v2 stores messages list*](api::ProjectLocationDatasetHl7V2StoreMessageListCall), [*locations datasets hl7 v2 stores messages patch*](api::ProjectLocationDatasetHl7V2StoreMessagePatchCall), [*locations datasets hl7 v2 stores patch*](api::ProjectLocationDatasetHl7V2StorePatchCall), [*locations datasets hl7 v2 stores set iam policy*](api::ProjectLocationDatasetHl7V2StoreSetIamPolicyCall), [*locations datasets hl7 v2 stores test iam permissions*](api::ProjectLocationDatasetHl7V2StoreTestIamPermissionCall), [*locations datasets list*](api::ProjectLocationDatasetListCall), [*locations datasets operations cancel*](api::ProjectLocationDatasetOperationCancelCall), [*locations datasets operations get*](api::ProjectLocationDatasetOperationGetCall), [*locations datasets operations list*](api::ProjectLocationDatasetOperationListCall), [*locations datasets patch*](api::ProjectLocationDatasetPatchCall), [*locations datasets set iam policy*](api::ProjectLocationDatasetSetIamPolicyCall), [*locations datasets test iam permissions*](api::ProjectLocationDatasetTestIamPermissionCall), [*locations get*](api::ProjectLocationGetCall), [*locations list*](api::ProjectLocationListCall) and [*locations services nlp analyze entities*](api::ProjectLocationServiceNlpAnalyzeEntityCall) @@ -84,8 +84,8 @@ //! let r = hub.projects().locations_datasets_fhir_stores_fhir_vread(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -113,12 +113,12 @@ //! use std::default::Default; //! use healthcare1_beta1::{CloudHealthcare, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -160,10 +160,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -173,25 +173,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/iam1/README.md b/gen/iam1/README.md index d2c8ef2dfb..370cdcf59f 100644 --- a/gen/iam1/README.md +++ b/gen/iam1/README.md @@ -11,7 +11,7 @@ Everything else about the *Iam* *v1* API can be found at the [official documentation site](https://cloud.google.com/iam/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-iam1/5.0.3+20230112/google_iam1/Iam) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-iam1/5.0.3+20230112/google_iam1/Iam) ... * iam policies * [*lint policy*](https://docs.rs/google-iam1/5.0.3+20230112/google_iam1/api::IamPolicyLintPolicyCall) and [*query auditable services*](https://docs.rs/google-iam1/5.0.3+20230112/google_iam1/api::IamPolicyQueryAuditableServiceCall) @@ -74,8 +74,8 @@ let r = hub.projects().locations_workload_identity_pools_patch(...).doit().await let r = hub.projects().locations_workload_identity_pools_undelete(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -103,12 +103,12 @@ use iam1::{Result, Error}; use std::default::Default; use iam1::{Iam, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -150,10 +150,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-iam1/5.0.3+20230112/google_iam1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-iam1/5.0.3+20230112/google_iam1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -163,25 +163,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-iam1/5 You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-iam1/5.0.3+20230112/google_iam1/client::Delegate) to the -[Method Builder](https://docs.rs/google-iam1/5.0.3+20230112/google_iam1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-iam1/5.0.3+20230112/google_iam1/client::Delegate) to the +[Method Builder](https://docs.rs/google-iam1/5.0.3+20230112/google_iam1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-iam1/5.0.3+20230112/google_iam1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-iam1/5.0.3+20230112/google_iam1/client::RequestValue) and -[decodable](https://docs.rs/google-iam1/5.0.3+20230112/google_iam1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-iam1/5.0.3+20230112/google_iam1/client::RequestValue) and +[decodable](https://docs.rs/google-iam1/5.0.3+20230112/google_iam1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-iam1/5.0.3+20230112/google_iam1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-iam1/5.0.3+20230112/google_iam1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -200,7 +200,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **iam1** library was generated by Sebastian Thiel, and is placed +The **iam1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/iam1/src/api.rs b/gen/iam1/src/api.rs index cde704f837..021ff9f019 100644 --- a/gen/iam1/src/api.rs +++ b/gen/iam1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use iam1::{Iam, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/iam1/src/lib.rs b/gen/iam1/src/lib.rs index 79ba7db896..8d7809df3d 100644 --- a/gen/iam1/src/lib.rs +++ b/gen/iam1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/iam1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Iam) ... +//! Handle the following *Resources* with ease from the central [hub](Iam) ... //! //! * iam policies //! * [*lint policy*](api::IamPolicyLintPolicyCall) and [*query auditable services*](api::IamPolicyQueryAuditableServiceCall) @@ -74,8 +74,8 @@ //! let r = hub.projects().locations_workload_identity_pools_undelete(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -104,12 +104,12 @@ //! use std::default::Default; //! use iam1::{Iam, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -151,10 +151,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -164,25 +164,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/iamcredentials1/README.md b/gen/iamcredentials1/README.md index 008dc78c27..320401ae24 100644 --- a/gen/iamcredentials1/README.md +++ b/gen/iamcredentials1/README.md @@ -11,7 +11,7 @@ Everything else about the *IAM Credentials* *v1* API can be found at the [official documentation site](https://cloud.google.com/iam/docs/creating-short-lived-service-account-credentials). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-iamcredentials1/5.0.3+20230113/google_iamcredentials1/IAMCredentials) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-iamcredentials1/5.0.3+20230113/google_iamcredentials1/IAMCredentials) ... * projects * [*service accounts generate access token*](https://docs.rs/google-iamcredentials1/5.0.3+20230113/google_iamcredentials1/api::ProjectServiceAccountGenerateAccessTokenCall), [*service accounts generate id token*](https://docs.rs/google-iamcredentials1/5.0.3+20230113/google_iamcredentials1/api::ProjectServiceAccountGenerateIdTokenCall), [*service accounts sign blob*](https://docs.rs/google-iamcredentials1/5.0.3+20230113/google_iamcredentials1/api::ProjectServiceAccountSignBlobCall) and [*service accounts sign jwt*](https://docs.rs/google-iamcredentials1/5.0.3+20230113/google_iamcredentials1/api::ProjectServiceAccountSignJwtCall) @@ -50,8 +50,8 @@ Or specifically ... let r = hub.projects().service_accounts_generate_access_token(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -79,12 +79,12 @@ use iamcredentials1::{Result, Error}; use std::default::Default; use iamcredentials1::{IAMCredentials, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -125,10 +125,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-iamcredentials1/5.0.3+20230113/google_iamcredentials1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-iamcredentials1/5.0.3+20230113/google_iamcredentials1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -138,25 +138,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-iamcre You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-iamcredentials1/5.0.3+20230113/google_iamcredentials1/client::Delegate) to the -[Method Builder](https://docs.rs/google-iamcredentials1/5.0.3+20230113/google_iamcredentials1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-iamcredentials1/5.0.3+20230113/google_iamcredentials1/client::Delegate) to the +[Method Builder](https://docs.rs/google-iamcredentials1/5.0.3+20230113/google_iamcredentials1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-iamcredentials1/5.0.3+20230113/google_iamcredentials1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-iamcredentials1/5.0.3+20230113/google_iamcredentials1/client::RequestValue) and -[decodable](https://docs.rs/google-iamcredentials1/5.0.3+20230113/google_iamcredentials1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-iamcredentials1/5.0.3+20230113/google_iamcredentials1/client::RequestValue) and +[decodable](https://docs.rs/google-iamcredentials1/5.0.3+20230113/google_iamcredentials1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-iamcredentials1/5.0.3+20230113/google_iamcredentials1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-iamcredentials1/5.0.3+20230113/google_iamcredentials1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -175,7 +175,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **iamcredentials1** library was generated by Sebastian Thiel, and is placed +The **iamcredentials1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/iamcredentials1/src/api.rs b/gen/iamcredentials1/src/api.rs index bb74eaa1eb..1c95f9c4e5 100644 --- a/gen/iamcredentials1/src/api.rs +++ b/gen/iamcredentials1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use iamcredentials1::{IAMCredentials, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/iamcredentials1/src/lib.rs b/gen/iamcredentials1/src/lib.rs index 2f9e162d77..190df33fed 100644 --- a/gen/iamcredentials1/src/lib.rs +++ b/gen/iamcredentials1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/iamcredentials1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](IAMCredentials) ... +//! Handle the following *Resources* with ease from the central [hub](IAMCredentials) ... //! //! * projects //! * [*service accounts generate access token*](api::ProjectServiceAccountGenerateAccessTokenCall), [*service accounts generate id token*](api::ProjectServiceAccountGenerateIdTokenCall), [*service accounts sign blob*](api::ProjectServiceAccountSignBlobCall) and [*service accounts sign jwt*](api::ProjectServiceAccountSignJwtCall) @@ -50,8 +50,8 @@ //! let r = hub.projects().service_accounts_generate_access_token(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -80,12 +80,12 @@ //! use std::default::Default; //! use iamcredentials1::{IAMCredentials, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -126,10 +126,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -139,25 +139,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/iap1/README.md b/gen/iap1/README.md index e97714e378..59aa293f05 100644 --- a/gen/iap1/README.md +++ b/gen/iap1/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud IAP* *v1* API can be found at the [official documentation site](https://cloud.google.com/iap). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-iap1/5.0.3+20230118/google_iap1/CloudIAP) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-iap1/5.0.3+20230118/google_iap1/CloudIAP) ... * projects * [*brands create*](https://docs.rs/google-iap1/5.0.3+20230118/google_iap1/api::ProjectBrandCreateCall), [*brands get*](https://docs.rs/google-iap1/5.0.3+20230118/google_iap1/api::ProjectBrandGetCall), [*brands identity aware proxy clients create*](https://docs.rs/google-iap1/5.0.3+20230118/google_iap1/api::ProjectBrandIdentityAwareProxyClientCreateCall), [*brands identity aware proxy clients delete*](https://docs.rs/google-iap1/5.0.3+20230118/google_iap1/api::ProjectBrandIdentityAwareProxyClientDeleteCall), [*brands identity aware proxy clients get*](https://docs.rs/google-iap1/5.0.3+20230118/google_iap1/api::ProjectBrandIdentityAwareProxyClientGetCall), [*brands identity aware proxy clients list*](https://docs.rs/google-iap1/5.0.3+20230118/google_iap1/api::ProjectBrandIdentityAwareProxyClientListCall), [*brands identity aware proxy clients reset secret*](https://docs.rs/google-iap1/5.0.3+20230118/google_iap1/api::ProjectBrandIdentityAwareProxyClientResetSecretCall), [*brands list*](https://docs.rs/google-iap1/5.0.3+20230118/google_iap1/api::ProjectBrandListCall), [*iap_tunnel locations dest groups create*](https://docs.rs/google-iap1/5.0.3+20230118/google_iap1/api::ProjectIapTunnelLocationDestGroupCreateCall), [*iap_tunnel locations dest groups delete*](https://docs.rs/google-iap1/5.0.3+20230118/google_iap1/api::ProjectIapTunnelLocationDestGroupDeleteCall), [*iap_tunnel locations dest groups get*](https://docs.rs/google-iap1/5.0.3+20230118/google_iap1/api::ProjectIapTunnelLocationDestGroupGetCall), [*iap_tunnel locations dest groups list*](https://docs.rs/google-iap1/5.0.3+20230118/google_iap1/api::ProjectIapTunnelLocationDestGroupListCall) and [*iap_tunnel locations dest groups patch*](https://docs.rs/google-iap1/5.0.3+20230118/google_iap1/api::ProjectIapTunnelLocationDestGroupPatchCall) @@ -59,8 +59,8 @@ let r = hub.projects().brands_identity_aware_proxy_clients_get(...).doit().await let r = hub.projects().brands_identity_aware_proxy_clients_reset_secret(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -88,12 +88,12 @@ use iap1::{Result, Error}; use std::default::Default; use iap1::{CloudIAP, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -134,10 +134,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-iap1/5.0.3+20230118/google_iap1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-iap1/5.0.3+20230118/google_iap1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -147,25 +147,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-iap1/5 You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-iap1/5.0.3+20230118/google_iap1/client::Delegate) to the -[Method Builder](https://docs.rs/google-iap1/5.0.3+20230118/google_iap1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-iap1/5.0.3+20230118/google_iap1/client::Delegate) to the +[Method Builder](https://docs.rs/google-iap1/5.0.3+20230118/google_iap1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-iap1/5.0.3+20230118/google_iap1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-iap1/5.0.3+20230118/google_iap1/client::RequestValue) and -[decodable](https://docs.rs/google-iap1/5.0.3+20230118/google_iap1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-iap1/5.0.3+20230118/google_iap1/client::RequestValue) and +[decodable](https://docs.rs/google-iap1/5.0.3+20230118/google_iap1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-iap1/5.0.3+20230118/google_iap1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-iap1/5.0.3+20230118/google_iap1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -184,7 +184,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **iap1** library was generated by Sebastian Thiel, and is placed +The **iap1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/iap1/src/api.rs b/gen/iap1/src/api.rs index 296fecfef4..339d2d18f7 100644 --- a/gen/iap1/src/api.rs +++ b/gen/iap1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use iap1::{CloudIAP, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/iap1/src/lib.rs b/gen/iap1/src/lib.rs index f8145c373d..ad2d8c8a3f 100644 --- a/gen/iap1/src/lib.rs +++ b/gen/iap1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/iap1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudIAP) ... +//! Handle the following *Resources* with ease from the central [hub](CloudIAP) ... //! //! * projects //! * [*brands create*](api::ProjectBrandCreateCall), [*brands get*](api::ProjectBrandGetCall), [*brands identity aware proxy clients create*](api::ProjectBrandIdentityAwareProxyClientCreateCall), [*brands identity aware proxy clients delete*](api::ProjectBrandIdentityAwareProxyClientDeleteCall), [*brands identity aware proxy clients get*](api::ProjectBrandIdentityAwareProxyClientGetCall), [*brands identity aware proxy clients list*](api::ProjectBrandIdentityAwareProxyClientListCall), [*brands identity aware proxy clients reset secret*](api::ProjectBrandIdentityAwareProxyClientResetSecretCall), [*brands list*](api::ProjectBrandListCall), [*iap_tunnel locations dest groups create*](api::ProjectIapTunnelLocationDestGroupCreateCall), [*iap_tunnel locations dest groups delete*](api::ProjectIapTunnelLocationDestGroupDeleteCall), [*iap_tunnel locations dest groups get*](api::ProjectIapTunnelLocationDestGroupGetCall), [*iap_tunnel locations dest groups list*](api::ProjectIapTunnelLocationDestGroupListCall) and [*iap_tunnel locations dest groups patch*](api::ProjectIapTunnelLocationDestGroupPatchCall) @@ -59,8 +59,8 @@ //! let r = hub.projects().brands_identity_aware_proxy_clients_reset_secret(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -89,12 +89,12 @@ //! use std::default::Default; //! use iap1::{CloudIAP, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -135,10 +135,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -148,25 +148,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/iap1_beta1/README.md b/gen/iap1_beta1/README.md index e6be5020b0..7d1dcc1465 100644 --- a/gen/iap1_beta1/README.md +++ b/gen/iap1_beta1/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud IAP* *v1_beta1* API can be found at the [official documentation site](https://cloud.google.com/iap). # Features -Use the following functionality with ease from the central [hub](https://docs.rs/google-iap1_beta1/5.0.3+20230118/google_iap1_beta1/CloudIAP) ... +Use the following functionality with ease from the central [hub](https://docs.rs/google-iap1_beta1/5.0.3+20230118/google_iap1_beta1/CloudIAP) ... * [get iam policy](https://docs.rs/google-iap1_beta1/5.0.3+20230118/google_iap1_beta1/api::MethodGetIamPolicyCall) @@ -52,8 +52,8 @@ let r = hub.methods().get_iam_policy(...).doit().await let r = hub.methods().set_iam_policy(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -81,12 +81,12 @@ use iap1_beta1::{Result, Error}; use std::default::Default; use iap1_beta1::{CloudIAP, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -127,10 +127,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-iap1_beta1/5.0.3+20230118/google_iap1_beta1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-iap1_beta1/5.0.3+20230118/google_iap1_beta1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -140,25 +140,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-iap1_b You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-iap1_beta1/5.0.3+20230118/google_iap1_beta1/client::Delegate) to the -[Method Builder](https://docs.rs/google-iap1_beta1/5.0.3+20230118/google_iap1_beta1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-iap1_beta1/5.0.3+20230118/google_iap1_beta1/client::Delegate) to the +[Method Builder](https://docs.rs/google-iap1_beta1/5.0.3+20230118/google_iap1_beta1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-iap1_beta1/5.0.3+20230118/google_iap1_beta1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-iap1_beta1/5.0.3+20230118/google_iap1_beta1/client::RequestValue) and -[decodable](https://docs.rs/google-iap1_beta1/5.0.3+20230118/google_iap1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-iap1_beta1/5.0.3+20230118/google_iap1_beta1/client::RequestValue) and +[decodable](https://docs.rs/google-iap1_beta1/5.0.3+20230118/google_iap1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-iap1_beta1/5.0.3+20230118/google_iap1_beta1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-iap1_beta1/5.0.3+20230118/google_iap1_beta1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -177,7 +177,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **iap1_beta1** library was generated by Sebastian Thiel, and is placed +The **iap1_beta1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/iap1_beta1/src/api.rs b/gen/iap1_beta1/src/api.rs index ffdfe34662..f84d728255 100644 --- a/gen/iap1_beta1/src/api.rs +++ b/gen/iap1_beta1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use iap1_beta1::{CloudIAP, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/iap1_beta1/src/lib.rs b/gen/iap1_beta1/src/lib.rs index 002ccfe04b..e323ae9b76 100644 --- a/gen/iap1_beta1/src/lib.rs +++ b/gen/iap1_beta1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/iap1_beta1). //! # Features //! -//! Use the following functionality with ease from the central [hub](CloudIAP) ... +//! Use the following functionality with ease from the central [hub](CloudIAP) ... //! //! //! * [get iam policy](api::MethodGetIamPolicyCall) @@ -52,8 +52,8 @@ //! let r = hub.methods().set_iam_policy(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -82,12 +82,12 @@ //! use std::default::Default; //! use iap1_beta1::{CloudIAP, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -128,10 +128,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -141,25 +141,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/ideahub1_beta/README.md b/gen/ideahub1_beta/README.md index 4ced72fe94..ce0ed4af92 100644 --- a/gen/ideahub1_beta/README.md +++ b/gen/ideahub1_beta/README.md @@ -11,7 +11,7 @@ Everything else about the *Ideahub* *v1_beta* API can be found at the [official documentation site](https://console.cloud.google.com/apis/library/ideahub.googleapis.com). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-ideahub1_beta/5.0.3+20220305/google_ideahub1_beta/Ideahub) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-ideahub1_beta/5.0.3+20220305/google_ideahub1_beta/Ideahub) ... * platforms * [*properties idea activities create*](https://docs.rs/google-ideahub1_beta/5.0.3+20220305/google_ideahub1_beta/api::PlatformPropertyIdeaActivityCreateCall), [*properties idea states patch*](https://docs.rs/google-ideahub1_beta/5.0.3+20220305/google_ideahub1_beta/api::PlatformPropertyIdeaStatePatchCall), [*properties ideas list*](https://docs.rs/google-ideahub1_beta/5.0.3+20220305/google_ideahub1_beta/api::PlatformPropertyIdeaListCall), [*properties locales list*](https://docs.rs/google-ideahub1_beta/5.0.3+20220305/google_ideahub1_beta/api::PlatformPropertyLocaleListCall) and [*properties topic states patch*](https://docs.rs/google-ideahub1_beta/5.0.3+20220305/google_ideahub1_beta/api::PlatformPropertyTopicStatePatchCall) @@ -50,8 +50,8 @@ Or specifically ... let r = hub.platforms().properties_idea_activities_create(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -79,12 +79,12 @@ use ideahub1_beta::{Result, Error}; use std::default::Default; use ideahub1_beta::{Ideahub, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -125,10 +125,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-ideahub1_beta/5.0.3+20220305/google_ideahub1_beta/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-ideahub1_beta/5.0.3+20220305/google_ideahub1_beta/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -138,25 +138,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-ideahu You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-ideahub1_beta/5.0.3+20220305/google_ideahub1_beta/client::Delegate) to the -[Method Builder](https://docs.rs/google-ideahub1_beta/5.0.3+20220305/google_ideahub1_beta/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-ideahub1_beta/5.0.3+20220305/google_ideahub1_beta/client::Delegate) to the +[Method Builder](https://docs.rs/google-ideahub1_beta/5.0.3+20220305/google_ideahub1_beta/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-ideahub1_beta/5.0.3+20220305/google_ideahub1_beta/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-ideahub1_beta/5.0.3+20220305/google_ideahub1_beta/client::RequestValue) and -[decodable](https://docs.rs/google-ideahub1_beta/5.0.3+20220305/google_ideahub1_beta/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-ideahub1_beta/5.0.3+20220305/google_ideahub1_beta/client::RequestValue) and +[decodable](https://docs.rs/google-ideahub1_beta/5.0.3+20220305/google_ideahub1_beta/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-ideahub1_beta/5.0.3+20220305/google_ideahub1_beta/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-ideahub1_beta/5.0.3+20220305/google_ideahub1_beta/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -175,7 +175,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **ideahub1_beta** library was generated by Sebastian Thiel, and is placed +The **ideahub1_beta** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/ideahub1_beta/src/api.rs b/gen/ideahub1_beta/src/api.rs index c8c3a1ce98..43140bc8d6 100644 --- a/gen/ideahub1_beta/src/api.rs +++ b/gen/ideahub1_beta/src/api.rs @@ -43,12 +43,12 @@ use crate::{client, client::GetToken, client::serde_with}; /// use std::default::Default; /// use ideahub1_beta::{Ideahub, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/ideahub1_beta/src/lib.rs b/gen/ideahub1_beta/src/lib.rs index c88c7bc0d7..fe88c05dd3 100644 --- a/gen/ideahub1_beta/src/lib.rs +++ b/gen/ideahub1_beta/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/ideahub1_beta). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Ideahub) ... +//! Handle the following *Resources* with ease from the central [hub](Ideahub) ... //! //! * platforms //! * [*properties idea activities create*](api::PlatformPropertyIdeaActivityCreateCall), [*properties idea states patch*](api::PlatformPropertyIdeaStatePatchCall), [*properties ideas list*](api::PlatformPropertyIdeaListCall), [*properties locales list*](api::PlatformPropertyLocaleListCall) and [*properties topic states patch*](api::PlatformPropertyTopicStatePatchCall) @@ -50,8 +50,8 @@ //! let r = hub.platforms().properties_idea_activities_create(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -80,12 +80,12 @@ //! use std::default::Default; //! use ideahub1_beta::{Ideahub, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -126,10 +126,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -139,25 +139,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/identitytoolkit3/README.md b/gen/identitytoolkit3/README.md index a4fac64ad5..f93fde113e 100644 --- a/gen/identitytoolkit3/README.md +++ b/gen/identitytoolkit3/README.md @@ -11,7 +11,7 @@ Everything else about the *Identity Toolkit* *v3* API can be found at the [official documentation site](https://developers.google.com/identity-toolkit/v3/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-identitytoolkit3/5.0.3+20180723/google_identitytoolkit3/IdentityToolkit) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-identitytoolkit3/5.0.3+20180723/google_identitytoolkit3/IdentityToolkit) ... * [relyingparty](https://docs.rs/google-identitytoolkit3/5.0.3+20180723/google_identitytoolkit3/api::Relyingparty) * [*create auth uri*](https://docs.rs/google-identitytoolkit3/5.0.3+20180723/google_identitytoolkit3/api::RelyingpartyCreateAuthUriCall), [*delete account*](https://docs.rs/google-identitytoolkit3/5.0.3+20180723/google_identitytoolkit3/api::RelyingpartyDeleteAccountCall), [*download account*](https://docs.rs/google-identitytoolkit3/5.0.3+20180723/google_identitytoolkit3/api::RelyingpartyDownloadAccountCall), [*email link signin*](https://docs.rs/google-identitytoolkit3/5.0.3+20180723/google_identitytoolkit3/api::RelyingpartyEmailLinkSigninCall), [*get account info*](https://docs.rs/google-identitytoolkit3/5.0.3+20180723/google_identitytoolkit3/api::RelyingpartyGetAccountInfoCall), [*get oob confirmation code*](https://docs.rs/google-identitytoolkit3/5.0.3+20180723/google_identitytoolkit3/api::RelyingpartyGetOobConfirmationCodeCall), [*get project config*](https://docs.rs/google-identitytoolkit3/5.0.3+20180723/google_identitytoolkit3/api::RelyingpartyGetProjectConfigCall), [*get public keys*](https://docs.rs/google-identitytoolkit3/5.0.3+20180723/google_identitytoolkit3/api::RelyingpartyGetPublicKeyCall), [*get recaptcha param*](https://docs.rs/google-identitytoolkit3/5.0.3+20180723/google_identitytoolkit3/api::RelyingpartyGetRecaptchaParamCall), [*reset password*](https://docs.rs/google-identitytoolkit3/5.0.3+20180723/google_identitytoolkit3/api::RelyingpartyResetPasswordCall), [*send verification code*](https://docs.rs/google-identitytoolkit3/5.0.3+20180723/google_identitytoolkit3/api::RelyingpartySendVerificationCodeCall), [*set account info*](https://docs.rs/google-identitytoolkit3/5.0.3+20180723/google_identitytoolkit3/api::RelyingpartySetAccountInfoCall), [*set project config*](https://docs.rs/google-identitytoolkit3/5.0.3+20180723/google_identitytoolkit3/api::RelyingpartySetProjectConfigCall), [*sign out user*](https://docs.rs/google-identitytoolkit3/5.0.3+20180723/google_identitytoolkit3/api::RelyingpartySignOutUserCall), [*signup new user*](https://docs.rs/google-identitytoolkit3/5.0.3+20180723/google_identitytoolkit3/api::RelyingpartySignupNewUserCall), [*upload account*](https://docs.rs/google-identitytoolkit3/5.0.3+20180723/google_identitytoolkit3/api::RelyingpartyUploadAccountCall), [*verify assertion*](https://docs.rs/google-identitytoolkit3/5.0.3+20180723/google_identitytoolkit3/api::RelyingpartyVerifyAssertionCall), [*verify custom token*](https://docs.rs/google-identitytoolkit3/5.0.3+20180723/google_identitytoolkit3/api::RelyingpartyVerifyCustomTokenCall), [*verify password*](https://docs.rs/google-identitytoolkit3/5.0.3+20180723/google_identitytoolkit3/api::RelyingpartyVerifyPasswordCall) and [*verify phone number*](https://docs.rs/google-identitytoolkit3/5.0.3+20180723/google_identitytoolkit3/api::RelyingpartyVerifyPhoneNumberCall) @@ -50,8 +50,8 @@ Or specifically ... let r = hub.relyingparty().verify_assertion(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -79,12 +79,12 @@ use identitytoolkit3::{Result, Error}; use std::default::Default; use identitytoolkit3::{IdentityToolkit, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -125,10 +125,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-identitytoolkit3/5.0.3+20180723/google_identitytoolkit3/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-identitytoolkit3/5.0.3+20180723/google_identitytoolkit3/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -138,25 +138,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-identi You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-identitytoolkit3/5.0.3+20180723/google_identitytoolkit3/client::Delegate) to the -[Method Builder](https://docs.rs/google-identitytoolkit3/5.0.3+20180723/google_identitytoolkit3/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-identitytoolkit3/5.0.3+20180723/google_identitytoolkit3/client::Delegate) to the +[Method Builder](https://docs.rs/google-identitytoolkit3/5.0.3+20180723/google_identitytoolkit3/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-identitytoolkit3/5.0.3+20180723/google_identitytoolkit3/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-identitytoolkit3/5.0.3+20180723/google_identitytoolkit3/client::RequestValue) and -[decodable](https://docs.rs/google-identitytoolkit3/5.0.3+20180723/google_identitytoolkit3/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-identitytoolkit3/5.0.3+20180723/google_identitytoolkit3/client::RequestValue) and +[decodable](https://docs.rs/google-identitytoolkit3/5.0.3+20180723/google_identitytoolkit3/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-identitytoolkit3/5.0.3+20180723/google_identitytoolkit3/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-identitytoolkit3/5.0.3+20180723/google_identitytoolkit3/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -175,7 +175,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **identitytoolkit3** library was generated by Sebastian Thiel, and is placed +The **identitytoolkit3** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/identitytoolkit3/src/api.rs b/gen/identitytoolkit3/src/api.rs index 62a612de34..b3308e88a4 100644 --- a/gen/identitytoolkit3/src/api.rs +++ b/gen/identitytoolkit3/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your data across Google Cloud Platform services CloudPlatform, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use identitytoolkit3::{IdentityToolkit, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/identitytoolkit3/src/lib.rs b/gen/identitytoolkit3/src/lib.rs index a78be50a83..7d8410f3eb 100644 --- a/gen/identitytoolkit3/src/lib.rs +++ b/gen/identitytoolkit3/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/identitytoolkit3). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](IdentityToolkit) ... +//! Handle the following *Resources* with ease from the central [hub](IdentityToolkit) ... //! //! * [relyingparty](api::Relyingparty) //! * [*create auth uri*](api::RelyingpartyCreateAuthUriCall), [*delete account*](api::RelyingpartyDeleteAccountCall), [*download account*](api::RelyingpartyDownloadAccountCall), [*email link signin*](api::RelyingpartyEmailLinkSigninCall), [*get account info*](api::RelyingpartyGetAccountInfoCall), [*get oob confirmation code*](api::RelyingpartyGetOobConfirmationCodeCall), [*get project config*](api::RelyingpartyGetProjectConfigCall), [*get public keys*](api::RelyingpartyGetPublicKeyCall), [*get recaptcha param*](api::RelyingpartyGetRecaptchaParamCall), [*reset password*](api::RelyingpartyResetPasswordCall), [*send verification code*](api::RelyingpartySendVerificationCodeCall), [*set account info*](api::RelyingpartySetAccountInfoCall), [*set project config*](api::RelyingpartySetProjectConfigCall), [*sign out user*](api::RelyingpartySignOutUserCall), [*signup new user*](api::RelyingpartySignupNewUserCall), [*upload account*](api::RelyingpartyUploadAccountCall), [*verify assertion*](api::RelyingpartyVerifyAssertionCall), [*verify custom token*](api::RelyingpartyVerifyCustomTokenCall), [*verify password*](api::RelyingpartyVerifyPasswordCall) and [*verify phone number*](api::RelyingpartyVerifyPhoneNumberCall) @@ -50,8 +50,8 @@ //! let r = hub.relyingparty().verify_assertion(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -80,12 +80,12 @@ //! use std::default::Default; //! use identitytoolkit3::{IdentityToolkit, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -126,10 +126,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -139,25 +139,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/ids1/README.md b/gen/ids1/README.md index 80710d0cd1..8d9418f39e 100644 --- a/gen/ids1/README.md +++ b/gen/ids1/README.md @@ -11,7 +11,7 @@ Everything else about the *IDS* *v1* API can be found at the [official documentation site](https://cloud.google.com/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-ids1/5.0.3+20221113/google_ids1/IDS) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-ids1/5.0.3+20221113/google_ids1/IDS) ... * projects * [*locations endpoints create*](https://docs.rs/google-ids1/5.0.3+20221113/google_ids1/api::ProjectLocationEndpointCreateCall), [*locations endpoints delete*](https://docs.rs/google-ids1/5.0.3+20221113/google_ids1/api::ProjectLocationEndpointDeleteCall), [*locations endpoints get*](https://docs.rs/google-ids1/5.0.3+20221113/google_ids1/api::ProjectLocationEndpointGetCall), [*locations endpoints get iam policy*](https://docs.rs/google-ids1/5.0.3+20221113/google_ids1/api::ProjectLocationEndpointGetIamPolicyCall), [*locations endpoints list*](https://docs.rs/google-ids1/5.0.3+20221113/google_ids1/api::ProjectLocationEndpointListCall), [*locations endpoints patch*](https://docs.rs/google-ids1/5.0.3+20221113/google_ids1/api::ProjectLocationEndpointPatchCall), [*locations endpoints set iam policy*](https://docs.rs/google-ids1/5.0.3+20221113/google_ids1/api::ProjectLocationEndpointSetIamPolicyCall), [*locations endpoints test iam permissions*](https://docs.rs/google-ids1/5.0.3+20221113/google_ids1/api::ProjectLocationEndpointTestIamPermissionCall), [*locations get*](https://docs.rs/google-ids1/5.0.3+20221113/google_ids1/api::ProjectLocationGetCall), [*locations list*](https://docs.rs/google-ids1/5.0.3+20221113/google_ids1/api::ProjectLocationListCall), [*locations operations cancel*](https://docs.rs/google-ids1/5.0.3+20221113/google_ids1/api::ProjectLocationOperationCancelCall), [*locations operations delete*](https://docs.rs/google-ids1/5.0.3+20221113/google_ids1/api::ProjectLocationOperationDeleteCall), [*locations operations get*](https://docs.rs/google-ids1/5.0.3+20221113/google_ids1/api::ProjectLocationOperationGetCall) and [*locations operations list*](https://docs.rs/google-ids1/5.0.3+20221113/google_ids1/api::ProjectLocationOperationListCall) @@ -53,8 +53,8 @@ let r = hub.projects().locations_endpoints_patch(...).doit().await let r = hub.projects().locations_operations_get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -82,12 +82,12 @@ use ids1::{Result, Error}; use std::default::Default; use ids1::{IDS, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -130,10 +130,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-ids1/5.0.3+20221113/google_ids1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-ids1/5.0.3+20221113/google_ids1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -143,25 +143,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-ids1/5 You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-ids1/5.0.3+20221113/google_ids1/client::Delegate) to the -[Method Builder](https://docs.rs/google-ids1/5.0.3+20221113/google_ids1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-ids1/5.0.3+20221113/google_ids1/client::Delegate) to the +[Method Builder](https://docs.rs/google-ids1/5.0.3+20221113/google_ids1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-ids1/5.0.3+20221113/google_ids1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-ids1/5.0.3+20221113/google_ids1/client::RequestValue) and -[decodable](https://docs.rs/google-ids1/5.0.3+20221113/google_ids1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-ids1/5.0.3+20221113/google_ids1/client::RequestValue) and +[decodable](https://docs.rs/google-ids1/5.0.3+20221113/google_ids1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-ids1/5.0.3+20221113/google_ids1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-ids1/5.0.3+20221113/google_ids1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -180,7 +180,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **ids1** library was generated by Sebastian Thiel, and is placed +The **ids1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/ids1/src/api.rs b/gen/ids1/src/api.rs index b501fcd120..b667813182 100644 --- a/gen/ids1/src/api.rs +++ b/gen/ids1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use ids1::{IDS, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/ids1/src/lib.rs b/gen/ids1/src/lib.rs index 94c64ac014..9a90cacb71 100644 --- a/gen/ids1/src/lib.rs +++ b/gen/ids1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/ids1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](IDS) ... +//! Handle the following *Resources* with ease from the central [hub](IDS) ... //! //! * projects //! * [*locations endpoints create*](api::ProjectLocationEndpointCreateCall), [*locations endpoints delete*](api::ProjectLocationEndpointDeleteCall), [*locations endpoints get*](api::ProjectLocationEndpointGetCall), [*locations endpoints get iam policy*](api::ProjectLocationEndpointGetIamPolicyCall), [*locations endpoints list*](api::ProjectLocationEndpointListCall), [*locations endpoints patch*](api::ProjectLocationEndpointPatchCall), [*locations endpoints set iam policy*](api::ProjectLocationEndpointSetIamPolicyCall), [*locations endpoints test iam permissions*](api::ProjectLocationEndpointTestIamPermissionCall), [*locations get*](api::ProjectLocationGetCall), [*locations list*](api::ProjectLocationListCall), [*locations operations cancel*](api::ProjectLocationOperationCancelCall), [*locations operations delete*](api::ProjectLocationOperationDeleteCall), [*locations operations get*](api::ProjectLocationOperationGetCall) and [*locations operations list*](api::ProjectLocationOperationListCall) @@ -53,8 +53,8 @@ //! let r = hub.projects().locations_operations_get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -83,12 +83,12 @@ //! use std::default::Default; //! use ids1::{IDS, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -131,10 +131,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -144,25 +144,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/indexing3/README.md b/gen/indexing3/README.md index 3a3b83c073..8ae5720445 100644 --- a/gen/indexing3/README.md +++ b/gen/indexing3/README.md @@ -11,7 +11,7 @@ Everything else about the *Indexing* *v3* API can be found at the [official documentation site](https://developers.google.com/search/apis/indexing-api/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-indexing3/5.0.3+20230117/google_indexing3/Indexing) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-indexing3/5.0.3+20230117/google_indexing3/Indexing) ... * [url notifications](https://docs.rs/google-indexing3/5.0.3+20230117/google_indexing3/api::UrlNotification) * [*get metadata*](https://docs.rs/google-indexing3/5.0.3+20230117/google_indexing3/api::UrlNotificationGetMetadataCall) and [*publish*](https://docs.rs/google-indexing3/5.0.3+20230117/google_indexing3/api::UrlNotificationPublishCall) @@ -51,8 +51,8 @@ let r = hub.url_notifications().get_metadata(...).doit().await let r = hub.url_notifications().publish(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -79,12 +79,12 @@ use indexing3::{Result, Error}; use std::default::Default; use indexing3::{Indexing, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -121,10 +121,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-indexing3/5.0.3+20230117/google_indexing3/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-indexing3/5.0.3+20230117/google_indexing3/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -134,25 +134,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-indexi You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-indexing3/5.0.3+20230117/google_indexing3/client::Delegate) to the -[Method Builder](https://docs.rs/google-indexing3/5.0.3+20230117/google_indexing3/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-indexing3/5.0.3+20230117/google_indexing3/client::Delegate) to the +[Method Builder](https://docs.rs/google-indexing3/5.0.3+20230117/google_indexing3/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-indexing3/5.0.3+20230117/google_indexing3/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-indexing3/5.0.3+20230117/google_indexing3/client::RequestValue) and -[decodable](https://docs.rs/google-indexing3/5.0.3+20230117/google_indexing3/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-indexing3/5.0.3+20230117/google_indexing3/client::RequestValue) and +[decodable](https://docs.rs/google-indexing3/5.0.3+20230117/google_indexing3/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-indexing3/5.0.3+20230117/google_indexing3/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-indexing3/5.0.3+20230117/google_indexing3/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -171,7 +171,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **indexing3** library was generated by Sebastian Thiel, and is placed +The **indexing3** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/indexing3/src/api.rs b/gen/indexing3/src/api.rs index a7e7aef1b1..2e7c9c6f05 100644 --- a/gen/indexing3/src/api.rs +++ b/gen/indexing3/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// Submit data to Google for indexing Full, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use indexing3::{Indexing, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/indexing3/src/lib.rs b/gen/indexing3/src/lib.rs index effc30dcd4..5f5b25b0fc 100644 --- a/gen/indexing3/src/lib.rs +++ b/gen/indexing3/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/indexing3). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Indexing) ... +//! Handle the following *Resources* with ease from the central [hub](Indexing) ... //! //! * [url notifications](api::UrlNotification) //! * [*get metadata*](api::UrlNotificationGetMetadataCall) and [*publish*](api::UrlNotificationPublishCall) @@ -51,8 +51,8 @@ //! let r = hub.url_notifications().publish(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -80,12 +80,12 @@ //! use std::default::Default; //! use indexing3::{Indexing, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -122,10 +122,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -135,25 +135,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/jobs3/README.md b/gen/jobs3/README.md index 84d7f01f42..d6a61e6145 100644 --- a/gen/jobs3/README.md +++ b/gen/jobs3/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Talent Solution* *v3* API can be found at the [official documentation site](https://cloud.google.com/talent-solution/job-search/docs/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-jobs3/5.0.3+20230120/google_jobs3/CloudTalentSolution) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-jobs3/5.0.3+20230120/google_jobs3/CloudTalentSolution) ... * projects * [*client events create*](https://docs.rs/google-jobs3/5.0.3+20230120/google_jobs3/api::ProjectClientEventCreateCall), [*companies create*](https://docs.rs/google-jobs3/5.0.3+20230120/google_jobs3/api::ProjectCompanyCreateCall), [*companies delete*](https://docs.rs/google-jobs3/5.0.3+20230120/google_jobs3/api::ProjectCompanyDeleteCall), [*companies get*](https://docs.rs/google-jobs3/5.0.3+20230120/google_jobs3/api::ProjectCompanyGetCall), [*companies list*](https://docs.rs/google-jobs3/5.0.3+20230120/google_jobs3/api::ProjectCompanyListCall), [*companies patch*](https://docs.rs/google-jobs3/5.0.3+20230120/google_jobs3/api::ProjectCompanyPatchCall), [*complete*](https://docs.rs/google-jobs3/5.0.3+20230120/google_jobs3/api::ProjectCompleteCall), [*jobs batch delete*](https://docs.rs/google-jobs3/5.0.3+20230120/google_jobs3/api::ProjectJobBatchDeleteCall), [*jobs create*](https://docs.rs/google-jobs3/5.0.3+20230120/google_jobs3/api::ProjectJobCreateCall), [*jobs delete*](https://docs.rs/google-jobs3/5.0.3+20230120/google_jobs3/api::ProjectJobDeleteCall), [*jobs get*](https://docs.rs/google-jobs3/5.0.3+20230120/google_jobs3/api::ProjectJobGetCall), [*jobs list*](https://docs.rs/google-jobs3/5.0.3+20230120/google_jobs3/api::ProjectJobListCall), [*jobs patch*](https://docs.rs/google-jobs3/5.0.3+20230120/google_jobs3/api::ProjectJobPatchCall), [*jobs search*](https://docs.rs/google-jobs3/5.0.3+20230120/google_jobs3/api::ProjectJobSearchCall) and [*jobs search for alert*](https://docs.rs/google-jobs3/5.0.3+20230120/google_jobs3/api::ProjectJobSearchForAlertCall) @@ -52,8 +52,8 @@ let r = hub.projects().jobs_get(...).doit().await let r = hub.projects().jobs_patch(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -81,12 +81,12 @@ use jobs3::{Result, Error}; use std::default::Default; use jobs3::{CloudTalentSolution, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -127,10 +127,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-jobs3/5.0.3+20230120/google_jobs3/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-jobs3/5.0.3+20230120/google_jobs3/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -140,25 +140,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-jobs3/ You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-jobs3/5.0.3+20230120/google_jobs3/client::Delegate) to the -[Method Builder](https://docs.rs/google-jobs3/5.0.3+20230120/google_jobs3/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-jobs3/5.0.3+20230120/google_jobs3/client::Delegate) to the +[Method Builder](https://docs.rs/google-jobs3/5.0.3+20230120/google_jobs3/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-jobs3/5.0.3+20230120/google_jobs3/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-jobs3/5.0.3+20230120/google_jobs3/client::RequestValue) and -[decodable](https://docs.rs/google-jobs3/5.0.3+20230120/google_jobs3/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-jobs3/5.0.3+20230120/google_jobs3/client::RequestValue) and +[decodable](https://docs.rs/google-jobs3/5.0.3+20230120/google_jobs3/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-jobs3/5.0.3+20230120/google_jobs3/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-jobs3/5.0.3+20230120/google_jobs3/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -177,7 +177,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **jobs3** library was generated by Sebastian Thiel, and is placed +The **jobs3** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/jobs3/src/api.rs b/gen/jobs3/src/api.rs index 2e1fc292a4..d12dd6d05e 100644 --- a/gen/jobs3/src/api.rs +++ b/gen/jobs3/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use jobs3::{CloudTalentSolution, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/jobs3/src/lib.rs b/gen/jobs3/src/lib.rs index 8fde53a269..75f2ba1e07 100644 --- a/gen/jobs3/src/lib.rs +++ b/gen/jobs3/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/jobs3). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudTalentSolution) ... +//! Handle the following *Resources* with ease from the central [hub](CloudTalentSolution) ... //! //! * projects //! * [*client events create*](api::ProjectClientEventCreateCall), [*companies create*](api::ProjectCompanyCreateCall), [*companies delete*](api::ProjectCompanyDeleteCall), [*companies get*](api::ProjectCompanyGetCall), [*companies list*](api::ProjectCompanyListCall), [*companies patch*](api::ProjectCompanyPatchCall), [*complete*](api::ProjectCompleteCall), [*jobs batch delete*](api::ProjectJobBatchDeleteCall), [*jobs create*](api::ProjectJobCreateCall), [*jobs delete*](api::ProjectJobDeleteCall), [*jobs get*](api::ProjectJobGetCall), [*jobs list*](api::ProjectJobListCall), [*jobs patch*](api::ProjectJobPatchCall), [*jobs search*](api::ProjectJobSearchCall) and [*jobs search for alert*](api::ProjectJobSearchForAlertCall) @@ -52,8 +52,8 @@ //! let r = hub.projects().jobs_patch(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -82,12 +82,12 @@ //! use std::default::Default; //! use jobs3::{CloudTalentSolution, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -128,10 +128,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -141,25 +141,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/jobs4/README.md b/gen/jobs4/README.md index 6748c9fad3..61558c418c 100644 --- a/gen/jobs4/README.md +++ b/gen/jobs4/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Talent Solution* *v4* API can be found at the [official documentation site](https://cloud.google.com/talent-solution/job-search/docs/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-jobs4/5.0.3+20230120/google_jobs4/CloudTalentSolution) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-jobs4/5.0.3+20230120/google_jobs4/CloudTalentSolution) ... * projects * [*operations get*](https://docs.rs/google-jobs4/5.0.3+20230120/google_jobs4/api::ProjectOperationGetCall), [*tenants client events create*](https://docs.rs/google-jobs4/5.0.3+20230120/google_jobs4/api::ProjectTenantClientEventCreateCall), [*tenants companies create*](https://docs.rs/google-jobs4/5.0.3+20230120/google_jobs4/api::ProjectTenantCompanyCreateCall), [*tenants companies delete*](https://docs.rs/google-jobs4/5.0.3+20230120/google_jobs4/api::ProjectTenantCompanyDeleteCall), [*tenants companies get*](https://docs.rs/google-jobs4/5.0.3+20230120/google_jobs4/api::ProjectTenantCompanyGetCall), [*tenants companies list*](https://docs.rs/google-jobs4/5.0.3+20230120/google_jobs4/api::ProjectTenantCompanyListCall), [*tenants companies patch*](https://docs.rs/google-jobs4/5.0.3+20230120/google_jobs4/api::ProjectTenantCompanyPatchCall), [*tenants complete query*](https://docs.rs/google-jobs4/5.0.3+20230120/google_jobs4/api::ProjectTenantCompleteQueryCall), [*tenants create*](https://docs.rs/google-jobs4/5.0.3+20230120/google_jobs4/api::ProjectTenantCreateCall), [*tenants delete*](https://docs.rs/google-jobs4/5.0.3+20230120/google_jobs4/api::ProjectTenantDeleteCall), [*tenants get*](https://docs.rs/google-jobs4/5.0.3+20230120/google_jobs4/api::ProjectTenantGetCall), [*tenants jobs batch create*](https://docs.rs/google-jobs4/5.0.3+20230120/google_jobs4/api::ProjectTenantJobBatchCreateCall), [*tenants jobs batch delete*](https://docs.rs/google-jobs4/5.0.3+20230120/google_jobs4/api::ProjectTenantJobBatchDeleteCall), [*tenants jobs batch update*](https://docs.rs/google-jobs4/5.0.3+20230120/google_jobs4/api::ProjectTenantJobBatchUpdateCall), [*tenants jobs create*](https://docs.rs/google-jobs4/5.0.3+20230120/google_jobs4/api::ProjectTenantJobCreateCall), [*tenants jobs delete*](https://docs.rs/google-jobs4/5.0.3+20230120/google_jobs4/api::ProjectTenantJobDeleteCall), [*tenants jobs get*](https://docs.rs/google-jobs4/5.0.3+20230120/google_jobs4/api::ProjectTenantJobGetCall), [*tenants jobs list*](https://docs.rs/google-jobs4/5.0.3+20230120/google_jobs4/api::ProjectTenantJobListCall), [*tenants jobs patch*](https://docs.rs/google-jobs4/5.0.3+20230120/google_jobs4/api::ProjectTenantJobPatchCall), [*tenants jobs search*](https://docs.rs/google-jobs4/5.0.3+20230120/google_jobs4/api::ProjectTenantJobSearchCall), [*tenants jobs search for alert*](https://docs.rs/google-jobs4/5.0.3+20230120/google_jobs4/api::ProjectTenantJobSearchForAlertCall), [*tenants list*](https://docs.rs/google-jobs4/5.0.3+20230120/google_jobs4/api::ProjectTenantListCall) and [*tenants patch*](https://docs.rs/google-jobs4/5.0.3+20230120/google_jobs4/api::ProjectTenantPatchCall) @@ -53,8 +53,8 @@ let r = hub.projects().tenants_jobs_batch_delete(...).doit().await let r = hub.projects().tenants_jobs_batch_update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -82,12 +82,12 @@ use jobs4::{Result, Error}; use std::default::Default; use jobs4::{CloudTalentSolution, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -128,10 +128,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-jobs4/5.0.3+20230120/google_jobs4/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-jobs4/5.0.3+20230120/google_jobs4/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -141,25 +141,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-jobs4/ You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-jobs4/5.0.3+20230120/google_jobs4/client::Delegate) to the -[Method Builder](https://docs.rs/google-jobs4/5.0.3+20230120/google_jobs4/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-jobs4/5.0.3+20230120/google_jobs4/client::Delegate) to the +[Method Builder](https://docs.rs/google-jobs4/5.0.3+20230120/google_jobs4/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-jobs4/5.0.3+20230120/google_jobs4/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-jobs4/5.0.3+20230120/google_jobs4/client::RequestValue) and -[decodable](https://docs.rs/google-jobs4/5.0.3+20230120/google_jobs4/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-jobs4/5.0.3+20230120/google_jobs4/client::RequestValue) and +[decodable](https://docs.rs/google-jobs4/5.0.3+20230120/google_jobs4/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-jobs4/5.0.3+20230120/google_jobs4/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-jobs4/5.0.3+20230120/google_jobs4/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -178,7 +178,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **jobs4** library was generated by Sebastian Thiel, and is placed +The **jobs4** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/jobs4/src/api.rs b/gen/jobs4/src/api.rs index 8a312fd2d5..524c3523d8 100644 --- a/gen/jobs4/src/api.rs +++ b/gen/jobs4/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use jobs4::{CloudTalentSolution, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/jobs4/src/lib.rs b/gen/jobs4/src/lib.rs index 7d2b9f21fb..e6d09e503d 100644 --- a/gen/jobs4/src/lib.rs +++ b/gen/jobs4/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/jobs4). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudTalentSolution) ... +//! Handle the following *Resources* with ease from the central [hub](CloudTalentSolution) ... //! //! * projects //! * [*operations get*](api::ProjectOperationGetCall), [*tenants client events create*](api::ProjectTenantClientEventCreateCall), [*tenants companies create*](api::ProjectTenantCompanyCreateCall), [*tenants companies delete*](api::ProjectTenantCompanyDeleteCall), [*tenants companies get*](api::ProjectTenantCompanyGetCall), [*tenants companies list*](api::ProjectTenantCompanyListCall), [*tenants companies patch*](api::ProjectTenantCompanyPatchCall), [*tenants complete query*](api::ProjectTenantCompleteQueryCall), [*tenants create*](api::ProjectTenantCreateCall), [*tenants delete*](api::ProjectTenantDeleteCall), [*tenants get*](api::ProjectTenantGetCall), [*tenants jobs batch create*](api::ProjectTenantJobBatchCreateCall), [*tenants jobs batch delete*](api::ProjectTenantJobBatchDeleteCall), [*tenants jobs batch update*](api::ProjectTenantJobBatchUpdateCall), [*tenants jobs create*](api::ProjectTenantJobCreateCall), [*tenants jobs delete*](api::ProjectTenantJobDeleteCall), [*tenants jobs get*](api::ProjectTenantJobGetCall), [*tenants jobs list*](api::ProjectTenantJobListCall), [*tenants jobs patch*](api::ProjectTenantJobPatchCall), [*tenants jobs search*](api::ProjectTenantJobSearchCall), [*tenants jobs search for alert*](api::ProjectTenantJobSearchForAlertCall), [*tenants list*](api::ProjectTenantListCall) and [*tenants patch*](api::ProjectTenantPatchCall) @@ -53,8 +53,8 @@ //! let r = hub.projects().tenants_jobs_batch_update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -83,12 +83,12 @@ //! use std::default::Default; //! use jobs4::{CloudTalentSolution, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -129,10 +129,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -142,25 +142,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/keep1/README.md b/gen/keep1/README.md index b4ab471008..62c3f82872 100644 --- a/gen/keep1/README.md +++ b/gen/keep1/README.md @@ -11,7 +11,7 @@ Everything else about the *Keep* *v1* API can be found at the [official documentation site](https://developers.google.com/keep/api). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-keep1/5.0.3+20230117/google_keep1/Keep) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-keep1/5.0.3+20230117/google_keep1/Keep) ... * media * [*download*](https://docs.rs/google-keep1/5.0.3+20230117/google_keep1/api::MediaDownloadCall) @@ -61,8 +61,8 @@ let r = hub.notes().get(...).doit().await let r = hub.notes().list(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -89,12 +89,12 @@ use keep1::{Result, Error}; use std::default::Default; use keep1::{Keep, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -133,10 +133,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-keep1/5.0.3+20230117/google_keep1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-keep1/5.0.3+20230117/google_keep1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -146,25 +146,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-keep1/ You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-keep1/5.0.3+20230117/google_keep1/client::Delegate) to the -[Method Builder](https://docs.rs/google-keep1/5.0.3+20230117/google_keep1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-keep1/5.0.3+20230117/google_keep1/client::Delegate) to the +[Method Builder](https://docs.rs/google-keep1/5.0.3+20230117/google_keep1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-keep1/5.0.3+20230117/google_keep1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-keep1/5.0.3+20230117/google_keep1/client::RequestValue) and -[decodable](https://docs.rs/google-keep1/5.0.3+20230117/google_keep1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-keep1/5.0.3+20230117/google_keep1/client::RequestValue) and +[decodable](https://docs.rs/google-keep1/5.0.3+20230117/google_keep1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-keep1/5.0.3+20230117/google_keep1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-keep1/5.0.3+20230117/google_keep1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -183,7 +183,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **keep1** library was generated by Sebastian Thiel, and is placed +The **keep1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/keep1/src/api.rs b/gen/keep1/src/api.rs index 15386d0214..858d6b2a4f 100644 --- a/gen/keep1/src/api.rs +++ b/gen/keep1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, create and permanently delete all your Google Keep data Full, @@ -68,12 +68,12 @@ impl Default for Scope { /// use std::default::Default; /// use keep1::{Keep, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/keep1/src/lib.rs b/gen/keep1/src/lib.rs index 0937ea343f..5d88dc994d 100644 --- a/gen/keep1/src/lib.rs +++ b/gen/keep1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/keep1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Keep) ... +//! Handle the following *Resources* with ease from the central [hub](Keep) ... //! //! * media //! * [*download*](api::MediaDownloadCall) @@ -61,8 +61,8 @@ //! let r = hub.notes().list(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -90,12 +90,12 @@ //! use std::default::Default; //! use keep1::{Keep, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -134,10 +134,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -147,25 +147,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/language1/README.md b/gen/language1/README.md index 0923a8bac8..916833d710 100644 --- a/gen/language1/README.md +++ b/gen/language1/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Natural Language* *v1* API can be found at the [official documentation site](https://cloud.google.com/natural-language/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-language1/5.0.3+20230121/google_language1/CloudNaturalLanguage) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-language1/5.0.3+20230121/google_language1/CloudNaturalLanguage) ... * [documents](https://docs.rs/google-language1/5.0.3+20230121/google_language1/api::Document) * [*analyze entities*](https://docs.rs/google-language1/5.0.3+20230121/google_language1/api::DocumentAnalyzeEntityCall), [*analyze entity sentiment*](https://docs.rs/google-language1/5.0.3+20230121/google_language1/api::DocumentAnalyzeEntitySentimentCall), [*analyze sentiment*](https://docs.rs/google-language1/5.0.3+20230121/google_language1/api::DocumentAnalyzeSentimentCall), [*analyze syntax*](https://docs.rs/google-language1/5.0.3+20230121/google_language1/api::DocumentAnalyzeSyntaxCall), [*annotate text*](https://docs.rs/google-language1/5.0.3+20230121/google_language1/api::DocumentAnnotateTextCall) and [*classify text*](https://docs.rs/google-language1/5.0.3+20230121/google_language1/api::DocumentClassifyTextCall) @@ -55,8 +55,8 @@ let r = hub.documents().annotate_text(...).doit().await let r = hub.documents().classify_text(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -84,12 +84,12 @@ use language1::{Result, Error}; use std::default::Default; use language1::{CloudNaturalLanguage, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -130,10 +130,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-language1/5.0.3+20230121/google_language1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-language1/5.0.3+20230121/google_language1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -143,25 +143,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-langua You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-language1/5.0.3+20230121/google_language1/client::Delegate) to the -[Method Builder](https://docs.rs/google-language1/5.0.3+20230121/google_language1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-language1/5.0.3+20230121/google_language1/client::Delegate) to the +[Method Builder](https://docs.rs/google-language1/5.0.3+20230121/google_language1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-language1/5.0.3+20230121/google_language1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-language1/5.0.3+20230121/google_language1/client::RequestValue) and -[decodable](https://docs.rs/google-language1/5.0.3+20230121/google_language1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-language1/5.0.3+20230121/google_language1/client::RequestValue) and +[decodable](https://docs.rs/google-language1/5.0.3+20230121/google_language1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-language1/5.0.3+20230121/google_language1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-language1/5.0.3+20230121/google_language1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -180,7 +180,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **language1** library was generated by Sebastian Thiel, and is placed +The **language1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/language1/src/api.rs b/gen/language1/src/api.rs index 7617e6c651..a51c304376 100644 --- a/gen/language1/src/api.rs +++ b/gen/language1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// Apply machine learning models to reveal the structure and meaning of text CloudLanguage, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use language1::{CloudNaturalLanguage, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/language1/src/lib.rs b/gen/language1/src/lib.rs index 2cdf9ea3c2..6560c78118 100644 --- a/gen/language1/src/lib.rs +++ b/gen/language1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/language1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudNaturalLanguage) ... +//! Handle the following *Resources* with ease from the central [hub](CloudNaturalLanguage) ... //! //! * [documents](api::Document) //! * [*analyze entities*](api::DocumentAnalyzeEntityCall), [*analyze entity sentiment*](api::DocumentAnalyzeEntitySentimentCall), [*analyze sentiment*](api::DocumentAnalyzeSentimentCall), [*analyze syntax*](api::DocumentAnalyzeSyntaxCall), [*annotate text*](api::DocumentAnnotateTextCall) and [*classify text*](api::DocumentClassifyTextCall) @@ -55,8 +55,8 @@ //! let r = hub.documents().classify_text(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -85,12 +85,12 @@ //! use std::default::Default; //! use language1::{CloudNaturalLanguage, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -131,10 +131,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -144,25 +144,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/language1_beta1/README.md b/gen/language1_beta1/README.md index cc8345cee7..c91fad7107 100644 --- a/gen/language1_beta1/README.md +++ b/gen/language1_beta1/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Natural Language* *v1_beta1* API can be found a [official documentation site](https://cloud.google.com/natural-language/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-language1_beta1/5.0.3+20220218/google_language1_beta1/CloudNaturalLanguage) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-language1_beta1/5.0.3+20220218/google_language1_beta1/CloudNaturalLanguage) ... * [documents](https://docs.rs/google-language1_beta1/5.0.3+20220218/google_language1_beta1/api::Document) * [*analyze entities*](https://docs.rs/google-language1_beta1/5.0.3+20220218/google_language1_beta1/api::DocumentAnalyzeEntityCall), [*analyze sentiment*](https://docs.rs/google-language1_beta1/5.0.3+20220218/google_language1_beta1/api::DocumentAnalyzeSentimentCall), [*analyze syntax*](https://docs.rs/google-language1_beta1/5.0.3+20220218/google_language1_beta1/api::DocumentAnalyzeSyntaxCall) and [*annotate text*](https://docs.rs/google-language1_beta1/5.0.3+20220218/google_language1_beta1/api::DocumentAnnotateTextCall) @@ -53,8 +53,8 @@ let r = hub.documents().analyze_syntax(...).doit().await let r = hub.documents().annotate_text(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -82,12 +82,12 @@ use language1_beta1::{Result, Error}; use std::default::Default; use language1_beta1::{CloudNaturalLanguage, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -128,10 +128,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-language1_beta1/5.0.3+20220218/google_language1_beta1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-language1_beta1/5.0.3+20220218/google_language1_beta1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -141,25 +141,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-langua You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-language1_beta1/5.0.3+20220218/google_language1_beta1/client::Delegate) to the -[Method Builder](https://docs.rs/google-language1_beta1/5.0.3+20220218/google_language1_beta1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-language1_beta1/5.0.3+20220218/google_language1_beta1/client::Delegate) to the +[Method Builder](https://docs.rs/google-language1_beta1/5.0.3+20220218/google_language1_beta1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-language1_beta1/5.0.3+20220218/google_language1_beta1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-language1_beta1/5.0.3+20220218/google_language1_beta1/client::RequestValue) and -[decodable](https://docs.rs/google-language1_beta1/5.0.3+20220218/google_language1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-language1_beta1/5.0.3+20220218/google_language1_beta1/client::RequestValue) and +[decodable](https://docs.rs/google-language1_beta1/5.0.3+20220218/google_language1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-language1_beta1/5.0.3+20220218/google_language1_beta1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-language1_beta1/5.0.3+20220218/google_language1_beta1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -178,7 +178,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **language1_beta1** library was generated by Sebastian Thiel, and is placed +The **language1_beta1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/language1_beta1/src/api.rs b/gen/language1_beta1/src/api.rs index 12f454ac4b..aa36415ac9 100644 --- a/gen/language1_beta1/src/api.rs +++ b/gen/language1_beta1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// Apply machine learning models to reveal the structure and meaning of text CloudLanguage, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use language1_beta1::{CloudNaturalLanguage, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/language1_beta1/src/lib.rs b/gen/language1_beta1/src/lib.rs index e32ad44794..a40c3e7985 100644 --- a/gen/language1_beta1/src/lib.rs +++ b/gen/language1_beta1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/language1_beta1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudNaturalLanguage) ... +//! Handle the following *Resources* with ease from the central [hub](CloudNaturalLanguage) ... //! //! * [documents](api::Document) //! * [*analyze entities*](api::DocumentAnalyzeEntityCall), [*analyze sentiment*](api::DocumentAnalyzeSentimentCall), [*analyze syntax*](api::DocumentAnalyzeSyntaxCall) and [*annotate text*](api::DocumentAnnotateTextCall) @@ -53,8 +53,8 @@ //! let r = hub.documents().annotate_text(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -83,12 +83,12 @@ //! use std::default::Default; //! use language1_beta1::{CloudNaturalLanguage, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -129,10 +129,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -142,25 +142,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/libraryagent1/README.md b/gen/libraryagent1/README.md index a12fb86f00..d2128452e3 100644 --- a/gen/libraryagent1/README.md +++ b/gen/libraryagent1/README.md @@ -11,7 +11,7 @@ Everything else about the *Libraryagent* *v1* API can be found at the [official documentation site](https://cloud.google.com/docs/quota). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-libraryagent1/5.0.3+20230123/google_libraryagent1/Libraryagent) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-libraryagent1/5.0.3+20230123/google_libraryagent1/Libraryagent) ... * shelves * [*books borrow*](https://docs.rs/google-libraryagent1/5.0.3+20230123/google_libraryagent1/api::ShelfBookBorrowCall), [*books get*](https://docs.rs/google-libraryagent1/5.0.3+20230123/google_libraryagent1/api::ShelfBookGetCall), [*books list*](https://docs.rs/google-libraryagent1/5.0.3+20230123/google_libraryagent1/api::ShelfBookListCall), [*books return*](https://docs.rs/google-libraryagent1/5.0.3+20230123/google_libraryagent1/api::ShelfBookReturnCall), [*get*](https://docs.rs/google-libraryagent1/5.0.3+20230123/google_libraryagent1/api::ShelfGetCall) and [*list*](https://docs.rs/google-libraryagent1/5.0.3+20230123/google_libraryagent1/api::ShelfListCall) @@ -52,8 +52,8 @@ let r = hub.shelves().books_get(...).doit().await let r = hub.shelves().books_return(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -80,12 +80,12 @@ use libraryagent1::{Result, Error}; use std::default::Default; use libraryagent1::{Libraryagent, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -121,10 +121,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-libraryagent1/5.0.3+20230123/google_libraryagent1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-libraryagent1/5.0.3+20230123/google_libraryagent1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -134,25 +134,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-librar You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-libraryagent1/5.0.3+20230123/google_libraryagent1/client::Delegate) to the -[Method Builder](https://docs.rs/google-libraryagent1/5.0.3+20230123/google_libraryagent1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-libraryagent1/5.0.3+20230123/google_libraryagent1/client::Delegate) to the +[Method Builder](https://docs.rs/google-libraryagent1/5.0.3+20230123/google_libraryagent1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-libraryagent1/5.0.3+20230123/google_libraryagent1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-libraryagent1/5.0.3+20230123/google_libraryagent1/client::RequestValue) and -[decodable](https://docs.rs/google-libraryagent1/5.0.3+20230123/google_libraryagent1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-libraryagent1/5.0.3+20230123/google_libraryagent1/client::RequestValue) and +[decodable](https://docs.rs/google-libraryagent1/5.0.3+20230123/google_libraryagent1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-libraryagent1/5.0.3+20230123/google_libraryagent1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-libraryagent1/5.0.3+20230123/google_libraryagent1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -171,7 +171,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **libraryagent1** library was generated by Sebastian Thiel, and is placed +The **libraryagent1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/libraryagent1/src/api.rs b/gen/libraryagent1/src/api.rs index 34a6039fa7..0ff797088c 100644 --- a/gen/libraryagent1/src/api.rs +++ b/gen/libraryagent1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use libraryagent1::{Libraryagent, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/libraryagent1/src/lib.rs b/gen/libraryagent1/src/lib.rs index 543145dabb..58fe168092 100644 --- a/gen/libraryagent1/src/lib.rs +++ b/gen/libraryagent1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/libraryagent1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Libraryagent) ... +//! Handle the following *Resources* with ease from the central [hub](Libraryagent) ... //! //! * shelves //! * [*books borrow*](api::ShelfBookBorrowCall), [*books get*](api::ShelfBookGetCall), [*books list*](api::ShelfBookListCall), [*books return*](api::ShelfBookReturnCall), [*get*](api::ShelfGetCall) and [*list*](api::ShelfListCall) @@ -52,8 +52,8 @@ //! let r = hub.shelves().books_return(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -81,12 +81,12 @@ //! use std::default::Default; //! use libraryagent1::{Libraryagent, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -122,10 +122,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -135,25 +135,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/licensing1/README.md b/gen/licensing1/README.md index 08d408df56..087011293a 100644 --- a/gen/licensing1/README.md +++ b/gen/licensing1/README.md @@ -11,7 +11,7 @@ Everything else about the *licensing* *v1* API can be found at the [official documentation site](https://developers.google.com/admin-sdk/licensing/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-licensing1/5.0.3+20230121/google_licensing1/Licensing) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-licensing1/5.0.3+20230121/google_licensing1/Licensing) ... * [license assignments](https://docs.rs/google-licensing1/5.0.3+20230121/google_licensing1/api::LicenseAssignment) * [*delete*](https://docs.rs/google-licensing1/5.0.3+20230121/google_licensing1/api::LicenseAssignmentDeleteCall), [*get*](https://docs.rs/google-licensing1/5.0.3+20230121/google_licensing1/api::LicenseAssignmentGetCall), [*insert*](https://docs.rs/google-licensing1/5.0.3+20230121/google_licensing1/api::LicenseAssignmentInsertCall), [*list for product*](https://docs.rs/google-licensing1/5.0.3+20230121/google_licensing1/api::LicenseAssignmentListForProductCall), [*list for product and sku*](https://docs.rs/google-licensing1/5.0.3+20230121/google_licensing1/api::LicenseAssignmentListForProductAndSkuCall), [*patch*](https://docs.rs/google-licensing1/5.0.3+20230121/google_licensing1/api::LicenseAssignmentPatchCall) and [*update*](https://docs.rs/google-licensing1/5.0.3+20230121/google_licensing1/api::LicenseAssignmentUpdateCall) @@ -56,8 +56,8 @@ let r = hub.license_assignments().patch(...).doit().await let r = hub.license_assignments().update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -84,12 +84,12 @@ use licensing1::{Result, Error}; use std::default::Default; use licensing1::{Licensing, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -127,10 +127,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-licensing1/5.0.3+20230121/google_licensing1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-licensing1/5.0.3+20230121/google_licensing1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -140,25 +140,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-licens You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-licensing1/5.0.3+20230121/google_licensing1/client::Delegate) to the -[Method Builder](https://docs.rs/google-licensing1/5.0.3+20230121/google_licensing1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-licensing1/5.0.3+20230121/google_licensing1/client::Delegate) to the +[Method Builder](https://docs.rs/google-licensing1/5.0.3+20230121/google_licensing1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-licensing1/5.0.3+20230121/google_licensing1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-licensing1/5.0.3+20230121/google_licensing1/client::RequestValue) and -[decodable](https://docs.rs/google-licensing1/5.0.3+20230121/google_licensing1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-licensing1/5.0.3+20230121/google_licensing1/client::RequestValue) and +[decodable](https://docs.rs/google-licensing1/5.0.3+20230121/google_licensing1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-licensing1/5.0.3+20230121/google_licensing1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-licensing1/5.0.3+20230121/google_licensing1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -177,7 +177,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **licensing1** library was generated by Sebastian Thiel, and is placed +The **licensing1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/licensing1/src/api.rs b/gen/licensing1/src/api.rs index da3b934e6a..e95e1ee855 100644 --- a/gen/licensing1/src/api.rs +++ b/gen/licensing1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage G Suite licenses for your domain AppLicensing, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use licensing1::{Licensing, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/licensing1/src/lib.rs b/gen/licensing1/src/lib.rs index b6fff8234f..912fce03f2 100644 --- a/gen/licensing1/src/lib.rs +++ b/gen/licensing1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/licensing1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Licensing) ... +//! Handle the following *Resources* with ease from the central [hub](Licensing) ... //! //! * [license assignments](api::LicenseAssignment) //! * [*delete*](api::LicenseAssignmentDeleteCall), [*get*](api::LicenseAssignmentGetCall), [*insert*](api::LicenseAssignmentInsertCall), [*list for product*](api::LicenseAssignmentListForProductCall), [*list for product and sku*](api::LicenseAssignmentListForProductAndSkuCall), [*patch*](api::LicenseAssignmentPatchCall) and [*update*](api::LicenseAssignmentUpdateCall) @@ -56,8 +56,8 @@ //! let r = hub.license_assignments().update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -85,12 +85,12 @@ //! use std::default::Default; //! use licensing1::{Licensing, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -128,10 +128,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -141,25 +141,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/lifesciences2_beta/README.md b/gen/lifesciences2_beta/README.md index 8e1d5fa2f3..5e2b966402 100644 --- a/gen/lifesciences2_beta/README.md +++ b/gen/lifesciences2_beta/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Life Sciences* *v2_beta* API can be found at th [official documentation site](https://cloud.google.com/life-sciences). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-lifesciences2_beta/5.0.3+20230106/google_lifesciences2_beta/CloudLifeSciences) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-lifesciences2_beta/5.0.3+20230106/google_lifesciences2_beta/CloudLifeSciences) ... * projects * [*locations get*](https://docs.rs/google-lifesciences2_beta/5.0.3+20230106/google_lifesciences2_beta/api::ProjectLocationGetCall), [*locations list*](https://docs.rs/google-lifesciences2_beta/5.0.3+20230106/google_lifesciences2_beta/api::ProjectLocationListCall), [*locations operations cancel*](https://docs.rs/google-lifesciences2_beta/5.0.3+20230106/google_lifesciences2_beta/api::ProjectLocationOperationCancelCall), [*locations operations get*](https://docs.rs/google-lifesciences2_beta/5.0.3+20230106/google_lifesciences2_beta/api::ProjectLocationOperationGetCall), [*locations operations list*](https://docs.rs/google-lifesciences2_beta/5.0.3+20230106/google_lifesciences2_beta/api::ProjectLocationOperationListCall) and [*locations pipelines run*](https://docs.rs/google-lifesciences2_beta/5.0.3+20230106/google_lifesciences2_beta/api::ProjectLocationPipelineRunCall) @@ -51,8 +51,8 @@ let r = hub.projects().locations_operations_get(...).doit().await let r = hub.projects().locations_pipelines_run(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -80,12 +80,12 @@ use lifesciences2_beta::{Result, Error}; use std::default::Default; use lifesciences2_beta::{CloudLifeSciences, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -126,10 +126,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-lifesciences2_beta/5.0.3+20230106/google_lifesciences2_beta/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-lifesciences2_beta/5.0.3+20230106/google_lifesciences2_beta/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -139,25 +139,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-lifesc You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-lifesciences2_beta/5.0.3+20230106/google_lifesciences2_beta/client::Delegate) to the -[Method Builder](https://docs.rs/google-lifesciences2_beta/5.0.3+20230106/google_lifesciences2_beta/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-lifesciences2_beta/5.0.3+20230106/google_lifesciences2_beta/client::Delegate) to the +[Method Builder](https://docs.rs/google-lifesciences2_beta/5.0.3+20230106/google_lifesciences2_beta/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-lifesciences2_beta/5.0.3+20230106/google_lifesciences2_beta/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-lifesciences2_beta/5.0.3+20230106/google_lifesciences2_beta/client::RequestValue) and -[decodable](https://docs.rs/google-lifesciences2_beta/5.0.3+20230106/google_lifesciences2_beta/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-lifesciences2_beta/5.0.3+20230106/google_lifesciences2_beta/client::RequestValue) and +[decodable](https://docs.rs/google-lifesciences2_beta/5.0.3+20230106/google_lifesciences2_beta/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-lifesciences2_beta/5.0.3+20230106/google_lifesciences2_beta/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-lifesciences2_beta/5.0.3+20230106/google_lifesciences2_beta/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -176,7 +176,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **lifesciences2_beta** library was generated by Sebastian Thiel, and is placed +The **lifesciences2_beta** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/lifesciences2_beta/src/api.rs b/gen/lifesciences2_beta/src/api.rs index e4f4545420..6e418ac76f 100644 --- a/gen/lifesciences2_beta/src/api.rs +++ b/gen/lifesciences2_beta/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use lifesciences2_beta::{CloudLifeSciences, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/lifesciences2_beta/src/lib.rs b/gen/lifesciences2_beta/src/lib.rs index 207122874b..34e3773eb0 100644 --- a/gen/lifesciences2_beta/src/lib.rs +++ b/gen/lifesciences2_beta/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/lifesciences2_beta). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudLifeSciences) ... +//! Handle the following *Resources* with ease from the central [hub](CloudLifeSciences) ... //! //! * projects //! * [*locations get*](api::ProjectLocationGetCall), [*locations list*](api::ProjectLocationListCall), [*locations operations cancel*](api::ProjectLocationOperationCancelCall), [*locations operations get*](api::ProjectLocationOperationGetCall), [*locations operations list*](api::ProjectLocationOperationListCall) and [*locations pipelines run*](api::ProjectLocationPipelineRunCall) @@ -51,8 +51,8 @@ //! let r = hub.projects().locations_pipelines_run(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -81,12 +81,12 @@ //! use std::default::Default; //! use lifesciences2_beta::{CloudLifeSciences, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -127,10 +127,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -140,25 +140,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/localservices1/README.md b/gen/localservices1/README.md index cd8c1bde66..4ef214ed03 100644 --- a/gen/localservices1/README.md +++ b/gen/localservices1/README.md @@ -11,7 +11,7 @@ Everything else about the *Localservices* *v1* API can be found at the [official documentation site](https://ads.google.com/local-services-ads/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-localservices1/5.0.3+20230123/google_localservices1/Localservices) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-localservices1/5.0.3+20230123/google_localservices1/Localservices) ... * account reports * [*search*](https://docs.rs/google-localservices1/5.0.3+20230123/google_localservices1/api::AccountReportSearchCall) @@ -52,8 +52,8 @@ Or specifically ... let r = hub.account_reports().search(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -80,12 +80,12 @@ use localservices1::{Result, Error}; use std::default::Default; use localservices1::{Localservices, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -130,10 +130,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-localservices1/5.0.3+20230123/google_localservices1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-localservices1/5.0.3+20230123/google_localservices1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -143,25 +143,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-locals You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-localservices1/5.0.3+20230123/google_localservices1/client::Delegate) to the -[Method Builder](https://docs.rs/google-localservices1/5.0.3+20230123/google_localservices1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-localservices1/5.0.3+20230123/google_localservices1/client::Delegate) to the +[Method Builder](https://docs.rs/google-localservices1/5.0.3+20230123/google_localservices1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-localservices1/5.0.3+20230123/google_localservices1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-localservices1/5.0.3+20230123/google_localservices1/client::RequestValue) and -[decodable](https://docs.rs/google-localservices1/5.0.3+20230123/google_localservices1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-localservices1/5.0.3+20230123/google_localservices1/client::RequestValue) and +[decodable](https://docs.rs/google-localservices1/5.0.3+20230123/google_localservices1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-localservices1/5.0.3+20230123/google_localservices1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-localservices1/5.0.3+20230123/google_localservices1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -180,7 +180,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **localservices1** library was generated by Sebastian Thiel, and is placed +The **localservices1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/localservices1/src/api.rs b/gen/localservices1/src/api.rs index 7e6da9e95a..1f0df38092 100644 --- a/gen/localservices1/src/api.rs +++ b/gen/localservices1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, create, and delete your Google Ads accounts and data. Adword, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use localservices1::{Localservices, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/localservices1/src/lib.rs b/gen/localservices1/src/lib.rs index 49264963f0..31fff48e08 100644 --- a/gen/localservices1/src/lib.rs +++ b/gen/localservices1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/localservices1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Localservices) ... +//! Handle the following *Resources* with ease from the central [hub](Localservices) ... //! //! * account reports //! * [*search*](api::AccountReportSearchCall) @@ -52,8 +52,8 @@ //! let r = hub.account_reports().search(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -81,12 +81,12 @@ //! use std::default::Default; //! use localservices1::{Localservices, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -131,10 +131,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -144,25 +144,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/logging2/README.md b/gen/logging2/README.md index 5e8f6e702d..a7edca2827 100644 --- a/gen/logging2/README.md +++ b/gen/logging2/README.md @@ -11,7 +11,7 @@ Everything else about the *Logging* *v2* API can be found at the [official documentation site](https://cloud.google.com/logging/docs/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-logging2/5.0.3+20230104/google_logging2/Logging) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-logging2/5.0.3+20230104/google_logging2/Logging) ... * billing accounts * [*exclusions create*](https://docs.rs/google-logging2/5.0.3+20230104/google_logging2/api::BillingAccountExclusionCreateCall), [*exclusions delete*](https://docs.rs/google-logging2/5.0.3+20230104/google_logging2/api::BillingAccountExclusionDeleteCall), [*exclusions get*](https://docs.rs/google-logging2/5.0.3+20230104/google_logging2/api::BillingAccountExclusionGetCall), [*exclusions list*](https://docs.rs/google-logging2/5.0.3+20230104/google_logging2/api::BillingAccountExclusionListCall), [*exclusions patch*](https://docs.rs/google-logging2/5.0.3+20230104/google_logging2/api::BillingAccountExclusionPatchCall), [*get cmek settings*](https://docs.rs/google-logging2/5.0.3+20230104/google_logging2/api::BillingAccountGetCmekSettingCall), [*get settings*](https://docs.rs/google-logging2/5.0.3+20230104/google_logging2/api::BillingAccountGetSettingCall), [*locations buckets create*](https://docs.rs/google-logging2/5.0.3+20230104/google_logging2/api::BillingAccountLocationBucketCreateCall), [*locations buckets delete*](https://docs.rs/google-logging2/5.0.3+20230104/google_logging2/api::BillingAccountLocationBucketDeleteCall), [*locations buckets get*](https://docs.rs/google-logging2/5.0.3+20230104/google_logging2/api::BillingAccountLocationBucketGetCall), [*locations buckets list*](https://docs.rs/google-logging2/5.0.3+20230104/google_logging2/api::BillingAccountLocationBucketListCall), [*locations buckets patch*](https://docs.rs/google-logging2/5.0.3+20230104/google_logging2/api::BillingAccountLocationBucketPatchCall), [*locations buckets undelete*](https://docs.rs/google-logging2/5.0.3+20230104/google_logging2/api::BillingAccountLocationBucketUndeleteCall), [*locations buckets views create*](https://docs.rs/google-logging2/5.0.3+20230104/google_logging2/api::BillingAccountLocationBucketViewCreateCall), [*locations buckets views delete*](https://docs.rs/google-logging2/5.0.3+20230104/google_logging2/api::BillingAccountLocationBucketViewDeleteCall), [*locations buckets views get*](https://docs.rs/google-logging2/5.0.3+20230104/google_logging2/api::BillingAccountLocationBucketViewGetCall), [*locations buckets views list*](https://docs.rs/google-logging2/5.0.3+20230104/google_logging2/api::BillingAccountLocationBucketViewListCall), [*locations buckets views logs list*](https://docs.rs/google-logging2/5.0.3+20230104/google_logging2/api::BillingAccountLocationBucketViewLogListCall), [*locations buckets views patch*](https://docs.rs/google-logging2/5.0.3+20230104/google_logging2/api::BillingAccountLocationBucketViewPatchCall), [*locations get*](https://docs.rs/google-logging2/5.0.3+20230104/google_logging2/api::BillingAccountLocationGetCall), [*locations list*](https://docs.rs/google-logging2/5.0.3+20230104/google_logging2/api::BillingAccountLocationListCall), [*locations operations cancel*](https://docs.rs/google-logging2/5.0.3+20230104/google_logging2/api::BillingAccountLocationOperationCancelCall), [*locations operations get*](https://docs.rs/google-logging2/5.0.3+20230104/google_logging2/api::BillingAccountLocationOperationGetCall), [*locations operations list*](https://docs.rs/google-logging2/5.0.3+20230104/google_logging2/api::BillingAccountLocationOperationListCall), [*logs delete*](https://docs.rs/google-logging2/5.0.3+20230104/google_logging2/api::BillingAccountLogDeleteCall), [*logs list*](https://docs.rs/google-logging2/5.0.3+20230104/google_logging2/api::BillingAccountLogListCall), [*sinks create*](https://docs.rs/google-logging2/5.0.3+20230104/google_logging2/api::BillingAccountSinkCreateCall), [*sinks delete*](https://docs.rs/google-logging2/5.0.3+20230104/google_logging2/api::BillingAccountSinkDeleteCall), [*sinks get*](https://docs.rs/google-logging2/5.0.3+20230104/google_logging2/api::BillingAccountSinkGetCall), [*sinks list*](https://docs.rs/google-logging2/5.0.3+20230104/google_logging2/api::BillingAccountSinkListCall), [*sinks patch*](https://docs.rs/google-logging2/5.0.3+20230104/google_logging2/api::BillingAccountSinkPatchCall) and [*sinks update*](https://docs.rs/google-logging2/5.0.3+20230104/google_logging2/api::BillingAccountSinkUpdateCall) @@ -109,8 +109,8 @@ let r = hub.projects().sinks_delete(...).doit().await let r = hub.sinks().delete(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -138,12 +138,12 @@ use logging2::{Result, Error}; use std::default::Default; use logging2::{Logging, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -184,10 +184,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-logging2/5.0.3+20230104/google_logging2/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-logging2/5.0.3+20230104/google_logging2/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -197,25 +197,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-loggin You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-logging2/5.0.3+20230104/google_logging2/client::Delegate) to the -[Method Builder](https://docs.rs/google-logging2/5.0.3+20230104/google_logging2/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-logging2/5.0.3+20230104/google_logging2/client::Delegate) to the +[Method Builder](https://docs.rs/google-logging2/5.0.3+20230104/google_logging2/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-logging2/5.0.3+20230104/google_logging2/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-logging2/5.0.3+20230104/google_logging2/client::RequestValue) and -[decodable](https://docs.rs/google-logging2/5.0.3+20230104/google_logging2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-logging2/5.0.3+20230104/google_logging2/client::RequestValue) and +[decodable](https://docs.rs/google-logging2/5.0.3+20230104/google_logging2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-logging2/5.0.3+20230104/google_logging2/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-logging2/5.0.3+20230104/google_logging2/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -234,7 +234,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **logging2** library was generated by Sebastian Thiel, and is placed +The **logging2** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/logging2/src/api.rs b/gen/logging2/src/api.rs index 22252ccb0c..74ae2c2135 100644 --- a/gen/logging2/src/api.rs +++ b/gen/logging2/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -81,12 +81,12 @@ impl Default for Scope { /// use std::default::Default; /// use logging2::{Logging, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/logging2/src/lib.rs b/gen/logging2/src/lib.rs index 74cfdebdcd..8b4db82703 100644 --- a/gen/logging2/src/lib.rs +++ b/gen/logging2/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/logging2). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Logging) ... +//! Handle the following *Resources* with ease from the central [hub](Logging) ... //! //! * billing accounts //! * [*exclusions create*](api::BillingAccountExclusionCreateCall), [*exclusions delete*](api::BillingAccountExclusionDeleteCall), [*exclusions get*](api::BillingAccountExclusionGetCall), [*exclusions list*](api::BillingAccountExclusionListCall), [*exclusions patch*](api::BillingAccountExclusionPatchCall), [*get cmek settings*](api::BillingAccountGetCmekSettingCall), [*get settings*](api::BillingAccountGetSettingCall), [*locations buckets create*](api::BillingAccountLocationBucketCreateCall), [*locations buckets delete*](api::BillingAccountLocationBucketDeleteCall), [*locations buckets get*](api::BillingAccountLocationBucketGetCall), [*locations buckets list*](api::BillingAccountLocationBucketListCall), [*locations buckets patch*](api::BillingAccountLocationBucketPatchCall), [*locations buckets undelete*](api::BillingAccountLocationBucketUndeleteCall), [*locations buckets views create*](api::BillingAccountLocationBucketViewCreateCall), [*locations buckets views delete*](api::BillingAccountLocationBucketViewDeleteCall), [*locations buckets views get*](api::BillingAccountLocationBucketViewGetCall), [*locations buckets views list*](api::BillingAccountLocationBucketViewListCall), [*locations buckets views logs list*](api::BillingAccountLocationBucketViewLogListCall), [*locations buckets views patch*](api::BillingAccountLocationBucketViewPatchCall), [*locations get*](api::BillingAccountLocationGetCall), [*locations list*](api::BillingAccountLocationListCall), [*locations operations cancel*](api::BillingAccountLocationOperationCancelCall), [*locations operations get*](api::BillingAccountLocationOperationGetCall), [*locations operations list*](api::BillingAccountLocationOperationListCall), [*logs delete*](api::BillingAccountLogDeleteCall), [*logs list*](api::BillingAccountLogListCall), [*sinks create*](api::BillingAccountSinkCreateCall), [*sinks delete*](api::BillingAccountSinkDeleteCall), [*sinks get*](api::BillingAccountSinkGetCall), [*sinks list*](api::BillingAccountSinkListCall), [*sinks patch*](api::BillingAccountSinkPatchCall) and [*sinks update*](api::BillingAccountSinkUpdateCall) @@ -109,8 +109,8 @@ //! let r = hub.sinks().delete(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -139,12 +139,12 @@ //! use std::default::Default; //! use logging2::{Logging, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -185,10 +185,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -198,25 +198,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/logging2_beta1/README.md b/gen/logging2_beta1/README.md index 7cf323bd87..d0d3ee861c 100644 --- a/gen/logging2_beta1/README.md +++ b/gen/logging2_beta1/README.md @@ -11,7 +11,7 @@ Everything else about the *Logging* *v2_beta1* API can be found at the [official documentation site](https://cloud.google.com/logging/docs/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-logging2_beta1/5.0.3+20190325/google_logging2_beta1/Logging) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-logging2_beta1/5.0.3+20190325/google_logging2_beta1/Logging) ... * entries * [*list*](https://docs.rs/google-logging2_beta1/5.0.3+20190325/google_logging2_beta1/api::EntryListCall) and [*write*](https://docs.rs/google-logging2_beta1/5.0.3+20190325/google_logging2_beta1/api::EntryWriteCall) @@ -56,8 +56,8 @@ let r = hub.projects().metrics_get(...).doit().await let r = hub.projects().metrics_update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -85,12 +85,12 @@ use logging2_beta1::{Result, Error}; use std::default::Default; use logging2_beta1::{Logging, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -131,10 +131,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-logging2_beta1/5.0.3+20190325/google_logging2_beta1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-logging2_beta1/5.0.3+20190325/google_logging2_beta1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -144,25 +144,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-loggin You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-logging2_beta1/5.0.3+20190325/google_logging2_beta1/client::Delegate) to the -[Method Builder](https://docs.rs/google-logging2_beta1/5.0.3+20190325/google_logging2_beta1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-logging2_beta1/5.0.3+20190325/google_logging2_beta1/client::Delegate) to the +[Method Builder](https://docs.rs/google-logging2_beta1/5.0.3+20190325/google_logging2_beta1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-logging2_beta1/5.0.3+20190325/google_logging2_beta1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-logging2_beta1/5.0.3+20190325/google_logging2_beta1/client::RequestValue) and -[decodable](https://docs.rs/google-logging2_beta1/5.0.3+20190325/google_logging2_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-logging2_beta1/5.0.3+20190325/google_logging2_beta1/client::RequestValue) and +[decodable](https://docs.rs/google-logging2_beta1/5.0.3+20190325/google_logging2_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-logging2_beta1/5.0.3+20190325/google_logging2_beta1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-logging2_beta1/5.0.3+20190325/google_logging2_beta1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -181,7 +181,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **logging2_beta1** library was generated by Sebastian Thiel, and is placed +The **logging2_beta1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/logging2_beta1/src/api.rs b/gen/logging2_beta1/src/api.rs index e7b129e154..e315aa0180 100644 --- a/gen/logging2_beta1/src/api.rs +++ b/gen/logging2_beta1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your data across Google Cloud Platform services CloudPlatform, @@ -81,12 +81,12 @@ impl Default for Scope { /// use std::default::Default; /// use logging2_beta1::{Logging, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/logging2_beta1/src/lib.rs b/gen/logging2_beta1/src/lib.rs index c8aae178a2..bc7e471da9 100644 --- a/gen/logging2_beta1/src/lib.rs +++ b/gen/logging2_beta1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/logging2_beta1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Logging) ... +//! Handle the following *Resources* with ease from the central [hub](Logging) ... //! //! * entries //! * [*list*](api::EntryListCall) and [*write*](api::EntryWriteCall) @@ -56,8 +56,8 @@ //! let r = hub.projects().metrics_update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -86,12 +86,12 @@ //! use std::default::Default; //! use logging2_beta1::{Logging, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -132,10 +132,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -145,25 +145,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/managedidentities1/README.md b/gen/managedidentities1/README.md index 5b328d9307..2269c62a32 100644 --- a/gen/managedidentities1/README.md +++ b/gen/managedidentities1/README.md @@ -11,7 +11,7 @@ Everything else about the *Managed Service for Microsoft Active Directory Consum [official documentation site](https://cloud.google.com/managed-microsoft-ad/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/ManagedServiceForMicrosoftActiveDirectoryConsumerAPI) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/ManagedServiceForMicrosoftActiveDirectoryConsumerAPI) ... * projects * [*locations get*](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/api::ProjectLocationGetCall), [*locations global domains attach trust*](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/api::ProjectLocationGlobalDomainAttachTrustCall), [*locations global domains backups create*](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/api::ProjectLocationGlobalDomainBackupCreateCall), [*locations global domains backups delete*](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/api::ProjectLocationGlobalDomainBackupDeleteCall), [*locations global domains backups get*](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/api::ProjectLocationGlobalDomainBackupGetCall), [*locations global domains backups get iam policy*](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/api::ProjectLocationGlobalDomainBackupGetIamPolicyCall), [*locations global domains backups list*](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/api::ProjectLocationGlobalDomainBackupListCall), [*locations global domains backups patch*](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/api::ProjectLocationGlobalDomainBackupPatchCall), [*locations global domains backups set iam policy*](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/api::ProjectLocationGlobalDomainBackupSetIamPolicyCall), [*locations global domains backups test iam permissions*](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/api::ProjectLocationGlobalDomainBackupTestIamPermissionCall), [*locations global domains create*](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/api::ProjectLocationGlobalDomainCreateCall), [*locations global domains delete*](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/api::ProjectLocationGlobalDomainDeleteCall), [*locations global domains detach trust*](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/api::ProjectLocationGlobalDomainDetachTrustCall), [*locations global domains extend schema*](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/api::ProjectLocationGlobalDomainExtendSchemaCall), [*locations global domains get*](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/api::ProjectLocationGlobalDomainGetCall), [*locations global domains get iam policy*](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/api::ProjectLocationGlobalDomainGetIamPolicyCall), [*locations global domains get ldapssettings*](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/api::ProjectLocationGlobalDomainGetLdapssettingCall), [*locations global domains list*](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/api::ProjectLocationGlobalDomainListCall), [*locations global domains patch*](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/api::ProjectLocationGlobalDomainPatchCall), [*locations global domains reconfigure trust*](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/api::ProjectLocationGlobalDomainReconfigureTrustCall), [*locations global domains reset admin password*](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/api::ProjectLocationGlobalDomainResetAdminPasswordCall), [*locations global domains restore*](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/api::ProjectLocationGlobalDomainRestoreCall), [*locations global domains set iam policy*](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/api::ProjectLocationGlobalDomainSetIamPolicyCall), [*locations global domains sql integrations get*](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/api::ProjectLocationGlobalDomainSqlIntegrationGetCall), [*locations global domains sql integrations list*](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/api::ProjectLocationGlobalDomainSqlIntegrationListCall), [*locations global domains test iam permissions*](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/api::ProjectLocationGlobalDomainTestIamPermissionCall), [*locations global domains update ldapssettings*](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/api::ProjectLocationGlobalDomainUpdateLdapssettingCall), [*locations global domains validate trust*](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/api::ProjectLocationGlobalDomainValidateTrustCall), [*locations global operations cancel*](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/api::ProjectLocationGlobalOperationCancelCall), [*locations global operations delete*](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/api::ProjectLocationGlobalOperationDeleteCall), [*locations global operations get*](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/api::ProjectLocationGlobalOperationGetCall), [*locations global operations list*](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/api::ProjectLocationGlobalOperationListCall), [*locations global peerings create*](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/api::ProjectLocationGlobalPeeringCreateCall), [*locations global peerings delete*](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/api::ProjectLocationGlobalPeeringDeleteCall), [*locations global peerings get*](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/api::ProjectLocationGlobalPeeringGetCall), [*locations global peerings get iam policy*](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/api::ProjectLocationGlobalPeeringGetIamPolicyCall), [*locations global peerings list*](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/api::ProjectLocationGlobalPeeringListCall), [*locations global peerings patch*](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/api::ProjectLocationGlobalPeeringPatchCall), [*locations global peerings set iam policy*](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/api::ProjectLocationGlobalPeeringSetIamPolicyCall), [*locations global peerings test iam permissions*](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/api::ProjectLocationGlobalPeeringTestIamPermissionCall) and [*locations list*](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/api::ProjectLocationListCall) @@ -66,8 +66,8 @@ let r = hub.projects().locations_global_peerings_delete(...).doit().await let r = hub.projects().locations_global_peerings_patch(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -95,12 +95,12 @@ use managedidentities1::{Result, Error}; use std::default::Default; use managedidentities1::{ManagedServiceForMicrosoftActiveDirectoryConsumerAPI, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -142,10 +142,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -155,25 +155,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-manage You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/client::Delegate) to the -[Method Builder](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/client::Delegate) to the +[Method Builder](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/client::RequestValue) and -[decodable](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/client::RequestValue) and +[decodable](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-managedidentities1/5.0.3+20221227/google_managedidentities1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -192,7 +192,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **managedidentities1** library was generated by Sebastian Thiel, and is placed +The **managedidentities1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/managedidentities1/src/api.rs b/gen/managedidentities1/src/api.rs index 30e5176eb3..3e2eb518a7 100644 --- a/gen/managedidentities1/src/api.rs +++ b/gen/managedidentities1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use managedidentities1::{ManagedServiceForMicrosoftActiveDirectoryConsumerAPI, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/managedidentities1/src/lib.rs b/gen/managedidentities1/src/lib.rs index 08d0d500e9..09112c210d 100644 --- a/gen/managedidentities1/src/lib.rs +++ b/gen/managedidentities1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/managedidentities1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](ManagedServiceForMicrosoftActiveDirectoryConsumerAPI) ... +//! Handle the following *Resources* with ease from the central [hub](ManagedServiceForMicrosoftActiveDirectoryConsumerAPI) ... //! //! * projects //! * [*locations get*](api::ProjectLocationGetCall), [*locations global domains attach trust*](api::ProjectLocationGlobalDomainAttachTrustCall), [*locations global domains backups create*](api::ProjectLocationGlobalDomainBackupCreateCall), [*locations global domains backups delete*](api::ProjectLocationGlobalDomainBackupDeleteCall), [*locations global domains backups get*](api::ProjectLocationGlobalDomainBackupGetCall), [*locations global domains backups get iam policy*](api::ProjectLocationGlobalDomainBackupGetIamPolicyCall), [*locations global domains backups list*](api::ProjectLocationGlobalDomainBackupListCall), [*locations global domains backups patch*](api::ProjectLocationGlobalDomainBackupPatchCall), [*locations global domains backups set iam policy*](api::ProjectLocationGlobalDomainBackupSetIamPolicyCall), [*locations global domains backups test iam permissions*](api::ProjectLocationGlobalDomainBackupTestIamPermissionCall), [*locations global domains create*](api::ProjectLocationGlobalDomainCreateCall), [*locations global domains delete*](api::ProjectLocationGlobalDomainDeleteCall), [*locations global domains detach trust*](api::ProjectLocationGlobalDomainDetachTrustCall), [*locations global domains extend schema*](api::ProjectLocationGlobalDomainExtendSchemaCall), [*locations global domains get*](api::ProjectLocationGlobalDomainGetCall), [*locations global domains get iam policy*](api::ProjectLocationGlobalDomainGetIamPolicyCall), [*locations global domains get ldapssettings*](api::ProjectLocationGlobalDomainGetLdapssettingCall), [*locations global domains list*](api::ProjectLocationGlobalDomainListCall), [*locations global domains patch*](api::ProjectLocationGlobalDomainPatchCall), [*locations global domains reconfigure trust*](api::ProjectLocationGlobalDomainReconfigureTrustCall), [*locations global domains reset admin password*](api::ProjectLocationGlobalDomainResetAdminPasswordCall), [*locations global domains restore*](api::ProjectLocationGlobalDomainRestoreCall), [*locations global domains set iam policy*](api::ProjectLocationGlobalDomainSetIamPolicyCall), [*locations global domains sql integrations get*](api::ProjectLocationGlobalDomainSqlIntegrationGetCall), [*locations global domains sql integrations list*](api::ProjectLocationGlobalDomainSqlIntegrationListCall), [*locations global domains test iam permissions*](api::ProjectLocationGlobalDomainTestIamPermissionCall), [*locations global domains update ldapssettings*](api::ProjectLocationGlobalDomainUpdateLdapssettingCall), [*locations global domains validate trust*](api::ProjectLocationGlobalDomainValidateTrustCall), [*locations global operations cancel*](api::ProjectLocationGlobalOperationCancelCall), [*locations global operations delete*](api::ProjectLocationGlobalOperationDeleteCall), [*locations global operations get*](api::ProjectLocationGlobalOperationGetCall), [*locations global operations list*](api::ProjectLocationGlobalOperationListCall), [*locations global peerings create*](api::ProjectLocationGlobalPeeringCreateCall), [*locations global peerings delete*](api::ProjectLocationGlobalPeeringDeleteCall), [*locations global peerings get*](api::ProjectLocationGlobalPeeringGetCall), [*locations global peerings get iam policy*](api::ProjectLocationGlobalPeeringGetIamPolicyCall), [*locations global peerings list*](api::ProjectLocationGlobalPeeringListCall), [*locations global peerings patch*](api::ProjectLocationGlobalPeeringPatchCall), [*locations global peerings set iam policy*](api::ProjectLocationGlobalPeeringSetIamPolicyCall), [*locations global peerings test iam permissions*](api::ProjectLocationGlobalPeeringTestIamPermissionCall) and [*locations list*](api::ProjectLocationListCall) @@ -66,8 +66,8 @@ //! let r = hub.projects().locations_global_peerings_patch(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -96,12 +96,12 @@ //! use std::default::Default; //! use managedidentities1::{ManagedServiceForMicrosoftActiveDirectoryConsumerAPI, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -143,10 +143,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -156,25 +156,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/manager1_beta2/README.md b/gen/manager1_beta2/README.md index 0a06507be9..e800ce1f7b 100644 --- a/gen/manager1_beta2/README.md +++ b/gen/manager1_beta2/README.md @@ -11,7 +11,7 @@ Everything else about the *manager* *v1_beta2* API can be found at the [official documentation site](https://developers.google.com/deployment-manager/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-manager1_beta2/5.0.3+20140915/google_manager1_beta2/Manager) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-manager1_beta2/5.0.3+20140915/google_manager1_beta2/Manager) ... * [deployments](https://docs.rs/google-manager1_beta2/5.0.3+20140915/google_manager1_beta2/api::Deployment) * [*delete*](https://docs.rs/google-manager1_beta2/5.0.3+20140915/google_manager1_beta2/api::DeploymentDeleteCall), [*get*](https://docs.rs/google-manager1_beta2/5.0.3+20140915/google_manager1_beta2/api::DeploymentGetCall), [*insert*](https://docs.rs/google-manager1_beta2/5.0.3+20140915/google_manager1_beta2/api::DeploymentInsertCall) and [*list*](https://docs.rs/google-manager1_beta2/5.0.3+20140915/google_manager1_beta2/api::DeploymentListCall) @@ -55,8 +55,8 @@ let r = hub.deployments().insert(...).doit().await let r = hub.deployments().list(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -83,12 +83,12 @@ use manager1_beta2::{Result, Error}; use std::default::Default; use manager1_beta2::{Manager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -126,10 +126,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-manager1_beta2/5.0.3+20140915/google_manager1_beta2/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-manager1_beta2/5.0.3+20140915/google_manager1_beta2/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -139,25 +139,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-manage You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-manager1_beta2/5.0.3+20140915/google_manager1_beta2/client::Delegate) to the -[Method Builder](https://docs.rs/google-manager1_beta2/5.0.3+20140915/google_manager1_beta2/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-manager1_beta2/5.0.3+20140915/google_manager1_beta2/client::Delegate) to the +[Method Builder](https://docs.rs/google-manager1_beta2/5.0.3+20140915/google_manager1_beta2/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-manager1_beta2/5.0.3+20140915/google_manager1_beta2/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-manager1_beta2/5.0.3+20140915/google_manager1_beta2/client::RequestValue) and -[decodable](https://docs.rs/google-manager1_beta2/5.0.3+20140915/google_manager1_beta2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-manager1_beta2/5.0.3+20140915/google_manager1_beta2/client::RequestValue) and +[decodable](https://docs.rs/google-manager1_beta2/5.0.3+20140915/google_manager1_beta2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-manager1_beta2/5.0.3+20140915/google_manager1_beta2/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-manager1_beta2/5.0.3+20140915/google_manager1_beta2/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -176,7 +176,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **manager1_beta2** library was generated by Sebastian Thiel, and is placed +The **manager1_beta2** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/manager1_beta2/src/api.rs b/gen/manager1_beta2/src/api.rs index cccde82a73..3b762a4c3e 100644 --- a/gen/manager1_beta2/src/api.rs +++ b/gen/manager1_beta2/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your applications deployed on Google App Engine AppengineAdmin, @@ -88,12 +88,12 @@ impl Default for Scope { /// use std::default::Default; /// use manager1_beta2::{Manager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/manager1_beta2/src/lib.rs b/gen/manager1_beta2/src/lib.rs index 474cbabe48..4a898366fb 100644 --- a/gen/manager1_beta2/src/lib.rs +++ b/gen/manager1_beta2/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/manager1_beta2). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Manager) ... +//! Handle the following *Resources* with ease from the central [hub](Manager) ... //! //! * [deployments](api::Deployment) //! * [*delete*](api::DeploymentDeleteCall), [*get*](api::DeploymentGetCall), [*insert*](api::DeploymentInsertCall) and [*list*](api::DeploymentListCall) @@ -55,8 +55,8 @@ //! let r = hub.deployments().list(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -84,12 +84,12 @@ //! use std::default::Default; //! use manager1_beta2::{Manager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -127,10 +127,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -140,25 +140,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/manufacturers1/README.md b/gen/manufacturers1/README.md index a2a59501fb..34dbe3ff36 100644 --- a/gen/manufacturers1/README.md +++ b/gen/manufacturers1/README.md @@ -11,7 +11,7 @@ Everything else about the *Manufacturer Center* *v1* API can be found at the [official documentation site](https://developers.google.com/manufacturers/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-manufacturers1/5.0.3+20230123/google_manufacturers1/ManufacturerCenter) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-manufacturers1/5.0.3+20230123/google_manufacturers1/ManufacturerCenter) ... * accounts * [*products delete*](https://docs.rs/google-manufacturers1/5.0.3+20230123/google_manufacturers1/api::AccountProductDeleteCall), [*products get*](https://docs.rs/google-manufacturers1/5.0.3+20230123/google_manufacturers1/api::AccountProductGetCall), [*products list*](https://docs.rs/google-manufacturers1/5.0.3+20230123/google_manufacturers1/api::AccountProductListCall) and [*products update*](https://docs.rs/google-manufacturers1/5.0.3+20230123/google_manufacturers1/api::AccountProductUpdateCall) @@ -51,8 +51,8 @@ let r = hub.accounts().products_delete(...).doit().await let r = hub.accounts().products_update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -80,12 +80,12 @@ use manufacturers1::{Result, Error}; use std::default::Default; use manufacturers1::{ManufacturerCenter, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -126,10 +126,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-manufacturers1/5.0.3+20230123/google_manufacturers1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-manufacturers1/5.0.3+20230123/google_manufacturers1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -139,25 +139,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-manufa You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-manufacturers1/5.0.3+20230123/google_manufacturers1/client::Delegate) to the -[Method Builder](https://docs.rs/google-manufacturers1/5.0.3+20230123/google_manufacturers1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-manufacturers1/5.0.3+20230123/google_manufacturers1/client::Delegate) to the +[Method Builder](https://docs.rs/google-manufacturers1/5.0.3+20230123/google_manufacturers1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-manufacturers1/5.0.3+20230123/google_manufacturers1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-manufacturers1/5.0.3+20230123/google_manufacturers1/client::RequestValue) and -[decodable](https://docs.rs/google-manufacturers1/5.0.3+20230123/google_manufacturers1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-manufacturers1/5.0.3+20230123/google_manufacturers1/client::RequestValue) and +[decodable](https://docs.rs/google-manufacturers1/5.0.3+20230123/google_manufacturers1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-manufacturers1/5.0.3+20230123/google_manufacturers1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-manufacturers1/5.0.3+20230123/google_manufacturers1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -176,7 +176,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **manufacturers1** library was generated by Sebastian Thiel, and is placed +The **manufacturers1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/manufacturers1/src/api.rs b/gen/manufacturers1/src/api.rs index 40b745cba9..c87dc15921 100644 --- a/gen/manufacturers1/src/api.rs +++ b/gen/manufacturers1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// Manage your product listings for Google Manufacturer Center Manufacturercenter, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use manufacturers1::{ManufacturerCenter, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/manufacturers1/src/lib.rs b/gen/manufacturers1/src/lib.rs index 6f04e9ea2a..18cdf56a51 100644 --- a/gen/manufacturers1/src/lib.rs +++ b/gen/manufacturers1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/manufacturers1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](ManufacturerCenter) ... +//! Handle the following *Resources* with ease from the central [hub](ManufacturerCenter) ... //! //! * accounts //! * [*products delete*](api::AccountProductDeleteCall), [*products get*](api::AccountProductGetCall), [*products list*](api::AccountProductListCall) and [*products update*](api::AccountProductUpdateCall) @@ -51,8 +51,8 @@ //! let r = hub.accounts().products_update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -81,12 +81,12 @@ //! use std::default::Default; //! use manufacturers1::{ManufacturerCenter, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -127,10 +127,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -140,25 +140,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/memcache1/README.md b/gen/memcache1/README.md index add91d6a68..3a56e79e25 100644 --- a/gen/memcache1/README.md +++ b/gen/memcache1/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Memorystore for Memcached* *v1* API can be foun [official documentation site](https://cloud.google.com/memorystore/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-memcache1/5.0.3+20230103/google_memcache1/CloudMemorystoreForMemcached) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-memcache1/5.0.3+20230103/google_memcache1/CloudMemorystoreForMemcached) ... * projects * [*locations get*](https://docs.rs/google-memcache1/5.0.3+20230103/google_memcache1/api::ProjectLocationGetCall), [*locations instances apply parameters*](https://docs.rs/google-memcache1/5.0.3+20230103/google_memcache1/api::ProjectLocationInstanceApplyParameterCall), [*locations instances create*](https://docs.rs/google-memcache1/5.0.3+20230103/google_memcache1/api::ProjectLocationInstanceCreateCall), [*locations instances delete*](https://docs.rs/google-memcache1/5.0.3+20230103/google_memcache1/api::ProjectLocationInstanceDeleteCall), [*locations instances get*](https://docs.rs/google-memcache1/5.0.3+20230103/google_memcache1/api::ProjectLocationInstanceGetCall), [*locations instances list*](https://docs.rs/google-memcache1/5.0.3+20230103/google_memcache1/api::ProjectLocationInstanceListCall), [*locations instances patch*](https://docs.rs/google-memcache1/5.0.3+20230103/google_memcache1/api::ProjectLocationInstancePatchCall), [*locations instances reschedule maintenance*](https://docs.rs/google-memcache1/5.0.3+20230103/google_memcache1/api::ProjectLocationInstanceRescheduleMaintenanceCall), [*locations instances update parameters*](https://docs.rs/google-memcache1/5.0.3+20230103/google_memcache1/api::ProjectLocationInstanceUpdateParameterCall), [*locations list*](https://docs.rs/google-memcache1/5.0.3+20230103/google_memcache1/api::ProjectLocationListCall), [*locations operations cancel*](https://docs.rs/google-memcache1/5.0.3+20230103/google_memcache1/api::ProjectLocationOperationCancelCall), [*locations operations delete*](https://docs.rs/google-memcache1/5.0.3+20230103/google_memcache1/api::ProjectLocationOperationDeleteCall), [*locations operations get*](https://docs.rs/google-memcache1/5.0.3+20230103/google_memcache1/api::ProjectLocationOperationGetCall) and [*locations operations list*](https://docs.rs/google-memcache1/5.0.3+20230103/google_memcache1/api::ProjectLocationOperationListCall) @@ -56,8 +56,8 @@ let r = hub.projects().locations_instances_update_parameters(...).doit().await let r = hub.projects().locations_operations_get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -85,12 +85,12 @@ use memcache1::{Result, Error}; use std::default::Default; use memcache1::{CloudMemorystoreForMemcached, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -132,10 +132,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-memcache1/5.0.3+20230103/google_memcache1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-memcache1/5.0.3+20230103/google_memcache1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -145,25 +145,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-memcac You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-memcache1/5.0.3+20230103/google_memcache1/client::Delegate) to the -[Method Builder](https://docs.rs/google-memcache1/5.0.3+20230103/google_memcache1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-memcache1/5.0.3+20230103/google_memcache1/client::Delegate) to the +[Method Builder](https://docs.rs/google-memcache1/5.0.3+20230103/google_memcache1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-memcache1/5.0.3+20230103/google_memcache1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-memcache1/5.0.3+20230103/google_memcache1/client::RequestValue) and -[decodable](https://docs.rs/google-memcache1/5.0.3+20230103/google_memcache1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-memcache1/5.0.3+20230103/google_memcache1/client::RequestValue) and +[decodable](https://docs.rs/google-memcache1/5.0.3+20230103/google_memcache1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-memcache1/5.0.3+20230103/google_memcache1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-memcache1/5.0.3+20230103/google_memcache1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -182,7 +182,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **memcache1** library was generated by Sebastian Thiel, and is placed +The **memcache1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/memcache1/src/api.rs b/gen/memcache1/src/api.rs index bceae5769f..7709a35ab8 100644 --- a/gen/memcache1/src/api.rs +++ b/gen/memcache1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use memcache1::{CloudMemorystoreForMemcached, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/memcache1/src/lib.rs b/gen/memcache1/src/lib.rs index 727eca9bb7..97b1b114c3 100644 --- a/gen/memcache1/src/lib.rs +++ b/gen/memcache1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/memcache1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudMemorystoreForMemcached) ... +//! Handle the following *Resources* with ease from the central [hub](CloudMemorystoreForMemcached) ... //! //! * projects //! * [*locations get*](api::ProjectLocationGetCall), [*locations instances apply parameters*](api::ProjectLocationInstanceApplyParameterCall), [*locations instances create*](api::ProjectLocationInstanceCreateCall), [*locations instances delete*](api::ProjectLocationInstanceDeleteCall), [*locations instances get*](api::ProjectLocationInstanceGetCall), [*locations instances list*](api::ProjectLocationInstanceListCall), [*locations instances patch*](api::ProjectLocationInstancePatchCall), [*locations instances reschedule maintenance*](api::ProjectLocationInstanceRescheduleMaintenanceCall), [*locations instances update parameters*](api::ProjectLocationInstanceUpdateParameterCall), [*locations list*](api::ProjectLocationListCall), [*locations operations cancel*](api::ProjectLocationOperationCancelCall), [*locations operations delete*](api::ProjectLocationOperationDeleteCall), [*locations operations get*](api::ProjectLocationOperationGetCall) and [*locations operations list*](api::ProjectLocationOperationListCall) @@ -56,8 +56,8 @@ //! let r = hub.projects().locations_operations_get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -86,12 +86,12 @@ //! use std::default::Default; //! use memcache1::{CloudMemorystoreForMemcached, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -133,10 +133,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -146,25 +146,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/memcache1_beta2/README.md b/gen/memcache1_beta2/README.md index b5601b40a9..ae999aa247 100644 --- a/gen/memcache1_beta2/README.md +++ b/gen/memcache1_beta2/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Memorystore for Memcached* *v1_beta2* API can b [official documentation site](https://cloud.google.com/memorystore/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-memcache1_beta2/5.0.3+20230103/google_memcache1_beta2/CloudMemorystoreForMemcached) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-memcache1_beta2/5.0.3+20230103/google_memcache1_beta2/CloudMemorystoreForMemcached) ... * projects * [*locations get*](https://docs.rs/google-memcache1_beta2/5.0.3+20230103/google_memcache1_beta2/api::ProjectLocationGetCall), [*locations instances apply parameters*](https://docs.rs/google-memcache1_beta2/5.0.3+20230103/google_memcache1_beta2/api::ProjectLocationInstanceApplyParameterCall), [*locations instances apply software update*](https://docs.rs/google-memcache1_beta2/5.0.3+20230103/google_memcache1_beta2/api::ProjectLocationInstanceApplySoftwareUpdateCall), [*locations instances create*](https://docs.rs/google-memcache1_beta2/5.0.3+20230103/google_memcache1_beta2/api::ProjectLocationInstanceCreateCall), [*locations instances delete*](https://docs.rs/google-memcache1_beta2/5.0.3+20230103/google_memcache1_beta2/api::ProjectLocationInstanceDeleteCall), [*locations instances get*](https://docs.rs/google-memcache1_beta2/5.0.3+20230103/google_memcache1_beta2/api::ProjectLocationInstanceGetCall), [*locations instances list*](https://docs.rs/google-memcache1_beta2/5.0.3+20230103/google_memcache1_beta2/api::ProjectLocationInstanceListCall), [*locations instances patch*](https://docs.rs/google-memcache1_beta2/5.0.3+20230103/google_memcache1_beta2/api::ProjectLocationInstancePatchCall), [*locations instances reschedule maintenance*](https://docs.rs/google-memcache1_beta2/5.0.3+20230103/google_memcache1_beta2/api::ProjectLocationInstanceRescheduleMaintenanceCall), [*locations instances update parameters*](https://docs.rs/google-memcache1_beta2/5.0.3+20230103/google_memcache1_beta2/api::ProjectLocationInstanceUpdateParameterCall), [*locations list*](https://docs.rs/google-memcache1_beta2/5.0.3+20230103/google_memcache1_beta2/api::ProjectLocationListCall), [*locations operations cancel*](https://docs.rs/google-memcache1_beta2/5.0.3+20230103/google_memcache1_beta2/api::ProjectLocationOperationCancelCall), [*locations operations delete*](https://docs.rs/google-memcache1_beta2/5.0.3+20230103/google_memcache1_beta2/api::ProjectLocationOperationDeleteCall), [*locations operations get*](https://docs.rs/google-memcache1_beta2/5.0.3+20230103/google_memcache1_beta2/api::ProjectLocationOperationGetCall) and [*locations operations list*](https://docs.rs/google-memcache1_beta2/5.0.3+20230103/google_memcache1_beta2/api::ProjectLocationOperationListCall) @@ -57,8 +57,8 @@ let r = hub.projects().locations_instances_update_parameters(...).doit().await let r = hub.projects().locations_operations_get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -86,12 +86,12 @@ use memcache1_beta2::{Result, Error}; use std::default::Default; use memcache1_beta2::{CloudMemorystoreForMemcached, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -133,10 +133,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-memcache1_beta2/5.0.3+20230103/google_memcache1_beta2/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-memcache1_beta2/5.0.3+20230103/google_memcache1_beta2/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -146,25 +146,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-memcac You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-memcache1_beta2/5.0.3+20230103/google_memcache1_beta2/client::Delegate) to the -[Method Builder](https://docs.rs/google-memcache1_beta2/5.0.3+20230103/google_memcache1_beta2/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-memcache1_beta2/5.0.3+20230103/google_memcache1_beta2/client::Delegate) to the +[Method Builder](https://docs.rs/google-memcache1_beta2/5.0.3+20230103/google_memcache1_beta2/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-memcache1_beta2/5.0.3+20230103/google_memcache1_beta2/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-memcache1_beta2/5.0.3+20230103/google_memcache1_beta2/client::RequestValue) and -[decodable](https://docs.rs/google-memcache1_beta2/5.0.3+20230103/google_memcache1_beta2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-memcache1_beta2/5.0.3+20230103/google_memcache1_beta2/client::RequestValue) and +[decodable](https://docs.rs/google-memcache1_beta2/5.0.3+20230103/google_memcache1_beta2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-memcache1_beta2/5.0.3+20230103/google_memcache1_beta2/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-memcache1_beta2/5.0.3+20230103/google_memcache1_beta2/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -183,7 +183,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **memcache1_beta2** library was generated by Sebastian Thiel, and is placed +The **memcache1_beta2** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/memcache1_beta2/src/api.rs b/gen/memcache1_beta2/src/api.rs index 96740ddb5c..1fab2b1370 100644 --- a/gen/memcache1_beta2/src/api.rs +++ b/gen/memcache1_beta2/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use memcache1_beta2::{CloudMemorystoreForMemcached, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/memcache1_beta2/src/lib.rs b/gen/memcache1_beta2/src/lib.rs index 759e7add91..0439bff3df 100644 --- a/gen/memcache1_beta2/src/lib.rs +++ b/gen/memcache1_beta2/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/memcache1_beta2). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudMemorystoreForMemcached) ... +//! Handle the following *Resources* with ease from the central [hub](CloudMemorystoreForMemcached) ... //! //! * projects //! * [*locations get*](api::ProjectLocationGetCall), [*locations instances apply parameters*](api::ProjectLocationInstanceApplyParameterCall), [*locations instances apply software update*](api::ProjectLocationInstanceApplySoftwareUpdateCall), [*locations instances create*](api::ProjectLocationInstanceCreateCall), [*locations instances delete*](api::ProjectLocationInstanceDeleteCall), [*locations instances get*](api::ProjectLocationInstanceGetCall), [*locations instances list*](api::ProjectLocationInstanceListCall), [*locations instances patch*](api::ProjectLocationInstancePatchCall), [*locations instances reschedule maintenance*](api::ProjectLocationInstanceRescheduleMaintenanceCall), [*locations instances update parameters*](api::ProjectLocationInstanceUpdateParameterCall), [*locations list*](api::ProjectLocationListCall), [*locations operations cancel*](api::ProjectLocationOperationCancelCall), [*locations operations delete*](api::ProjectLocationOperationDeleteCall), [*locations operations get*](api::ProjectLocationOperationGetCall) and [*locations operations list*](api::ProjectLocationOperationListCall) @@ -57,8 +57,8 @@ //! let r = hub.projects().locations_operations_get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -87,12 +87,12 @@ //! use std::default::Default; //! use memcache1_beta2::{CloudMemorystoreForMemcached, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -134,10 +134,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -147,25 +147,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/metastore1_beta/README.md b/gen/metastore1_beta/README.md index a65bf6798d..67c1348dfe 100644 --- a/gen/metastore1_beta/README.md +++ b/gen/metastore1_beta/README.md @@ -11,7 +11,7 @@ Everything else about the *Dataproc Metastore* *v1_beta* API can be found at the [official documentation site](https://cloud.google.com/dataproc-metastore/docs). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/DataprocMetastore) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/DataprocMetastore) ... * projects * [*locations federations create*](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/api::ProjectLocationFederationCreateCall), [*locations federations delete*](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/api::ProjectLocationFederationDeleteCall), [*locations federations get*](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/api::ProjectLocationFederationGetCall), [*locations federations get iam policy*](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/api::ProjectLocationFederationGetIamPolicyCall), [*locations federations list*](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/api::ProjectLocationFederationListCall), [*locations federations patch*](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/api::ProjectLocationFederationPatchCall), [*locations federations set iam policy*](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/api::ProjectLocationFederationSetIamPolicyCall), [*locations federations test iam permissions*](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/api::ProjectLocationFederationTestIamPermissionCall), [*locations get*](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/api::ProjectLocationGetCall), [*locations list*](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/api::ProjectLocationListCall), [*locations operations delete*](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/api::ProjectLocationOperationDeleteCall), [*locations operations get*](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/api::ProjectLocationOperationGetCall), [*locations operations list*](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/api::ProjectLocationOperationListCall), [*locations services alter location*](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/api::ProjectLocationServiceAlterLocationCall), [*locations services backups create*](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/api::ProjectLocationServiceBackupCreateCall), [*locations services backups delete*](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/api::ProjectLocationServiceBackupDeleteCall), [*locations services backups get*](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/api::ProjectLocationServiceBackupGetCall), [*locations services backups get iam policy*](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/api::ProjectLocationServiceBackupGetIamPolicyCall), [*locations services backups list*](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/api::ProjectLocationServiceBackupListCall), [*locations services backups set iam policy*](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/api::ProjectLocationServiceBackupSetIamPolicyCall), [*locations services backups test iam permissions*](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/api::ProjectLocationServiceBackupTestIamPermissionCall), [*locations services create*](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/api::ProjectLocationServiceCreateCall), [*locations services databases get iam policy*](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/api::ProjectLocationServiceDatabaseGetIamPolicyCall), [*locations services databases set iam policy*](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/api::ProjectLocationServiceDatabaseSetIamPolicyCall), [*locations services databases tables get iam policy*](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/api::ProjectLocationServiceDatabaseTableGetIamPolicyCall), [*locations services databases tables set iam policy*](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/api::ProjectLocationServiceDatabaseTableSetIamPolicyCall), [*locations services databases tables test iam permissions*](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/api::ProjectLocationServiceDatabaseTableTestIamPermissionCall), [*locations services databases test iam permissions*](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/api::ProjectLocationServiceDatabaseTestIamPermissionCall), [*locations services delete*](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/api::ProjectLocationServiceDeleteCall), [*locations services export metadata*](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/api::ProjectLocationServiceExportMetadataCall), [*locations services get*](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/api::ProjectLocationServiceGetCall), [*locations services get iam policy*](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/api::ProjectLocationServiceGetIamPolicyCall), [*locations services list*](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/api::ProjectLocationServiceListCall), [*locations services metadata imports create*](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/api::ProjectLocationServiceMetadataImportCreateCall), [*locations services metadata imports get*](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/api::ProjectLocationServiceMetadataImportGetCall), [*locations services metadata imports list*](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/api::ProjectLocationServiceMetadataImportListCall), [*locations services metadata imports patch*](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/api::ProjectLocationServiceMetadataImportPatchCall), [*locations services move table to database*](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/api::ProjectLocationServiceMoveTableToDatabaseCall), [*locations services patch*](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/api::ProjectLocationServicePatchCall), [*locations services query metadata*](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/api::ProjectLocationServiceQueryMetadataCall), [*locations services remove iam policy*](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/api::ProjectLocationServiceRemoveIamPolicyCall), [*locations services restore*](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/api::ProjectLocationServiceRestoreCall), [*locations services set iam policy*](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/api::ProjectLocationServiceSetIamPolicyCall) and [*locations services test iam permissions*](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/api::ProjectLocationServiceTestIamPermissionCall) @@ -65,8 +65,8 @@ let r = hub.projects().locations_services_query_metadata(...).doit().await let r = hub.projects().locations_services_restore(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -94,12 +94,12 @@ use metastore1_beta::{Result, Error}; use std::default::Default; use metastore1_beta::{DataprocMetastore, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -142,10 +142,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -155,25 +155,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-metast You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/client::Delegate) to the -[Method Builder](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/client::Delegate) to the +[Method Builder](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/client::RequestValue) and -[decodable](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/client::RequestValue) and +[decodable](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-metastore1_beta/5.0.3+20230111/google_metastore1_beta/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -192,7 +192,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **metastore1_beta** library was generated by Sebastian Thiel, and is placed +The **metastore1_beta** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/metastore1_beta/src/api.rs b/gen/metastore1_beta/src/api.rs index b71f614ed3..13d1bf69a9 100644 --- a/gen/metastore1_beta/src/api.rs +++ b/gen/metastore1_beta/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use metastore1_beta::{DataprocMetastore, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/metastore1_beta/src/lib.rs b/gen/metastore1_beta/src/lib.rs index c8967e79b3..43aef3aedc 100644 --- a/gen/metastore1_beta/src/lib.rs +++ b/gen/metastore1_beta/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/metastore1_beta). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](DataprocMetastore) ... +//! Handle the following *Resources* with ease from the central [hub](DataprocMetastore) ... //! //! * projects //! * [*locations federations create*](api::ProjectLocationFederationCreateCall), [*locations federations delete*](api::ProjectLocationFederationDeleteCall), [*locations federations get*](api::ProjectLocationFederationGetCall), [*locations federations get iam policy*](api::ProjectLocationFederationGetIamPolicyCall), [*locations federations list*](api::ProjectLocationFederationListCall), [*locations federations patch*](api::ProjectLocationFederationPatchCall), [*locations federations set iam policy*](api::ProjectLocationFederationSetIamPolicyCall), [*locations federations test iam permissions*](api::ProjectLocationFederationTestIamPermissionCall), [*locations get*](api::ProjectLocationGetCall), [*locations list*](api::ProjectLocationListCall), [*locations operations delete*](api::ProjectLocationOperationDeleteCall), [*locations operations get*](api::ProjectLocationOperationGetCall), [*locations operations list*](api::ProjectLocationOperationListCall), [*locations services alter location*](api::ProjectLocationServiceAlterLocationCall), [*locations services backups create*](api::ProjectLocationServiceBackupCreateCall), [*locations services backups delete*](api::ProjectLocationServiceBackupDeleteCall), [*locations services backups get*](api::ProjectLocationServiceBackupGetCall), [*locations services backups get iam policy*](api::ProjectLocationServiceBackupGetIamPolicyCall), [*locations services backups list*](api::ProjectLocationServiceBackupListCall), [*locations services backups set iam policy*](api::ProjectLocationServiceBackupSetIamPolicyCall), [*locations services backups test iam permissions*](api::ProjectLocationServiceBackupTestIamPermissionCall), [*locations services create*](api::ProjectLocationServiceCreateCall), [*locations services databases get iam policy*](api::ProjectLocationServiceDatabaseGetIamPolicyCall), [*locations services databases set iam policy*](api::ProjectLocationServiceDatabaseSetIamPolicyCall), [*locations services databases tables get iam policy*](api::ProjectLocationServiceDatabaseTableGetIamPolicyCall), [*locations services databases tables set iam policy*](api::ProjectLocationServiceDatabaseTableSetIamPolicyCall), [*locations services databases tables test iam permissions*](api::ProjectLocationServiceDatabaseTableTestIamPermissionCall), [*locations services databases test iam permissions*](api::ProjectLocationServiceDatabaseTestIamPermissionCall), [*locations services delete*](api::ProjectLocationServiceDeleteCall), [*locations services export metadata*](api::ProjectLocationServiceExportMetadataCall), [*locations services get*](api::ProjectLocationServiceGetCall), [*locations services get iam policy*](api::ProjectLocationServiceGetIamPolicyCall), [*locations services list*](api::ProjectLocationServiceListCall), [*locations services metadata imports create*](api::ProjectLocationServiceMetadataImportCreateCall), [*locations services metadata imports get*](api::ProjectLocationServiceMetadataImportGetCall), [*locations services metadata imports list*](api::ProjectLocationServiceMetadataImportListCall), [*locations services metadata imports patch*](api::ProjectLocationServiceMetadataImportPatchCall), [*locations services move table to database*](api::ProjectLocationServiceMoveTableToDatabaseCall), [*locations services patch*](api::ProjectLocationServicePatchCall), [*locations services query metadata*](api::ProjectLocationServiceQueryMetadataCall), [*locations services remove iam policy*](api::ProjectLocationServiceRemoveIamPolicyCall), [*locations services restore*](api::ProjectLocationServiceRestoreCall), [*locations services set iam policy*](api::ProjectLocationServiceSetIamPolicyCall) and [*locations services test iam permissions*](api::ProjectLocationServiceTestIamPermissionCall) @@ -65,8 +65,8 @@ //! let r = hub.projects().locations_services_restore(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -95,12 +95,12 @@ //! use std::default::Default; //! use metastore1_beta::{DataprocMetastore, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -143,10 +143,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -156,25 +156,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/mirror1/README.md b/gen/mirror1/README.md index 5328fa7d50..7b7ddcd0ee 100644 --- a/gen/mirror1/README.md +++ b/gen/mirror1/README.md @@ -11,7 +11,7 @@ Everything else about the *mirror* *v1* API can be found at the [official documentation site](https://developers.google.com/glass). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-mirror1/5.0.3+20190424/google_mirror1/Mirror) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-mirror1/5.0.3+20190424/google_mirror1/Mirror) ... * [accounts](https://docs.rs/google-mirror1/5.0.3+20190424/google_mirror1/api::Account) * [*insert*](https://docs.rs/google-mirror1/5.0.3+20190424/google_mirror1/api::AccountInsertCall) @@ -75,8 +75,8 @@ let r = hub.contacts().patch(...).doit().await let r = hub.contacts().update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -104,12 +104,12 @@ use mirror1::{Result, Error}; use std::default::Default; use mirror1::{Mirror, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -150,10 +150,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-mirror1/5.0.3+20190424/google_mirror1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-mirror1/5.0.3+20190424/google_mirror1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -163,25 +163,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-mirror You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-mirror1/5.0.3+20190424/google_mirror1/client::Delegate) to the -[Method Builder](https://docs.rs/google-mirror1/5.0.3+20190424/google_mirror1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-mirror1/5.0.3+20190424/google_mirror1/client::Delegate) to the +[Method Builder](https://docs.rs/google-mirror1/5.0.3+20190424/google_mirror1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-mirror1/5.0.3+20190424/google_mirror1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-mirror1/5.0.3+20190424/google_mirror1/client::RequestValue) and -[decodable](https://docs.rs/google-mirror1/5.0.3+20190424/google_mirror1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-mirror1/5.0.3+20190424/google_mirror1/client::RequestValue) and +[decodable](https://docs.rs/google-mirror1/5.0.3+20190424/google_mirror1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-mirror1/5.0.3+20190424/google_mirror1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-mirror1/5.0.3+20190424/google_mirror1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -200,7 +200,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **mirror1** library was generated by Sebastian Thiel, and is placed +The **mirror1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/mirror1/src/api.rs b/gen/mirror1/src/api.rs index f07d470f56..59b6779d46 100644 --- a/gen/mirror1/src/api.rs +++ b/gen/mirror1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View your location GlasLocation, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use mirror1::{Mirror, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/mirror1/src/lib.rs b/gen/mirror1/src/lib.rs index 10b52c3bd7..83a50d8864 100644 --- a/gen/mirror1/src/lib.rs +++ b/gen/mirror1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/mirror1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Mirror) ... +//! Handle the following *Resources* with ease from the central [hub](Mirror) ... //! //! * [accounts](api::Account) //! * [*insert*](api::AccountInsertCall) @@ -75,8 +75,8 @@ //! let r = hub.contacts().update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -105,12 +105,12 @@ //! use std::default::Default; //! use mirror1::{Mirror, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -151,10 +151,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -164,25 +164,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/ml1/README.md b/gen/ml1/README.md index 6da6c497a1..866bf12d20 100644 --- a/gen/ml1/README.md +++ b/gen/ml1/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Machine Learning Engine* *v1* API can be found [official documentation site](https://cloud.google.com/ml/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/CloudMachineLearningEngine) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/CloudMachineLearningEngine) ... * projects * [*explain*](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/api::ProjectExplainCall), [*get config*](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/api::ProjectGetConfigCall), [*jobs cancel*](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/api::ProjectJobCancelCall), [*jobs create*](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/api::ProjectJobCreateCall), [*jobs get*](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/api::ProjectJobGetCall), [*jobs get iam policy*](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/api::ProjectJobGetIamPolicyCall), [*jobs list*](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/api::ProjectJobListCall), [*jobs patch*](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/api::ProjectJobPatchCall), [*jobs set iam policy*](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/api::ProjectJobSetIamPolicyCall), [*jobs test iam permissions*](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/api::ProjectJobTestIamPermissionCall), [*locations get*](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/api::ProjectLocationGetCall), [*locations list*](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/api::ProjectLocationListCall), [*locations operations cancel*](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/api::ProjectLocationOperationCancelCall), [*locations operations get*](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/api::ProjectLocationOperationGetCall), [*locations studies create*](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/api::ProjectLocationStudyCreateCall), [*locations studies delete*](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/api::ProjectLocationStudyDeleteCall), [*locations studies get*](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/api::ProjectLocationStudyGetCall), [*locations studies list*](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/api::ProjectLocationStudyListCall), [*locations studies trials add measurement*](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/api::ProjectLocationStudyTrialAddMeasurementCall), [*locations studies trials check early stopping state*](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/api::ProjectLocationStudyTrialCheckEarlyStoppingStateCall), [*locations studies trials complete*](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/api::ProjectLocationStudyTrialCompleteCall), [*locations studies trials create*](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/api::ProjectLocationStudyTrialCreateCall), [*locations studies trials delete*](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/api::ProjectLocationStudyTrialDeleteCall), [*locations studies trials get*](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/api::ProjectLocationStudyTrialGetCall), [*locations studies trials list*](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/api::ProjectLocationStudyTrialListCall), [*locations studies trials list optimal trials*](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/api::ProjectLocationStudyTrialListOptimalTrialCall), [*locations studies trials stop*](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/api::ProjectLocationStudyTrialStopCall), [*locations studies trials suggest*](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/api::ProjectLocationStudyTrialSuggestCall), [*models create*](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/api::ProjectModelCreateCall), [*models delete*](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/api::ProjectModelDeleteCall), [*models get*](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/api::ProjectModelGetCall), [*models get iam policy*](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/api::ProjectModelGetIamPolicyCall), [*models list*](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/api::ProjectModelListCall), [*models patch*](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/api::ProjectModelPatchCall), [*models set iam policy*](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/api::ProjectModelSetIamPolicyCall), [*models test iam permissions*](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/api::ProjectModelTestIamPermissionCall), [*models versions create*](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/api::ProjectModelVersionCreateCall), [*models versions delete*](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/api::ProjectModelVersionDeleteCall), [*models versions get*](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/api::ProjectModelVersionGetCall), [*models versions list*](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/api::ProjectModelVersionListCall), [*models versions patch*](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/api::ProjectModelVersionPatchCall), [*models versions set default*](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/api::ProjectModelVersionSetDefaultCall), [*operations cancel*](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/api::ProjectOperationCancelCall), [*operations get*](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/api::ProjectOperationGetCall), [*operations list*](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/api::ProjectOperationListCall) and [*predict*](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/api::ProjectPredictCall) @@ -58,8 +58,8 @@ let r = hub.projects().models_patch(...).doit().await let r = hub.projects().operations_get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -87,12 +87,12 @@ use ml1::{Result, Error}; use std::default::Default; use ml1::{CloudMachineLearningEngine, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -134,10 +134,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -147,25 +147,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-ml1/5. You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/client::Delegate) to the -[Method Builder](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/client::Delegate) to the +[Method Builder](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/client::RequestValue) and -[decodable](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/client::RequestValue) and +[decodable](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-ml1/5.0.3+20230106/google_ml1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -184,7 +184,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **ml1** library was generated by Sebastian Thiel, and is placed +The **ml1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/ml1/src/api.rs b/gen/ml1/src/api.rs index 0bab8c9e1e..a988f18dcb 100644 --- a/gen/ml1/src/api.rs +++ b/gen/ml1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use ml1::{CloudMachineLearningEngine, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/ml1/src/lib.rs b/gen/ml1/src/lib.rs index 02de00b88c..79d3727cca 100644 --- a/gen/ml1/src/lib.rs +++ b/gen/ml1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/ml1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudMachineLearningEngine) ... +//! Handle the following *Resources* with ease from the central [hub](CloudMachineLearningEngine) ... //! //! * projects //! * [*explain*](api::ProjectExplainCall), [*get config*](api::ProjectGetConfigCall), [*jobs cancel*](api::ProjectJobCancelCall), [*jobs create*](api::ProjectJobCreateCall), [*jobs get*](api::ProjectJobGetCall), [*jobs get iam policy*](api::ProjectJobGetIamPolicyCall), [*jobs list*](api::ProjectJobListCall), [*jobs patch*](api::ProjectJobPatchCall), [*jobs set iam policy*](api::ProjectJobSetIamPolicyCall), [*jobs test iam permissions*](api::ProjectJobTestIamPermissionCall), [*locations get*](api::ProjectLocationGetCall), [*locations list*](api::ProjectLocationListCall), [*locations operations cancel*](api::ProjectLocationOperationCancelCall), [*locations operations get*](api::ProjectLocationOperationGetCall), [*locations studies create*](api::ProjectLocationStudyCreateCall), [*locations studies delete*](api::ProjectLocationStudyDeleteCall), [*locations studies get*](api::ProjectLocationStudyGetCall), [*locations studies list*](api::ProjectLocationStudyListCall), [*locations studies trials add measurement*](api::ProjectLocationStudyTrialAddMeasurementCall), [*locations studies trials check early stopping state*](api::ProjectLocationStudyTrialCheckEarlyStoppingStateCall), [*locations studies trials complete*](api::ProjectLocationStudyTrialCompleteCall), [*locations studies trials create*](api::ProjectLocationStudyTrialCreateCall), [*locations studies trials delete*](api::ProjectLocationStudyTrialDeleteCall), [*locations studies trials get*](api::ProjectLocationStudyTrialGetCall), [*locations studies trials list*](api::ProjectLocationStudyTrialListCall), [*locations studies trials list optimal trials*](api::ProjectLocationStudyTrialListOptimalTrialCall), [*locations studies trials stop*](api::ProjectLocationStudyTrialStopCall), [*locations studies trials suggest*](api::ProjectLocationStudyTrialSuggestCall), [*models create*](api::ProjectModelCreateCall), [*models delete*](api::ProjectModelDeleteCall), [*models get*](api::ProjectModelGetCall), [*models get iam policy*](api::ProjectModelGetIamPolicyCall), [*models list*](api::ProjectModelListCall), [*models patch*](api::ProjectModelPatchCall), [*models set iam policy*](api::ProjectModelSetIamPolicyCall), [*models test iam permissions*](api::ProjectModelTestIamPermissionCall), [*models versions create*](api::ProjectModelVersionCreateCall), [*models versions delete*](api::ProjectModelVersionDeleteCall), [*models versions get*](api::ProjectModelVersionGetCall), [*models versions list*](api::ProjectModelVersionListCall), [*models versions patch*](api::ProjectModelVersionPatchCall), [*models versions set default*](api::ProjectModelVersionSetDefaultCall), [*operations cancel*](api::ProjectOperationCancelCall), [*operations get*](api::ProjectOperationGetCall), [*operations list*](api::ProjectOperationListCall) and [*predict*](api::ProjectPredictCall) @@ -58,8 +58,8 @@ //! let r = hub.projects().operations_get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -88,12 +88,12 @@ //! use std::default::Default; //! use ml1::{CloudMachineLearningEngine, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -135,10 +135,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -148,25 +148,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/monitoring3/README.md b/gen/monitoring3/README.md index 63fb45cdf1..5d699af49a 100644 --- a/gen/monitoring3/README.md +++ b/gen/monitoring3/README.md @@ -11,7 +11,7 @@ Everything else about the *Monitoring* *v3* API can be found at the [official documentation site](https://cloud.google.com/monitoring/api/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-monitoring3/5.0.3+20230115/google_monitoring3/Monitoring) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-monitoring3/5.0.3+20230115/google_monitoring3/Monitoring) ... * folders * [*time series list*](https://docs.rs/google-monitoring3/5.0.3+20230115/google_monitoring3/api::FolderTimeSeryListCall) @@ -67,8 +67,8 @@ let r = hub.services().list(...).doit().await let r = hub.services().patch(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -95,12 +95,12 @@ use monitoring3::{Result, Error}; use std::default::Default; use monitoring3::{Monitoring, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -140,10 +140,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-monitoring3/5.0.3+20230115/google_monitoring3/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-monitoring3/5.0.3+20230115/google_monitoring3/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -153,25 +153,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-monito You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-monitoring3/5.0.3+20230115/google_monitoring3/client::Delegate) to the -[Method Builder](https://docs.rs/google-monitoring3/5.0.3+20230115/google_monitoring3/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-monitoring3/5.0.3+20230115/google_monitoring3/client::Delegate) to the +[Method Builder](https://docs.rs/google-monitoring3/5.0.3+20230115/google_monitoring3/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-monitoring3/5.0.3+20230115/google_monitoring3/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-monitoring3/5.0.3+20230115/google_monitoring3/client::RequestValue) and -[decodable](https://docs.rs/google-monitoring3/5.0.3+20230115/google_monitoring3/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-monitoring3/5.0.3+20230115/google_monitoring3/client::RequestValue) and +[decodable](https://docs.rs/google-monitoring3/5.0.3+20230115/google_monitoring3/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-monitoring3/5.0.3+20230115/google_monitoring3/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-monitoring3/5.0.3+20230115/google_monitoring3/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -190,7 +190,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **monitoring3** library was generated by Sebastian Thiel, and is placed +The **monitoring3** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/monitoring3/src/api.rs b/gen/monitoring3/src/api.rs index b6a41f3f5d..59806c2fa4 100644 --- a/gen/monitoring3/src/api.rs +++ b/gen/monitoring3/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -76,12 +76,12 @@ impl Default for Scope { /// use std::default::Default; /// use monitoring3::{Monitoring, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/monitoring3/src/lib.rs b/gen/monitoring3/src/lib.rs index e934b95b52..eee75609b8 100644 --- a/gen/monitoring3/src/lib.rs +++ b/gen/monitoring3/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/monitoring3). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Monitoring) ... +//! Handle the following *Resources* with ease from the central [hub](Monitoring) ... //! //! * folders //! * [*time series list*](api::FolderTimeSeryListCall) @@ -67,8 +67,8 @@ //! let r = hub.services().patch(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -96,12 +96,12 @@ //! use std::default::Default; //! use monitoring3::{Monitoring, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -141,10 +141,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -154,25 +154,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/mybusiness4/README.md b/gen/mybusiness4/README.md index 1a07393a78..ae5a55b2e9 100644 --- a/gen/mybusiness4/README.md +++ b/gen/mybusiness4/README.md @@ -11,7 +11,7 @@ Everything else about the *My Business* *v4* API can be found at the [official documentation site](https://developers.google.com/my-business/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/MyBusiness) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/MyBusiness) ... * [accounts](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::Account) * [*admins create*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountAdminCreateCall), [*admins delete*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountAdminDeleteCall), [*admins list*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountAdminListCall), [*admins patch*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountAdminPatchCall), [*create*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountCreateCall), [*delete notifications*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountDeleteNotificationCall), [*generate account number*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountGenerateAccountNumberCall), [*get*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountGetCall), [*get notifications*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountGetNotificationCall), [*invitations accept*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountInvitationAcceptCall), [*invitations decline*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountInvitationDeclineCall), [*invitations list*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountInvitationListCall), [*list*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountListCall), [*list recommend google locations*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountListRecommendGoogleLocationCall), [*locations admins create*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountLocationAdminCreateCall), [*locations admins delete*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountLocationAdminDeleteCall), [*locations admins list*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountLocationAdminListCall), [*locations admins patch*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountLocationAdminPatchCall), [*locations associate*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountLocationAssociateCall), [*locations batch get*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountLocationBatchGetCall), [*locations batch get reviews*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountLocationBatchGetReviewCall), [*locations clear association*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountLocationClearAssociationCall), [*locations create*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountLocationCreateCall), [*locations delete*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountLocationDeleteCall), [*locations fetch verification options*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountLocationFetchVerificationOptionCall), [*locations find matches*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountLocationFindMatchCall), [*locations followers get metadata*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountLocationFollowerGetMetadataCall), [*locations get*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountLocationGetCall), [*locations get google updated*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountLocationGetGoogleUpdatedCall), [*locations list*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountLocationListCall), [*locations local posts create*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountLocationLocalPostCreateCall), [*locations local posts delete*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountLocationLocalPostDeleteCall), [*locations local posts get*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountLocationLocalPostGetCall), [*locations local posts list*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountLocationLocalPostListCall), [*locations local posts patch*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountLocationLocalPostPatchCall), [*locations local posts report insights*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountLocationLocalPostReportInsightCall), [*locations media create*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountLocationMediaCreateCall), [*locations media customers get*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountLocationMediaCustomerGetCall), [*locations media customers list*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountLocationMediaCustomerListCall), [*locations media delete*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountLocationMediaDeleteCall), [*locations media get*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountLocationMediaGetCall), [*locations media list*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountLocationMediaListCall), [*locations media patch*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountLocationMediaPatchCall), [*locations media start upload*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountLocationMediaStartUploadCall), [*locations patch*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountLocationPatchCall), [*locations questions answers delete*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountLocationQuestionAnswerDeleteCall), [*locations questions answers list*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountLocationQuestionAnswerListCall), [*locations questions answers upsert*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountLocationQuestionAnswerUpsertCall), [*locations questions create*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountLocationQuestionCreateCall), [*locations questions delete*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountLocationQuestionDeleteCall), [*locations questions list*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountLocationQuestionListCall), [*locations questions patch*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountLocationQuestionPatchCall), [*locations report insights*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountLocationReportInsightCall), [*locations reviews delete reply*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountLocationReviewDeleteReplyCall), [*locations reviews get*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountLocationReviewGetCall), [*locations reviews list*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountLocationReviewListCall), [*locations reviews update reply*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountLocationReviewUpdateReplyCall), [*locations transfer*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountLocationTransferCall), [*locations verifications complete*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountLocationVerificationCompleteCall), [*locations verifications list*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountLocationVerificationListCall), [*locations verify*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountLocationVerifyCall), [*update*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountUpdateCall) and [*update notifications*](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/api::AccountUpdateNotificationCall) @@ -122,8 +122,8 @@ let r = hub.accounts().update(...).doit().await let r = hub.accounts().update_notifications(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -150,12 +150,12 @@ use mybusiness4::{Result, Error}; use std::default::Default; use mybusiness4::{MyBusiness, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -196,10 +196,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -209,25 +209,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-mybusi You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/client::Delegate) to the -[Method Builder](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/client::Delegate) to the +[Method Builder](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/client::RequestValue) and -[decodable](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/client::RequestValue) and +[decodable](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-mybusiness4/5.0.3+0/google_mybusiness4/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -246,7 +246,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **mybusiness4** library was generated by Sebastian Thiel, and is placed +The **mybusiness4** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/mybusiness4/src/api.rs b/gen/mybusiness4/src/api.rs index 202ad6360f..71e51573a8 100644 --- a/gen/mybusiness4/src/api.rs +++ b/gen/mybusiness4/src/api.rs @@ -42,12 +42,12 @@ use crate::{client, client::GetToken, client::serde_with}; /// use std::default::Default; /// use mybusiness4::{MyBusiness, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/mybusiness4/src/lib.rs b/gen/mybusiness4/src/lib.rs index d2506f1fb6..f86eb6e239 100644 --- a/gen/mybusiness4/src/lib.rs +++ b/gen/mybusiness4/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/mybusiness4). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](MyBusiness) ... +//! Handle the following *Resources* with ease from the central [hub](MyBusiness) ... //! //! * [accounts](api::Account) //! * [*admins create*](api::AccountAdminCreateCall), [*admins delete*](api::AccountAdminDeleteCall), [*admins list*](api::AccountAdminListCall), [*admins patch*](api::AccountAdminPatchCall), [*create*](api::AccountCreateCall), [*delete notifications*](api::AccountDeleteNotificationCall), [*generate account number*](api::AccountGenerateAccountNumberCall), [*get*](api::AccountGetCall), [*get notifications*](api::AccountGetNotificationCall), [*invitations accept*](api::AccountInvitationAcceptCall), [*invitations decline*](api::AccountInvitationDeclineCall), [*invitations list*](api::AccountInvitationListCall), [*list*](api::AccountListCall), [*list recommend google locations*](api::AccountListRecommendGoogleLocationCall), [*locations admins create*](api::AccountLocationAdminCreateCall), [*locations admins delete*](api::AccountLocationAdminDeleteCall), [*locations admins list*](api::AccountLocationAdminListCall), [*locations admins patch*](api::AccountLocationAdminPatchCall), [*locations associate*](api::AccountLocationAssociateCall), [*locations batch get*](api::AccountLocationBatchGetCall), [*locations batch get reviews*](api::AccountLocationBatchGetReviewCall), [*locations clear association*](api::AccountLocationClearAssociationCall), [*locations create*](api::AccountLocationCreateCall), [*locations delete*](api::AccountLocationDeleteCall), [*locations fetch verification options*](api::AccountLocationFetchVerificationOptionCall), [*locations find matches*](api::AccountLocationFindMatchCall), [*locations followers get metadata*](api::AccountLocationFollowerGetMetadataCall), [*locations get*](api::AccountLocationGetCall), [*locations get google updated*](api::AccountLocationGetGoogleUpdatedCall), [*locations list*](api::AccountLocationListCall), [*locations local posts create*](api::AccountLocationLocalPostCreateCall), [*locations local posts delete*](api::AccountLocationLocalPostDeleteCall), [*locations local posts get*](api::AccountLocationLocalPostGetCall), [*locations local posts list*](api::AccountLocationLocalPostListCall), [*locations local posts patch*](api::AccountLocationLocalPostPatchCall), [*locations local posts report insights*](api::AccountLocationLocalPostReportInsightCall), [*locations media create*](api::AccountLocationMediaCreateCall), [*locations media customers get*](api::AccountLocationMediaCustomerGetCall), [*locations media customers list*](api::AccountLocationMediaCustomerListCall), [*locations media delete*](api::AccountLocationMediaDeleteCall), [*locations media get*](api::AccountLocationMediaGetCall), [*locations media list*](api::AccountLocationMediaListCall), [*locations media patch*](api::AccountLocationMediaPatchCall), [*locations media start upload*](api::AccountLocationMediaStartUploadCall), [*locations patch*](api::AccountLocationPatchCall), [*locations questions answers delete*](api::AccountLocationQuestionAnswerDeleteCall), [*locations questions answers list*](api::AccountLocationQuestionAnswerListCall), [*locations questions answers upsert*](api::AccountLocationQuestionAnswerUpsertCall), [*locations questions create*](api::AccountLocationQuestionCreateCall), [*locations questions delete*](api::AccountLocationQuestionDeleteCall), [*locations questions list*](api::AccountLocationQuestionListCall), [*locations questions patch*](api::AccountLocationQuestionPatchCall), [*locations report insights*](api::AccountLocationReportInsightCall), [*locations reviews delete reply*](api::AccountLocationReviewDeleteReplyCall), [*locations reviews get*](api::AccountLocationReviewGetCall), [*locations reviews list*](api::AccountLocationReviewListCall), [*locations reviews update reply*](api::AccountLocationReviewUpdateReplyCall), [*locations transfer*](api::AccountLocationTransferCall), [*locations verifications complete*](api::AccountLocationVerificationCompleteCall), [*locations verifications list*](api::AccountLocationVerificationListCall), [*locations verify*](api::AccountLocationVerifyCall), [*update*](api::AccountUpdateCall) and [*update notifications*](api::AccountUpdateNotificationCall) @@ -122,8 +122,8 @@ //! let r = hub.accounts().update_notifications(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -151,12 +151,12 @@ //! use std::default::Default; //! use mybusiness4::{MyBusiness, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -197,10 +197,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -210,25 +210,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/mybusinessaccountmanagement1/README.md b/gen/mybusinessaccountmanagement1/README.md index 42e86294d5..99423822c5 100644 --- a/gen/mybusinessaccountmanagement1/README.md +++ b/gen/mybusinessaccountmanagement1/README.md @@ -11,7 +11,7 @@ Everything else about the *My Business Account Management* *v1* API can be found [official documentation site](https://developers.google.com/my-business/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-mybusinessaccountmanagement1/5.0.3+20230124/google_mybusinessaccountmanagement1/MyBusinessAccountManagement) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-mybusinessaccountmanagement1/5.0.3+20230124/google_mybusinessaccountmanagement1/MyBusinessAccountManagement) ... * [accounts](https://docs.rs/google-mybusinessaccountmanagement1/5.0.3+20230124/google_mybusinessaccountmanagement1/api::Account) * [*admins create*](https://docs.rs/google-mybusinessaccountmanagement1/5.0.3+20230124/google_mybusinessaccountmanagement1/api::AccountAdminCreateCall), [*admins delete*](https://docs.rs/google-mybusinessaccountmanagement1/5.0.3+20230124/google_mybusinessaccountmanagement1/api::AccountAdminDeleteCall), [*admins list*](https://docs.rs/google-mybusinessaccountmanagement1/5.0.3+20230124/google_mybusinessaccountmanagement1/api::AccountAdminListCall), [*admins patch*](https://docs.rs/google-mybusinessaccountmanagement1/5.0.3+20230124/google_mybusinessaccountmanagement1/api::AccountAdminPatchCall), [*create*](https://docs.rs/google-mybusinessaccountmanagement1/5.0.3+20230124/google_mybusinessaccountmanagement1/api::AccountCreateCall), [*get*](https://docs.rs/google-mybusinessaccountmanagement1/5.0.3+20230124/google_mybusinessaccountmanagement1/api::AccountGetCall), [*invitations accept*](https://docs.rs/google-mybusinessaccountmanagement1/5.0.3+20230124/google_mybusinessaccountmanagement1/api::AccountInvitationAcceptCall), [*invitations decline*](https://docs.rs/google-mybusinessaccountmanagement1/5.0.3+20230124/google_mybusinessaccountmanagement1/api::AccountInvitationDeclineCall), [*invitations list*](https://docs.rs/google-mybusinessaccountmanagement1/5.0.3+20230124/google_mybusinessaccountmanagement1/api::AccountInvitationListCall), [*list*](https://docs.rs/google-mybusinessaccountmanagement1/5.0.3+20230124/google_mybusinessaccountmanagement1/api::AccountListCall) and [*patch*](https://docs.rs/google-mybusinessaccountmanagement1/5.0.3+20230124/google_mybusinessaccountmanagement1/api::AccountPatchCall) @@ -62,8 +62,8 @@ let r = hub.accounts().list(...).doit().await let r = hub.accounts().patch(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -90,12 +90,12 @@ use mybusinessaccountmanagement1::{Result, Error}; use std::default::Default; use mybusinessaccountmanagement1::{MyBusinessAccountManagement, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -135,10 +135,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-mybusinessaccountmanagement1/5.0.3+20230124/google_mybusinessaccountmanagement1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-mybusinessaccountmanagement1/5.0.3+20230124/google_mybusinessaccountmanagement1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -148,25 +148,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-mybusi You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-mybusinessaccountmanagement1/5.0.3+20230124/google_mybusinessaccountmanagement1/client::Delegate) to the -[Method Builder](https://docs.rs/google-mybusinessaccountmanagement1/5.0.3+20230124/google_mybusinessaccountmanagement1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-mybusinessaccountmanagement1/5.0.3+20230124/google_mybusinessaccountmanagement1/client::Delegate) to the +[Method Builder](https://docs.rs/google-mybusinessaccountmanagement1/5.0.3+20230124/google_mybusinessaccountmanagement1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-mybusinessaccountmanagement1/5.0.3+20230124/google_mybusinessaccountmanagement1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-mybusinessaccountmanagement1/5.0.3+20230124/google_mybusinessaccountmanagement1/client::RequestValue) and -[decodable](https://docs.rs/google-mybusinessaccountmanagement1/5.0.3+20230124/google_mybusinessaccountmanagement1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-mybusinessaccountmanagement1/5.0.3+20230124/google_mybusinessaccountmanagement1/client::RequestValue) and +[decodable](https://docs.rs/google-mybusinessaccountmanagement1/5.0.3+20230124/google_mybusinessaccountmanagement1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-mybusinessaccountmanagement1/5.0.3+20230124/google_mybusinessaccountmanagement1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-mybusinessaccountmanagement1/5.0.3+20230124/google_mybusinessaccountmanagement1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -185,7 +185,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **mybusinessaccountmanagement1** library was generated by Sebastian Thiel, and is placed +The **mybusinessaccountmanagement1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/mybusinessaccountmanagement1/src/api.rs b/gen/mybusinessaccountmanagement1/src/api.rs index 85c94b3b17..1ba31114e3 100644 --- a/gen/mybusinessaccountmanagement1/src/api.rs +++ b/gen/mybusinessaccountmanagement1/src/api.rs @@ -42,12 +42,12 @@ use crate::{client, client::GetToken, client::serde_with}; /// use std::default::Default; /// use mybusinessaccountmanagement1::{MyBusinessAccountManagement, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/mybusinessaccountmanagement1/src/lib.rs b/gen/mybusinessaccountmanagement1/src/lib.rs index a1d225237d..dc151ca3ba 100644 --- a/gen/mybusinessaccountmanagement1/src/lib.rs +++ b/gen/mybusinessaccountmanagement1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/mybusinessaccountmanagement1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](MyBusinessAccountManagement) ... +//! Handle the following *Resources* with ease from the central [hub](MyBusinessAccountManagement) ... //! //! * [accounts](api::Account) //! * [*admins create*](api::AccountAdminCreateCall), [*admins delete*](api::AccountAdminDeleteCall), [*admins list*](api::AccountAdminListCall), [*admins patch*](api::AccountAdminPatchCall), [*create*](api::AccountCreateCall), [*get*](api::AccountGetCall), [*invitations accept*](api::AccountInvitationAcceptCall), [*invitations decline*](api::AccountInvitationDeclineCall), [*invitations list*](api::AccountInvitationListCall), [*list*](api::AccountListCall) and [*patch*](api::AccountPatchCall) @@ -62,8 +62,8 @@ //! let r = hub.accounts().patch(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -91,12 +91,12 @@ //! use std::default::Default; //! use mybusinessaccountmanagement1::{MyBusinessAccountManagement, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -136,10 +136,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -149,25 +149,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/mybusinessbusinesscalls1/README.md b/gen/mybusinessbusinesscalls1/README.md index ecac346fa1..c96a1ce699 100644 --- a/gen/mybusinessbusinesscalls1/README.md +++ b/gen/mybusinessbusinesscalls1/README.md @@ -11,7 +11,7 @@ Everything else about the *My Business Business Calls* *v1* API can be found at [official documentation site](https://developers.google.com/my-business/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-mybusinessbusinesscalls1/5.0.3+20230124/google_mybusinessbusinesscalls1/MyBusinessBusinessCalls) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-mybusinessbusinesscalls1/5.0.3+20230124/google_mybusinessbusinesscalls1/MyBusinessBusinessCalls) ... * locations * [*businesscallsinsights list*](https://docs.rs/google-mybusinessbusinesscalls1/5.0.3+20230124/google_mybusinessbusinesscalls1/api::LocationBusinesscallsinsightListCall), [*get businesscallssettings*](https://docs.rs/google-mybusinessbusinesscalls1/5.0.3+20230124/google_mybusinessbusinesscalls1/api::LocationGetBusinesscallssettingCall) and [*update businesscallssettings*](https://docs.rs/google-mybusinessbusinesscalls1/5.0.3+20230124/google_mybusinessbusinesscalls1/api::LocationUpdateBusinesscallssettingCall) @@ -51,8 +51,8 @@ let r = hub.locations().get_businesscallssettings(...).doit().await let r = hub.locations().update_businesscallssettings(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -80,12 +80,12 @@ use mybusinessbusinesscalls1::{Result, Error}; use std::default::Default; use mybusinessbusinesscalls1::{MyBusinessBusinessCalls, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -127,10 +127,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-mybusinessbusinesscalls1/5.0.3+20230124/google_mybusinessbusinesscalls1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-mybusinessbusinesscalls1/5.0.3+20230124/google_mybusinessbusinesscalls1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -140,25 +140,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-mybusi You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-mybusinessbusinesscalls1/5.0.3+20230124/google_mybusinessbusinesscalls1/client::Delegate) to the -[Method Builder](https://docs.rs/google-mybusinessbusinesscalls1/5.0.3+20230124/google_mybusinessbusinesscalls1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-mybusinessbusinesscalls1/5.0.3+20230124/google_mybusinessbusinesscalls1/client::Delegate) to the +[Method Builder](https://docs.rs/google-mybusinessbusinesscalls1/5.0.3+20230124/google_mybusinessbusinesscalls1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-mybusinessbusinesscalls1/5.0.3+20230124/google_mybusinessbusinesscalls1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-mybusinessbusinesscalls1/5.0.3+20230124/google_mybusinessbusinesscalls1/client::RequestValue) and -[decodable](https://docs.rs/google-mybusinessbusinesscalls1/5.0.3+20230124/google_mybusinessbusinesscalls1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-mybusinessbusinesscalls1/5.0.3+20230124/google_mybusinessbusinesscalls1/client::RequestValue) and +[decodable](https://docs.rs/google-mybusinessbusinesscalls1/5.0.3+20230124/google_mybusinessbusinesscalls1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-mybusinessbusinesscalls1/5.0.3+20230124/google_mybusinessbusinesscalls1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-mybusinessbusinesscalls1/5.0.3+20230124/google_mybusinessbusinesscalls1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -177,7 +177,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **mybusinessbusinesscalls1** library was generated by Sebastian Thiel, and is placed +The **mybusinessbusinesscalls1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/mybusinessbusinesscalls1/src/api.rs b/gen/mybusinessbusinesscalls1/src/api.rs index a21d2269df..03f6774691 100644 --- a/gen/mybusinessbusinesscalls1/src/api.rs +++ b/gen/mybusinessbusinesscalls1/src/api.rs @@ -43,12 +43,12 @@ use crate::{client, client::GetToken, client::serde_with}; /// use std::default::Default; /// use mybusinessbusinesscalls1::{MyBusinessBusinessCalls, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/mybusinessbusinesscalls1/src/lib.rs b/gen/mybusinessbusinesscalls1/src/lib.rs index e134811086..7f9c15597f 100644 --- a/gen/mybusinessbusinesscalls1/src/lib.rs +++ b/gen/mybusinessbusinesscalls1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/mybusinessbusinesscalls1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](MyBusinessBusinessCalls) ... +//! Handle the following *Resources* with ease from the central [hub](MyBusinessBusinessCalls) ... //! //! * locations //! * [*businesscallsinsights list*](api::LocationBusinesscallsinsightListCall), [*get businesscallssettings*](api::LocationGetBusinesscallssettingCall) and [*update businesscallssettings*](api::LocationUpdateBusinesscallssettingCall) @@ -51,8 +51,8 @@ //! let r = hub.locations().update_businesscallssettings(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -81,12 +81,12 @@ //! use std::default::Default; //! use mybusinessbusinesscalls1::{MyBusinessBusinessCalls, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -128,10 +128,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -141,25 +141,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/mybusinessbusinessinformation1/README.md b/gen/mybusinessbusinessinformation1/README.md index df14a0bb99..0c53296832 100644 --- a/gen/mybusinessbusinessinformation1/README.md +++ b/gen/mybusinessbusinessinformation1/README.md @@ -11,7 +11,7 @@ Everything else about the *My Business Business Information* *v1* API can be fou [official documentation site](https://developers.google.com/my-business/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-mybusinessbusinessinformation1/5.0.3+20230124/google_mybusinessbusinessinformation1/MyBusinessBusinessInformation) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-mybusinessbusinessinformation1/5.0.3+20230124/google_mybusinessbusinessinformation1/MyBusinessBusinessInformation) ... * accounts * [*locations create*](https://docs.rs/google-mybusinessbusinessinformation1/5.0.3+20230124/google_mybusinessbusinessinformation1/api::AccountLocationCreateCall) and [*locations list*](https://docs.rs/google-mybusinessbusinessinformation1/5.0.3+20230124/google_mybusinessbusinessinformation1/api::AccountLocationListCall) @@ -69,8 +69,8 @@ let r = hub.locations().patch(...).doit().await let r = hub.locations().update_attributes(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -98,12 +98,12 @@ use mybusinessbusinessinformation1::{Result, Error}; use std::default::Default; use mybusinessbusinessinformation1::{MyBusinessBusinessInformation, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -146,10 +146,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-mybusinessbusinessinformation1/5.0.3+20230124/google_mybusinessbusinessinformation1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-mybusinessbusinessinformation1/5.0.3+20230124/google_mybusinessbusinessinformation1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -159,25 +159,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-mybusi You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-mybusinessbusinessinformation1/5.0.3+20230124/google_mybusinessbusinessinformation1/client::Delegate) to the -[Method Builder](https://docs.rs/google-mybusinessbusinessinformation1/5.0.3+20230124/google_mybusinessbusinessinformation1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-mybusinessbusinessinformation1/5.0.3+20230124/google_mybusinessbusinessinformation1/client::Delegate) to the +[Method Builder](https://docs.rs/google-mybusinessbusinessinformation1/5.0.3+20230124/google_mybusinessbusinessinformation1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-mybusinessbusinessinformation1/5.0.3+20230124/google_mybusinessbusinessinformation1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-mybusinessbusinessinformation1/5.0.3+20230124/google_mybusinessbusinessinformation1/client::RequestValue) and -[decodable](https://docs.rs/google-mybusinessbusinessinformation1/5.0.3+20230124/google_mybusinessbusinessinformation1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-mybusinessbusinessinformation1/5.0.3+20230124/google_mybusinessbusinessinformation1/client::RequestValue) and +[decodable](https://docs.rs/google-mybusinessbusinessinformation1/5.0.3+20230124/google_mybusinessbusinessinformation1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-mybusinessbusinessinformation1/5.0.3+20230124/google_mybusinessbusinessinformation1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-mybusinessbusinessinformation1/5.0.3+20230124/google_mybusinessbusinessinformation1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -196,7 +196,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **mybusinessbusinessinformation1** library was generated by Sebastian Thiel, and is placed +The **mybusinessbusinessinformation1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/mybusinessbusinessinformation1/src/api.rs b/gen/mybusinessbusinessinformation1/src/api.rs index d48b4bc9d5..230cdbc884 100644 --- a/gen/mybusinessbusinessinformation1/src/api.rs +++ b/gen/mybusinessbusinessinformation1/src/api.rs @@ -43,12 +43,12 @@ use crate::{client, client::GetToken, client::serde_with}; /// use std::default::Default; /// use mybusinessbusinessinformation1::{MyBusinessBusinessInformation, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/mybusinessbusinessinformation1/src/lib.rs b/gen/mybusinessbusinessinformation1/src/lib.rs index 79454a8a82..498837de29 100644 --- a/gen/mybusinessbusinessinformation1/src/lib.rs +++ b/gen/mybusinessbusinessinformation1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/mybusinessbusinessinformation1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](MyBusinessBusinessInformation) ... +//! Handle the following *Resources* with ease from the central [hub](MyBusinessBusinessInformation) ... //! //! * accounts //! * [*locations create*](api::AccountLocationCreateCall) and [*locations list*](api::AccountLocationListCall) @@ -69,8 +69,8 @@ //! let r = hub.locations().update_attributes(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -99,12 +99,12 @@ //! use std::default::Default; //! use mybusinessbusinessinformation1::{MyBusinessBusinessInformation, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -147,10 +147,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -160,25 +160,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/mybusinesslodging1/README.md b/gen/mybusinesslodging1/README.md index b3c63f6663..8b155ea957 100644 --- a/gen/mybusinesslodging1/README.md +++ b/gen/mybusinesslodging1/README.md @@ -11,7 +11,7 @@ Everything else about the *My Business Lodging* *v1* API can be found at the [official documentation site](https://developers.google.com/my-business/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-mybusinesslodging1/5.0.3+20230124/google_mybusinesslodging1/MyBusinessLodging) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-mybusinesslodging1/5.0.3+20230124/google_mybusinesslodging1/MyBusinessLodging) ... * locations * [*get lodging*](https://docs.rs/google-mybusinesslodging1/5.0.3+20230124/google_mybusinesslodging1/api::LocationGetLodgingCall), [*lodging get google updated*](https://docs.rs/google-mybusinesslodging1/5.0.3+20230124/google_mybusinesslodging1/api::LocationLodgingGetGoogleUpdatedCall) and [*update lodging*](https://docs.rs/google-mybusinesslodging1/5.0.3+20230124/google_mybusinesslodging1/api::LocationUpdateLodgingCall) @@ -51,8 +51,8 @@ let r = hub.locations().get_lodging(...).doit().await let r = hub.locations().update_lodging(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -80,12 +80,12 @@ use mybusinesslodging1::{Result, Error}; use std::default::Default; use mybusinesslodging1::{MyBusinessLodging, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -127,10 +127,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-mybusinesslodging1/5.0.3+20230124/google_mybusinesslodging1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-mybusinesslodging1/5.0.3+20230124/google_mybusinesslodging1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -140,25 +140,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-mybusi You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-mybusinesslodging1/5.0.3+20230124/google_mybusinesslodging1/client::Delegate) to the -[Method Builder](https://docs.rs/google-mybusinesslodging1/5.0.3+20230124/google_mybusinesslodging1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-mybusinesslodging1/5.0.3+20230124/google_mybusinesslodging1/client::Delegate) to the +[Method Builder](https://docs.rs/google-mybusinesslodging1/5.0.3+20230124/google_mybusinesslodging1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-mybusinesslodging1/5.0.3+20230124/google_mybusinesslodging1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-mybusinesslodging1/5.0.3+20230124/google_mybusinesslodging1/client::RequestValue) and -[decodable](https://docs.rs/google-mybusinesslodging1/5.0.3+20230124/google_mybusinesslodging1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-mybusinesslodging1/5.0.3+20230124/google_mybusinesslodging1/client::RequestValue) and +[decodable](https://docs.rs/google-mybusinesslodging1/5.0.3+20230124/google_mybusinesslodging1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-mybusinesslodging1/5.0.3+20230124/google_mybusinesslodging1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-mybusinesslodging1/5.0.3+20230124/google_mybusinesslodging1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -177,7 +177,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **mybusinesslodging1** library was generated by Sebastian Thiel, and is placed +The **mybusinesslodging1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/mybusinesslodging1/src/api.rs b/gen/mybusinesslodging1/src/api.rs index b96ca27bcd..ee93990771 100644 --- a/gen/mybusinesslodging1/src/api.rs +++ b/gen/mybusinesslodging1/src/api.rs @@ -43,12 +43,12 @@ use crate::{client, client::GetToken, client::serde_with}; /// use std::default::Default; /// use mybusinesslodging1::{MyBusinessLodging, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/mybusinesslodging1/src/lib.rs b/gen/mybusinesslodging1/src/lib.rs index 3beea400fd..344390cbdd 100644 --- a/gen/mybusinesslodging1/src/lib.rs +++ b/gen/mybusinesslodging1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/mybusinesslodging1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](MyBusinessLodging) ... +//! Handle the following *Resources* with ease from the central [hub](MyBusinessLodging) ... //! //! * locations //! * [*get lodging*](api::LocationGetLodgingCall), [*lodging get google updated*](api::LocationLodgingGetGoogleUpdatedCall) and [*update lodging*](api::LocationUpdateLodgingCall) @@ -51,8 +51,8 @@ //! let r = hub.locations().update_lodging(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -81,12 +81,12 @@ //! use std::default::Default; //! use mybusinesslodging1::{MyBusinessLodging, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -128,10 +128,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -141,25 +141,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/mybusinessnotifications1/README.md b/gen/mybusinessnotifications1/README.md index a7df1f02be..f7b575a026 100644 --- a/gen/mybusinessnotifications1/README.md +++ b/gen/mybusinessnotifications1/README.md @@ -11,7 +11,7 @@ Everything else about the *My Business Notification Settings* *v1* API can be fo [official documentation site](https://developers.google.com/my-business/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-mybusinessnotifications1/5.0.3+20230124/google_mybusinessnotifications1/MyBusinessNotificationSettings) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-mybusinessnotifications1/5.0.3+20230124/google_mybusinessnotifications1/MyBusinessNotificationSettings) ... * accounts * [*get notification setting*](https://docs.rs/google-mybusinessnotifications1/5.0.3+20230124/google_mybusinessnotifications1/api::AccountGetNotificationSettingCall) and [*update notification setting*](https://docs.rs/google-mybusinessnotifications1/5.0.3+20230124/google_mybusinessnotifications1/api::AccountUpdateNotificationSettingCall) @@ -51,8 +51,8 @@ let r = hub.accounts().get_notification_setting(...).doit().await let r = hub.accounts().update_notification_setting(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -80,12 +80,12 @@ use mybusinessnotifications1::{Result, Error}; use std::default::Default; use mybusinessnotifications1::{MyBusinessNotificationSettings, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -127,10 +127,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-mybusinessnotifications1/5.0.3+20230124/google_mybusinessnotifications1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-mybusinessnotifications1/5.0.3+20230124/google_mybusinessnotifications1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -140,25 +140,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-mybusi You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-mybusinessnotifications1/5.0.3+20230124/google_mybusinessnotifications1/client::Delegate) to the -[Method Builder](https://docs.rs/google-mybusinessnotifications1/5.0.3+20230124/google_mybusinessnotifications1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-mybusinessnotifications1/5.0.3+20230124/google_mybusinessnotifications1/client::Delegate) to the +[Method Builder](https://docs.rs/google-mybusinessnotifications1/5.0.3+20230124/google_mybusinessnotifications1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-mybusinessnotifications1/5.0.3+20230124/google_mybusinessnotifications1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-mybusinessnotifications1/5.0.3+20230124/google_mybusinessnotifications1/client::RequestValue) and -[decodable](https://docs.rs/google-mybusinessnotifications1/5.0.3+20230124/google_mybusinessnotifications1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-mybusinessnotifications1/5.0.3+20230124/google_mybusinessnotifications1/client::RequestValue) and +[decodable](https://docs.rs/google-mybusinessnotifications1/5.0.3+20230124/google_mybusinessnotifications1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-mybusinessnotifications1/5.0.3+20230124/google_mybusinessnotifications1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-mybusinessnotifications1/5.0.3+20230124/google_mybusinessnotifications1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -177,7 +177,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **mybusinessnotifications1** library was generated by Sebastian Thiel, and is placed +The **mybusinessnotifications1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/mybusinessnotifications1/src/api.rs b/gen/mybusinessnotifications1/src/api.rs index 48bbd29119..b2ff8919e6 100644 --- a/gen/mybusinessnotifications1/src/api.rs +++ b/gen/mybusinessnotifications1/src/api.rs @@ -43,12 +43,12 @@ use crate::{client, client::GetToken, client::serde_with}; /// use std::default::Default; /// use mybusinessnotifications1::{MyBusinessNotificationSettings, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/mybusinessnotifications1/src/lib.rs b/gen/mybusinessnotifications1/src/lib.rs index b569836959..9ec8d40f8a 100644 --- a/gen/mybusinessnotifications1/src/lib.rs +++ b/gen/mybusinessnotifications1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/mybusinessnotifications1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](MyBusinessNotificationSettings) ... +//! Handle the following *Resources* with ease from the central [hub](MyBusinessNotificationSettings) ... //! //! * accounts //! * [*get notification setting*](api::AccountGetNotificationSettingCall) and [*update notification setting*](api::AccountUpdateNotificationSettingCall) @@ -51,8 +51,8 @@ //! let r = hub.accounts().update_notification_setting(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -81,12 +81,12 @@ //! use std::default::Default; //! use mybusinessnotifications1::{MyBusinessNotificationSettings, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -128,10 +128,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -141,25 +141,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/mybusinessplaceactions1/README.md b/gen/mybusinessplaceactions1/README.md index f1b8f8831e..beaaa40d26 100644 --- a/gen/mybusinessplaceactions1/README.md +++ b/gen/mybusinessplaceactions1/README.md @@ -11,7 +11,7 @@ Everything else about the *My Business Place Actions* *v1* API can be found at t [official documentation site](https://developers.google.com/my-business/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-mybusinessplaceactions1/5.0.3+20230124/google_mybusinessplaceactions1/MyBusinessPlaceActions) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-mybusinessplaceactions1/5.0.3+20230124/google_mybusinessplaceactions1/MyBusinessPlaceActions) ... * locations * [*place action links create*](https://docs.rs/google-mybusinessplaceactions1/5.0.3+20230124/google_mybusinessplaceactions1/api::LocationPlaceActionLinkCreateCall), [*place action links delete*](https://docs.rs/google-mybusinessplaceactions1/5.0.3+20230124/google_mybusinessplaceactions1/api::LocationPlaceActionLinkDeleteCall), [*place action links get*](https://docs.rs/google-mybusinessplaceactions1/5.0.3+20230124/google_mybusinessplaceactions1/api::LocationPlaceActionLinkGetCall), [*place action links list*](https://docs.rs/google-mybusinessplaceactions1/5.0.3+20230124/google_mybusinessplaceactions1/api::LocationPlaceActionLinkListCall) and [*place action links patch*](https://docs.rs/google-mybusinessplaceactions1/5.0.3+20230124/google_mybusinessplaceactions1/api::LocationPlaceActionLinkPatchCall) @@ -54,8 +54,8 @@ let r = hub.locations().place_action_links_get(...).doit().await let r = hub.locations().place_action_links_patch(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -83,12 +83,12 @@ use mybusinessplaceactions1::{Result, Error}; use std::default::Default; use mybusinessplaceactions1::{MyBusinessPlaceActions, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -130,10 +130,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-mybusinessplaceactions1/5.0.3+20230124/google_mybusinessplaceactions1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-mybusinessplaceactions1/5.0.3+20230124/google_mybusinessplaceactions1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -143,25 +143,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-mybusi You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-mybusinessplaceactions1/5.0.3+20230124/google_mybusinessplaceactions1/client::Delegate) to the -[Method Builder](https://docs.rs/google-mybusinessplaceactions1/5.0.3+20230124/google_mybusinessplaceactions1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-mybusinessplaceactions1/5.0.3+20230124/google_mybusinessplaceactions1/client::Delegate) to the +[Method Builder](https://docs.rs/google-mybusinessplaceactions1/5.0.3+20230124/google_mybusinessplaceactions1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-mybusinessplaceactions1/5.0.3+20230124/google_mybusinessplaceactions1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-mybusinessplaceactions1/5.0.3+20230124/google_mybusinessplaceactions1/client::RequestValue) and -[decodable](https://docs.rs/google-mybusinessplaceactions1/5.0.3+20230124/google_mybusinessplaceactions1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-mybusinessplaceactions1/5.0.3+20230124/google_mybusinessplaceactions1/client::RequestValue) and +[decodable](https://docs.rs/google-mybusinessplaceactions1/5.0.3+20230124/google_mybusinessplaceactions1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-mybusinessplaceactions1/5.0.3+20230124/google_mybusinessplaceactions1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-mybusinessplaceactions1/5.0.3+20230124/google_mybusinessplaceactions1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -180,7 +180,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **mybusinessplaceactions1** library was generated by Sebastian Thiel, and is placed +The **mybusinessplaceactions1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/mybusinessplaceactions1/src/api.rs b/gen/mybusinessplaceactions1/src/api.rs index bc8cf6b3e4..25dc92864b 100644 --- a/gen/mybusinessplaceactions1/src/api.rs +++ b/gen/mybusinessplaceactions1/src/api.rs @@ -43,12 +43,12 @@ use crate::{client, client::GetToken, client::serde_with}; /// use std::default::Default; /// use mybusinessplaceactions1::{MyBusinessPlaceActions, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/mybusinessplaceactions1/src/lib.rs b/gen/mybusinessplaceactions1/src/lib.rs index cb4ac04bcd..bcd99a37a3 100644 --- a/gen/mybusinessplaceactions1/src/lib.rs +++ b/gen/mybusinessplaceactions1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/mybusinessplaceactions1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](MyBusinessPlaceActions) ... +//! Handle the following *Resources* with ease from the central [hub](MyBusinessPlaceActions) ... //! //! * locations //! * [*place action links create*](api::LocationPlaceActionLinkCreateCall), [*place action links delete*](api::LocationPlaceActionLinkDeleteCall), [*place action links get*](api::LocationPlaceActionLinkGetCall), [*place action links list*](api::LocationPlaceActionLinkListCall) and [*place action links patch*](api::LocationPlaceActionLinkPatchCall) @@ -54,8 +54,8 @@ //! let r = hub.locations().place_action_links_patch(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -84,12 +84,12 @@ //! use std::default::Default; //! use mybusinessplaceactions1::{MyBusinessPlaceActions, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -131,10 +131,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -144,25 +144,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/mybusinessverifications1/README.md b/gen/mybusinessverifications1/README.md index c166e62c4e..2877e53dee 100644 --- a/gen/mybusinessverifications1/README.md +++ b/gen/mybusinessverifications1/README.md @@ -11,7 +11,7 @@ Everything else about the *My Business Verifications* *v1* API can be found at t [official documentation site](https://developers.google.com/my-business/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-mybusinessverifications1/5.0.3+20230124/google_mybusinessverifications1/MyBusinessVerifications) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-mybusinessverifications1/5.0.3+20230124/google_mybusinessverifications1/MyBusinessVerifications) ... * [locations](https://docs.rs/google-mybusinessverifications1/5.0.3+20230124/google_mybusinessverifications1/api::Location) * [*fetch verification options*](https://docs.rs/google-mybusinessverifications1/5.0.3+20230124/google_mybusinessverifications1/api::LocationFetchVerificationOptionCall), [*get voice of merchant state*](https://docs.rs/google-mybusinessverifications1/5.0.3+20230124/google_mybusinessverifications1/api::LocationGetVoiceOfMerchantStateCall), [*verifications complete*](https://docs.rs/google-mybusinessverifications1/5.0.3+20230124/google_mybusinessverifications1/api::LocationVerificationCompleteCall), [*verifications list*](https://docs.rs/google-mybusinessverifications1/5.0.3+20230124/google_mybusinessverifications1/api::LocationVerificationListCall) and [*verify*](https://docs.rs/google-mybusinessverifications1/5.0.3+20230124/google_mybusinessverifications1/api::LocationVerifyCall) @@ -56,8 +56,8 @@ let r = hub.locations().get_voice_of_merchant_state(...).doit().await let r = hub.locations().verify(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -84,12 +84,12 @@ use mybusinessverifications1::{Result, Error}; use std::default::Default; use mybusinessverifications1::{MyBusinessVerifications, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -127,10 +127,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-mybusinessverifications1/5.0.3+20230124/google_mybusinessverifications1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-mybusinessverifications1/5.0.3+20230124/google_mybusinessverifications1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -140,25 +140,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-mybusi You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-mybusinessverifications1/5.0.3+20230124/google_mybusinessverifications1/client::Delegate) to the -[Method Builder](https://docs.rs/google-mybusinessverifications1/5.0.3+20230124/google_mybusinessverifications1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-mybusinessverifications1/5.0.3+20230124/google_mybusinessverifications1/client::Delegate) to the +[Method Builder](https://docs.rs/google-mybusinessverifications1/5.0.3+20230124/google_mybusinessverifications1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-mybusinessverifications1/5.0.3+20230124/google_mybusinessverifications1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-mybusinessverifications1/5.0.3+20230124/google_mybusinessverifications1/client::RequestValue) and -[decodable](https://docs.rs/google-mybusinessverifications1/5.0.3+20230124/google_mybusinessverifications1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-mybusinessverifications1/5.0.3+20230124/google_mybusinessverifications1/client::RequestValue) and +[decodable](https://docs.rs/google-mybusinessverifications1/5.0.3+20230124/google_mybusinessverifications1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-mybusinessverifications1/5.0.3+20230124/google_mybusinessverifications1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-mybusinessverifications1/5.0.3+20230124/google_mybusinessverifications1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -177,7 +177,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **mybusinessverifications1** library was generated by Sebastian Thiel, and is placed +The **mybusinessverifications1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/mybusinessverifications1/src/api.rs b/gen/mybusinessverifications1/src/api.rs index 48be91c877..506f1fe00b 100644 --- a/gen/mybusinessverifications1/src/api.rs +++ b/gen/mybusinessverifications1/src/api.rs @@ -42,12 +42,12 @@ use crate::{client, client::GetToken, client::serde_with}; /// use std::default::Default; /// use mybusinessverifications1::{MyBusinessVerifications, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/mybusinessverifications1/src/lib.rs b/gen/mybusinessverifications1/src/lib.rs index 00b9956687..0da6a8247e 100644 --- a/gen/mybusinessverifications1/src/lib.rs +++ b/gen/mybusinessverifications1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/mybusinessverifications1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](MyBusinessVerifications) ... +//! Handle the following *Resources* with ease from the central [hub](MyBusinessVerifications) ... //! //! * [locations](api::Location) //! * [*fetch verification options*](api::LocationFetchVerificationOptionCall), [*get voice of merchant state*](api::LocationGetVoiceOfMerchantStateCall), [*verifications complete*](api::LocationVerificationCompleteCall), [*verifications list*](api::LocationVerificationListCall) and [*verify*](api::LocationVerifyCall) @@ -56,8 +56,8 @@ //! let r = hub.locations().verify(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -85,12 +85,12 @@ //! use std::default::Default; //! use mybusinessverifications1::{MyBusinessVerifications, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -128,10 +128,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -141,25 +141,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/networkconnectivity1/README.md b/gen/networkconnectivity1/README.md index 7c172521cb..bdca3dfd6f 100644 --- a/gen/networkconnectivity1/README.md +++ b/gen/networkconnectivity1/README.md @@ -11,7 +11,7 @@ Everything else about the *networkconnectivity* *v1* API can be found at the [official documentation site](https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/Networkconnectivity) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/Networkconnectivity) ... * projects * [*locations get*](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/api::ProjectLocationGetCall), [*locations global hubs create*](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/api::ProjectLocationGlobalHubCreateCall), [*locations global hubs delete*](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/api::ProjectLocationGlobalHubDeleteCall), [*locations global hubs get*](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/api::ProjectLocationGlobalHubGetCall), [*locations global hubs get iam policy*](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/api::ProjectLocationGlobalHubGetIamPolicyCall), [*locations global hubs list*](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/api::ProjectLocationGlobalHubListCall), [*locations global hubs patch*](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/api::ProjectLocationGlobalHubPatchCall), [*locations global hubs set iam policy*](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/api::ProjectLocationGlobalHubSetIamPolicyCall), [*locations global hubs test iam permissions*](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/api::ProjectLocationGlobalHubTestIamPermissionCall), [*locations global policy based routes get iam policy*](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/api::ProjectLocationGlobalPolicyBasedRouteGetIamPolicyCall), [*locations global policy based routes set iam policy*](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/api::ProjectLocationGlobalPolicyBasedRouteSetIamPolicyCall), [*locations global policy based routes test iam permissions*](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/api::ProjectLocationGlobalPolicyBasedRouteTestIamPermissionCall), [*locations internal ranges create*](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/api::ProjectLocationInternalRangeCreateCall), [*locations internal ranges delete*](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/api::ProjectLocationInternalRangeDeleteCall), [*locations internal ranges get*](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/api::ProjectLocationInternalRangeGetCall), [*locations internal ranges list*](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/api::ProjectLocationInternalRangeListCall), [*locations internal ranges patch*](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/api::ProjectLocationInternalRangePatchCall), [*locations list*](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/api::ProjectLocationListCall), [*locations operations cancel*](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/api::ProjectLocationOperationCancelCall), [*locations operations delete*](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/api::ProjectLocationOperationDeleteCall), [*locations operations get*](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/api::ProjectLocationOperationGetCall), [*locations operations list*](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/api::ProjectLocationOperationListCall), [*locations service classes get iam policy*](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/api::ProjectLocationServiceClassGetIamPolicyCall), [*locations service classes set iam policy*](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/api::ProjectLocationServiceClassSetIamPolicyCall), [*locations service classes test iam permissions*](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/api::ProjectLocationServiceClassTestIamPermissionCall), [*locations service connection maps get iam policy*](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/api::ProjectLocationServiceConnectionMapGetIamPolicyCall), [*locations service connection maps set iam policy*](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/api::ProjectLocationServiceConnectionMapSetIamPolicyCall), [*locations service connection maps test iam permissions*](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/api::ProjectLocationServiceConnectionMapTestIamPermissionCall), [*locations service connection policies get iam policy*](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/api::ProjectLocationServiceConnectionPolicyGetIamPolicyCall), [*locations service connection policies set iam policy*](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/api::ProjectLocationServiceConnectionPolicySetIamPolicyCall), [*locations service connection policies test iam permissions*](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/api::ProjectLocationServiceConnectionPolicyTestIamPermissionCall), [*locations spokes create*](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/api::ProjectLocationSpokeCreateCall), [*locations spokes delete*](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/api::ProjectLocationSpokeDeleteCall), [*locations spokes get*](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/api::ProjectLocationSpokeGetCall), [*locations spokes get iam policy*](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/api::ProjectLocationSpokeGetIamPolicyCall), [*locations spokes list*](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/api::ProjectLocationSpokeListCall), [*locations spokes patch*](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/api::ProjectLocationSpokePatchCall), [*locations spokes set iam policy*](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/api::ProjectLocationSpokeSetIamPolicyCall) and [*locations spokes test iam permissions*](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/api::ProjectLocationSpokeTestIamPermissionCall) @@ -61,8 +61,8 @@ let r = hub.projects().locations_spokes_get_iam_policy(...).doit().await let r = hub.projects().locations_spokes_set_iam_policy(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -89,12 +89,12 @@ use networkconnectivity1::{Result, Error}; use std::default::Default; use networkconnectivity1::{Networkconnectivity, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -131,10 +131,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -144,25 +144,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-networ You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/client::Delegate) to the -[Method Builder](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/client::Delegate) to the +[Method Builder](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/client::RequestValue) and -[decodable](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/client::RequestValue) and +[decodable](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-networkconnectivity1/5.0.3+20230105/google_networkconnectivity1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -181,7 +181,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **networkconnectivity1** library was generated by Sebastian Thiel, and is placed +The **networkconnectivity1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/networkconnectivity1/src/api.rs b/gen/networkconnectivity1/src/api.rs index 05736ae377..19edcf5272 100644 --- a/gen/networkconnectivity1/src/api.rs +++ b/gen/networkconnectivity1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use networkconnectivity1::{Networkconnectivity, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/networkconnectivity1/src/lib.rs b/gen/networkconnectivity1/src/lib.rs index ee75c227d4..ea77f74400 100644 --- a/gen/networkconnectivity1/src/lib.rs +++ b/gen/networkconnectivity1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/networkconnectivity1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Networkconnectivity) ... +//! Handle the following *Resources* with ease from the central [hub](Networkconnectivity) ... //! //! * projects //! * [*locations get*](api::ProjectLocationGetCall), [*locations global hubs create*](api::ProjectLocationGlobalHubCreateCall), [*locations global hubs delete*](api::ProjectLocationGlobalHubDeleteCall), [*locations global hubs get*](api::ProjectLocationGlobalHubGetCall), [*locations global hubs get iam policy*](api::ProjectLocationGlobalHubGetIamPolicyCall), [*locations global hubs list*](api::ProjectLocationGlobalHubListCall), [*locations global hubs patch*](api::ProjectLocationGlobalHubPatchCall), [*locations global hubs set iam policy*](api::ProjectLocationGlobalHubSetIamPolicyCall), [*locations global hubs test iam permissions*](api::ProjectLocationGlobalHubTestIamPermissionCall), [*locations global policy based routes get iam policy*](api::ProjectLocationGlobalPolicyBasedRouteGetIamPolicyCall), [*locations global policy based routes set iam policy*](api::ProjectLocationGlobalPolicyBasedRouteSetIamPolicyCall), [*locations global policy based routes test iam permissions*](api::ProjectLocationGlobalPolicyBasedRouteTestIamPermissionCall), [*locations internal ranges create*](api::ProjectLocationInternalRangeCreateCall), [*locations internal ranges delete*](api::ProjectLocationInternalRangeDeleteCall), [*locations internal ranges get*](api::ProjectLocationInternalRangeGetCall), [*locations internal ranges list*](api::ProjectLocationInternalRangeListCall), [*locations internal ranges patch*](api::ProjectLocationInternalRangePatchCall), [*locations list*](api::ProjectLocationListCall), [*locations operations cancel*](api::ProjectLocationOperationCancelCall), [*locations operations delete*](api::ProjectLocationOperationDeleteCall), [*locations operations get*](api::ProjectLocationOperationGetCall), [*locations operations list*](api::ProjectLocationOperationListCall), [*locations service classes get iam policy*](api::ProjectLocationServiceClassGetIamPolicyCall), [*locations service classes set iam policy*](api::ProjectLocationServiceClassSetIamPolicyCall), [*locations service classes test iam permissions*](api::ProjectLocationServiceClassTestIamPermissionCall), [*locations service connection maps get iam policy*](api::ProjectLocationServiceConnectionMapGetIamPolicyCall), [*locations service connection maps set iam policy*](api::ProjectLocationServiceConnectionMapSetIamPolicyCall), [*locations service connection maps test iam permissions*](api::ProjectLocationServiceConnectionMapTestIamPermissionCall), [*locations service connection policies get iam policy*](api::ProjectLocationServiceConnectionPolicyGetIamPolicyCall), [*locations service connection policies set iam policy*](api::ProjectLocationServiceConnectionPolicySetIamPolicyCall), [*locations service connection policies test iam permissions*](api::ProjectLocationServiceConnectionPolicyTestIamPermissionCall), [*locations spokes create*](api::ProjectLocationSpokeCreateCall), [*locations spokes delete*](api::ProjectLocationSpokeDeleteCall), [*locations spokes get*](api::ProjectLocationSpokeGetCall), [*locations spokes get iam policy*](api::ProjectLocationSpokeGetIamPolicyCall), [*locations spokes list*](api::ProjectLocationSpokeListCall), [*locations spokes patch*](api::ProjectLocationSpokePatchCall), [*locations spokes set iam policy*](api::ProjectLocationSpokeSetIamPolicyCall) and [*locations spokes test iam permissions*](api::ProjectLocationSpokeTestIamPermissionCall) @@ -61,8 +61,8 @@ //! let r = hub.projects().locations_spokes_set_iam_policy(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -90,12 +90,12 @@ //! use std::default::Default; //! use networkconnectivity1::{Networkconnectivity, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -132,10 +132,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -145,25 +145,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/networkconnectivity1_alpha1/README.md b/gen/networkconnectivity1_alpha1/README.md index ea03535551..33b08b1d68 100644 --- a/gen/networkconnectivity1_alpha1/README.md +++ b/gen/networkconnectivity1_alpha1/README.md @@ -11,7 +11,7 @@ Everything else about the *networkconnectivity* *v1_alpha1* API can be found at [official documentation site](https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-networkconnectivity1_alpha1/5.0.3+20230105/google_networkconnectivity1_alpha1/Networkconnectivity) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-networkconnectivity1_alpha1/5.0.3+20230105/google_networkconnectivity1_alpha1/Networkconnectivity) ... * projects * [*locations get*](https://docs.rs/google-networkconnectivity1_alpha1/5.0.3+20230105/google_networkconnectivity1_alpha1/api::ProjectLocationGetCall), [*locations global hubs create*](https://docs.rs/google-networkconnectivity1_alpha1/5.0.3+20230105/google_networkconnectivity1_alpha1/api::ProjectLocationGlobalHubCreateCall), [*locations global hubs delete*](https://docs.rs/google-networkconnectivity1_alpha1/5.0.3+20230105/google_networkconnectivity1_alpha1/api::ProjectLocationGlobalHubDeleteCall), [*locations global hubs get*](https://docs.rs/google-networkconnectivity1_alpha1/5.0.3+20230105/google_networkconnectivity1_alpha1/api::ProjectLocationGlobalHubGetCall), [*locations global hubs get iam policy*](https://docs.rs/google-networkconnectivity1_alpha1/5.0.3+20230105/google_networkconnectivity1_alpha1/api::ProjectLocationGlobalHubGetIamPolicyCall), [*locations global hubs list*](https://docs.rs/google-networkconnectivity1_alpha1/5.0.3+20230105/google_networkconnectivity1_alpha1/api::ProjectLocationGlobalHubListCall), [*locations global hubs patch*](https://docs.rs/google-networkconnectivity1_alpha1/5.0.3+20230105/google_networkconnectivity1_alpha1/api::ProjectLocationGlobalHubPatchCall), [*locations global hubs set iam policy*](https://docs.rs/google-networkconnectivity1_alpha1/5.0.3+20230105/google_networkconnectivity1_alpha1/api::ProjectLocationGlobalHubSetIamPolicyCall), [*locations global hubs test iam permissions*](https://docs.rs/google-networkconnectivity1_alpha1/5.0.3+20230105/google_networkconnectivity1_alpha1/api::ProjectLocationGlobalHubTestIamPermissionCall), [*locations internal ranges create*](https://docs.rs/google-networkconnectivity1_alpha1/5.0.3+20230105/google_networkconnectivity1_alpha1/api::ProjectLocationInternalRangeCreateCall), [*locations internal ranges delete*](https://docs.rs/google-networkconnectivity1_alpha1/5.0.3+20230105/google_networkconnectivity1_alpha1/api::ProjectLocationInternalRangeDeleteCall), [*locations internal ranges get*](https://docs.rs/google-networkconnectivity1_alpha1/5.0.3+20230105/google_networkconnectivity1_alpha1/api::ProjectLocationInternalRangeGetCall), [*locations internal ranges get iam policy*](https://docs.rs/google-networkconnectivity1_alpha1/5.0.3+20230105/google_networkconnectivity1_alpha1/api::ProjectLocationInternalRangeGetIamPolicyCall), [*locations internal ranges list*](https://docs.rs/google-networkconnectivity1_alpha1/5.0.3+20230105/google_networkconnectivity1_alpha1/api::ProjectLocationInternalRangeListCall), [*locations internal ranges patch*](https://docs.rs/google-networkconnectivity1_alpha1/5.0.3+20230105/google_networkconnectivity1_alpha1/api::ProjectLocationInternalRangePatchCall), [*locations internal ranges set iam policy*](https://docs.rs/google-networkconnectivity1_alpha1/5.0.3+20230105/google_networkconnectivity1_alpha1/api::ProjectLocationInternalRangeSetIamPolicyCall), [*locations internal ranges test iam permissions*](https://docs.rs/google-networkconnectivity1_alpha1/5.0.3+20230105/google_networkconnectivity1_alpha1/api::ProjectLocationInternalRangeTestIamPermissionCall), [*locations list*](https://docs.rs/google-networkconnectivity1_alpha1/5.0.3+20230105/google_networkconnectivity1_alpha1/api::ProjectLocationListCall), [*locations operations cancel*](https://docs.rs/google-networkconnectivity1_alpha1/5.0.3+20230105/google_networkconnectivity1_alpha1/api::ProjectLocationOperationCancelCall), [*locations operations delete*](https://docs.rs/google-networkconnectivity1_alpha1/5.0.3+20230105/google_networkconnectivity1_alpha1/api::ProjectLocationOperationDeleteCall), [*locations operations get*](https://docs.rs/google-networkconnectivity1_alpha1/5.0.3+20230105/google_networkconnectivity1_alpha1/api::ProjectLocationOperationGetCall), [*locations operations list*](https://docs.rs/google-networkconnectivity1_alpha1/5.0.3+20230105/google_networkconnectivity1_alpha1/api::ProjectLocationOperationListCall), [*locations spokes create*](https://docs.rs/google-networkconnectivity1_alpha1/5.0.3+20230105/google_networkconnectivity1_alpha1/api::ProjectLocationSpokeCreateCall), [*locations spokes delete*](https://docs.rs/google-networkconnectivity1_alpha1/5.0.3+20230105/google_networkconnectivity1_alpha1/api::ProjectLocationSpokeDeleteCall), [*locations spokes get*](https://docs.rs/google-networkconnectivity1_alpha1/5.0.3+20230105/google_networkconnectivity1_alpha1/api::ProjectLocationSpokeGetCall), [*locations spokes get iam policy*](https://docs.rs/google-networkconnectivity1_alpha1/5.0.3+20230105/google_networkconnectivity1_alpha1/api::ProjectLocationSpokeGetIamPolicyCall), [*locations spokes list*](https://docs.rs/google-networkconnectivity1_alpha1/5.0.3+20230105/google_networkconnectivity1_alpha1/api::ProjectLocationSpokeListCall), [*locations spokes patch*](https://docs.rs/google-networkconnectivity1_alpha1/5.0.3+20230105/google_networkconnectivity1_alpha1/api::ProjectLocationSpokePatchCall), [*locations spokes set iam policy*](https://docs.rs/google-networkconnectivity1_alpha1/5.0.3+20230105/google_networkconnectivity1_alpha1/api::ProjectLocationSpokeSetIamPolicyCall) and [*locations spokes test iam permissions*](https://docs.rs/google-networkconnectivity1_alpha1/5.0.3+20230105/google_networkconnectivity1_alpha1/api::ProjectLocationSpokeTestIamPermissionCall) @@ -59,8 +59,8 @@ let r = hub.projects().locations_spokes_delete(...).doit().await let r = hub.projects().locations_spokes_patch(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -88,12 +88,12 @@ use networkconnectivity1_alpha1::{Result, Error}; use std::default::Default; use networkconnectivity1_alpha1::{Networkconnectivity, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -136,10 +136,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-networkconnectivity1_alpha1/5.0.3+20230105/google_networkconnectivity1_alpha1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-networkconnectivity1_alpha1/5.0.3+20230105/google_networkconnectivity1_alpha1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -149,25 +149,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-networ You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-networkconnectivity1_alpha1/5.0.3+20230105/google_networkconnectivity1_alpha1/client::Delegate) to the -[Method Builder](https://docs.rs/google-networkconnectivity1_alpha1/5.0.3+20230105/google_networkconnectivity1_alpha1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-networkconnectivity1_alpha1/5.0.3+20230105/google_networkconnectivity1_alpha1/client::Delegate) to the +[Method Builder](https://docs.rs/google-networkconnectivity1_alpha1/5.0.3+20230105/google_networkconnectivity1_alpha1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-networkconnectivity1_alpha1/5.0.3+20230105/google_networkconnectivity1_alpha1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-networkconnectivity1_alpha1/5.0.3+20230105/google_networkconnectivity1_alpha1/client::RequestValue) and -[decodable](https://docs.rs/google-networkconnectivity1_alpha1/5.0.3+20230105/google_networkconnectivity1_alpha1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-networkconnectivity1_alpha1/5.0.3+20230105/google_networkconnectivity1_alpha1/client::RequestValue) and +[decodable](https://docs.rs/google-networkconnectivity1_alpha1/5.0.3+20230105/google_networkconnectivity1_alpha1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-networkconnectivity1_alpha1/5.0.3+20230105/google_networkconnectivity1_alpha1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-networkconnectivity1_alpha1/5.0.3+20230105/google_networkconnectivity1_alpha1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -186,7 +186,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **networkconnectivity1_alpha1** library was generated by Sebastian Thiel, and is placed +The **networkconnectivity1_alpha1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/networkconnectivity1_alpha1/src/api.rs b/gen/networkconnectivity1_alpha1/src/api.rs index 3cfd923051..8671cc1ee9 100644 --- a/gen/networkconnectivity1_alpha1/src/api.rs +++ b/gen/networkconnectivity1_alpha1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use networkconnectivity1_alpha1::{Networkconnectivity, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/networkconnectivity1_alpha1/src/lib.rs b/gen/networkconnectivity1_alpha1/src/lib.rs index 4b3aa7581c..ce1adff1f6 100644 --- a/gen/networkconnectivity1_alpha1/src/lib.rs +++ b/gen/networkconnectivity1_alpha1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/networkconnectivity1_alpha1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Networkconnectivity) ... +//! Handle the following *Resources* with ease from the central [hub](Networkconnectivity) ... //! //! * projects //! * [*locations get*](api::ProjectLocationGetCall), [*locations global hubs create*](api::ProjectLocationGlobalHubCreateCall), [*locations global hubs delete*](api::ProjectLocationGlobalHubDeleteCall), [*locations global hubs get*](api::ProjectLocationGlobalHubGetCall), [*locations global hubs get iam policy*](api::ProjectLocationGlobalHubGetIamPolicyCall), [*locations global hubs list*](api::ProjectLocationGlobalHubListCall), [*locations global hubs patch*](api::ProjectLocationGlobalHubPatchCall), [*locations global hubs set iam policy*](api::ProjectLocationGlobalHubSetIamPolicyCall), [*locations global hubs test iam permissions*](api::ProjectLocationGlobalHubTestIamPermissionCall), [*locations internal ranges create*](api::ProjectLocationInternalRangeCreateCall), [*locations internal ranges delete*](api::ProjectLocationInternalRangeDeleteCall), [*locations internal ranges get*](api::ProjectLocationInternalRangeGetCall), [*locations internal ranges get iam policy*](api::ProjectLocationInternalRangeGetIamPolicyCall), [*locations internal ranges list*](api::ProjectLocationInternalRangeListCall), [*locations internal ranges patch*](api::ProjectLocationInternalRangePatchCall), [*locations internal ranges set iam policy*](api::ProjectLocationInternalRangeSetIamPolicyCall), [*locations internal ranges test iam permissions*](api::ProjectLocationInternalRangeTestIamPermissionCall), [*locations list*](api::ProjectLocationListCall), [*locations operations cancel*](api::ProjectLocationOperationCancelCall), [*locations operations delete*](api::ProjectLocationOperationDeleteCall), [*locations operations get*](api::ProjectLocationOperationGetCall), [*locations operations list*](api::ProjectLocationOperationListCall), [*locations spokes create*](api::ProjectLocationSpokeCreateCall), [*locations spokes delete*](api::ProjectLocationSpokeDeleteCall), [*locations spokes get*](api::ProjectLocationSpokeGetCall), [*locations spokes get iam policy*](api::ProjectLocationSpokeGetIamPolicyCall), [*locations spokes list*](api::ProjectLocationSpokeListCall), [*locations spokes patch*](api::ProjectLocationSpokePatchCall), [*locations spokes set iam policy*](api::ProjectLocationSpokeSetIamPolicyCall) and [*locations spokes test iam permissions*](api::ProjectLocationSpokeTestIamPermissionCall) @@ -59,8 +59,8 @@ //! let r = hub.projects().locations_spokes_patch(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -89,12 +89,12 @@ //! use std::default::Default; //! use networkconnectivity1_alpha1::{Networkconnectivity, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -137,10 +137,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -150,25 +150,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/networkmanagement1/README.md b/gen/networkmanagement1/README.md index 6db20a2932..7fc69bd049 100644 --- a/gen/networkmanagement1/README.md +++ b/gen/networkmanagement1/README.md @@ -11,7 +11,7 @@ Everything else about the *Network Management* *v1* API can be found at the [official documentation site](https://cloud.google.com/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-networkmanagement1/5.0.3+20230105/google_networkmanagement1/NetworkManagement) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-networkmanagement1/5.0.3+20230105/google_networkmanagement1/NetworkManagement) ... * projects * [*locations get*](https://docs.rs/google-networkmanagement1/5.0.3+20230105/google_networkmanagement1/api::ProjectLocationGetCall), [*locations global connectivity tests create*](https://docs.rs/google-networkmanagement1/5.0.3+20230105/google_networkmanagement1/api::ProjectLocationGlobalConnectivityTestCreateCall), [*locations global connectivity tests delete*](https://docs.rs/google-networkmanagement1/5.0.3+20230105/google_networkmanagement1/api::ProjectLocationGlobalConnectivityTestDeleteCall), [*locations global connectivity tests get*](https://docs.rs/google-networkmanagement1/5.0.3+20230105/google_networkmanagement1/api::ProjectLocationGlobalConnectivityTestGetCall), [*locations global connectivity tests get iam policy*](https://docs.rs/google-networkmanagement1/5.0.3+20230105/google_networkmanagement1/api::ProjectLocationGlobalConnectivityTestGetIamPolicyCall), [*locations global connectivity tests list*](https://docs.rs/google-networkmanagement1/5.0.3+20230105/google_networkmanagement1/api::ProjectLocationGlobalConnectivityTestListCall), [*locations global connectivity tests patch*](https://docs.rs/google-networkmanagement1/5.0.3+20230105/google_networkmanagement1/api::ProjectLocationGlobalConnectivityTestPatchCall), [*locations global connectivity tests rerun*](https://docs.rs/google-networkmanagement1/5.0.3+20230105/google_networkmanagement1/api::ProjectLocationGlobalConnectivityTestRerunCall), [*locations global connectivity tests set iam policy*](https://docs.rs/google-networkmanagement1/5.0.3+20230105/google_networkmanagement1/api::ProjectLocationGlobalConnectivityTestSetIamPolicyCall), [*locations global connectivity tests test iam permissions*](https://docs.rs/google-networkmanagement1/5.0.3+20230105/google_networkmanagement1/api::ProjectLocationGlobalConnectivityTestTestIamPermissionCall), [*locations global operations cancel*](https://docs.rs/google-networkmanagement1/5.0.3+20230105/google_networkmanagement1/api::ProjectLocationGlobalOperationCancelCall), [*locations global operations delete*](https://docs.rs/google-networkmanagement1/5.0.3+20230105/google_networkmanagement1/api::ProjectLocationGlobalOperationDeleteCall), [*locations global operations get*](https://docs.rs/google-networkmanagement1/5.0.3+20230105/google_networkmanagement1/api::ProjectLocationGlobalOperationGetCall), [*locations global operations list*](https://docs.rs/google-networkmanagement1/5.0.3+20230105/google_networkmanagement1/api::ProjectLocationGlobalOperationListCall) and [*locations list*](https://docs.rs/google-networkmanagement1/5.0.3+20230105/google_networkmanagement1/api::ProjectLocationListCall) @@ -54,8 +54,8 @@ let r = hub.projects().locations_global_connectivity_tests_rerun(...).doit().awa let r = hub.projects().locations_global_operations_get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -83,12 +83,12 @@ use networkmanagement1::{Result, Error}; use std::default::Default; use networkmanagement1::{NetworkManagement, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -130,10 +130,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-networkmanagement1/5.0.3+20230105/google_networkmanagement1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-networkmanagement1/5.0.3+20230105/google_networkmanagement1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -143,25 +143,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-networ You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-networkmanagement1/5.0.3+20230105/google_networkmanagement1/client::Delegate) to the -[Method Builder](https://docs.rs/google-networkmanagement1/5.0.3+20230105/google_networkmanagement1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-networkmanagement1/5.0.3+20230105/google_networkmanagement1/client::Delegate) to the +[Method Builder](https://docs.rs/google-networkmanagement1/5.0.3+20230105/google_networkmanagement1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-networkmanagement1/5.0.3+20230105/google_networkmanagement1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-networkmanagement1/5.0.3+20230105/google_networkmanagement1/client::RequestValue) and -[decodable](https://docs.rs/google-networkmanagement1/5.0.3+20230105/google_networkmanagement1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-networkmanagement1/5.0.3+20230105/google_networkmanagement1/client::RequestValue) and +[decodable](https://docs.rs/google-networkmanagement1/5.0.3+20230105/google_networkmanagement1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-networkmanagement1/5.0.3+20230105/google_networkmanagement1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-networkmanagement1/5.0.3+20230105/google_networkmanagement1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -180,7 +180,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **networkmanagement1** library was generated by Sebastian Thiel, and is placed +The **networkmanagement1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/networkmanagement1/src/api.rs b/gen/networkmanagement1/src/api.rs index 3a7cebad42..f5e72899c6 100644 --- a/gen/networkmanagement1/src/api.rs +++ b/gen/networkmanagement1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use networkmanagement1::{NetworkManagement, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/networkmanagement1/src/lib.rs b/gen/networkmanagement1/src/lib.rs index e88962ea2f..0149a23b74 100644 --- a/gen/networkmanagement1/src/lib.rs +++ b/gen/networkmanagement1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/networkmanagement1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](NetworkManagement) ... +//! Handle the following *Resources* with ease from the central [hub](NetworkManagement) ... //! //! * projects //! * [*locations get*](api::ProjectLocationGetCall), [*locations global connectivity tests create*](api::ProjectLocationGlobalConnectivityTestCreateCall), [*locations global connectivity tests delete*](api::ProjectLocationGlobalConnectivityTestDeleteCall), [*locations global connectivity tests get*](api::ProjectLocationGlobalConnectivityTestGetCall), [*locations global connectivity tests get iam policy*](api::ProjectLocationGlobalConnectivityTestGetIamPolicyCall), [*locations global connectivity tests list*](api::ProjectLocationGlobalConnectivityTestListCall), [*locations global connectivity tests patch*](api::ProjectLocationGlobalConnectivityTestPatchCall), [*locations global connectivity tests rerun*](api::ProjectLocationGlobalConnectivityTestRerunCall), [*locations global connectivity tests set iam policy*](api::ProjectLocationGlobalConnectivityTestSetIamPolicyCall), [*locations global connectivity tests test iam permissions*](api::ProjectLocationGlobalConnectivityTestTestIamPermissionCall), [*locations global operations cancel*](api::ProjectLocationGlobalOperationCancelCall), [*locations global operations delete*](api::ProjectLocationGlobalOperationDeleteCall), [*locations global operations get*](api::ProjectLocationGlobalOperationGetCall), [*locations global operations list*](api::ProjectLocationGlobalOperationListCall) and [*locations list*](api::ProjectLocationListCall) @@ -54,8 +54,8 @@ //! let r = hub.projects().locations_global_operations_get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -84,12 +84,12 @@ //! use std::default::Default; //! use networkmanagement1::{NetworkManagement, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -131,10 +131,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -144,25 +144,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/networksecurity1/README.md b/gen/networksecurity1/README.md index 51ae7de75d..a1583f8244 100644 --- a/gen/networksecurity1/README.md +++ b/gen/networksecurity1/README.md @@ -11,7 +11,7 @@ Everything else about the *NetworkSecurity* *v1* API can be found at the [official documentation site](https://cloud.google.com/networking). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-networksecurity1/5.0.3+20230106/google_networksecurity1/NetworkSecurity) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-networksecurity1/5.0.3+20230106/google_networksecurity1/NetworkSecurity) ... * projects * [*locations authorization policies create*](https://docs.rs/google-networksecurity1/5.0.3+20230106/google_networksecurity1/api::ProjectLocationAuthorizationPolicyCreateCall), [*locations authorization policies delete*](https://docs.rs/google-networksecurity1/5.0.3+20230106/google_networksecurity1/api::ProjectLocationAuthorizationPolicyDeleteCall), [*locations authorization policies get*](https://docs.rs/google-networksecurity1/5.0.3+20230106/google_networksecurity1/api::ProjectLocationAuthorizationPolicyGetCall), [*locations authorization policies get iam policy*](https://docs.rs/google-networksecurity1/5.0.3+20230106/google_networksecurity1/api::ProjectLocationAuthorizationPolicyGetIamPolicyCall), [*locations authorization policies list*](https://docs.rs/google-networksecurity1/5.0.3+20230106/google_networksecurity1/api::ProjectLocationAuthorizationPolicyListCall), [*locations authorization policies patch*](https://docs.rs/google-networksecurity1/5.0.3+20230106/google_networksecurity1/api::ProjectLocationAuthorizationPolicyPatchCall), [*locations authorization policies set iam policy*](https://docs.rs/google-networksecurity1/5.0.3+20230106/google_networksecurity1/api::ProjectLocationAuthorizationPolicySetIamPolicyCall), [*locations authorization policies test iam permissions*](https://docs.rs/google-networksecurity1/5.0.3+20230106/google_networksecurity1/api::ProjectLocationAuthorizationPolicyTestIamPermissionCall), [*locations client tls policies create*](https://docs.rs/google-networksecurity1/5.0.3+20230106/google_networksecurity1/api::ProjectLocationClientTlsPolicyCreateCall), [*locations client tls policies delete*](https://docs.rs/google-networksecurity1/5.0.3+20230106/google_networksecurity1/api::ProjectLocationClientTlsPolicyDeleteCall), [*locations client tls policies get*](https://docs.rs/google-networksecurity1/5.0.3+20230106/google_networksecurity1/api::ProjectLocationClientTlsPolicyGetCall), [*locations client tls policies get iam policy*](https://docs.rs/google-networksecurity1/5.0.3+20230106/google_networksecurity1/api::ProjectLocationClientTlsPolicyGetIamPolicyCall), [*locations client tls policies list*](https://docs.rs/google-networksecurity1/5.0.3+20230106/google_networksecurity1/api::ProjectLocationClientTlsPolicyListCall), [*locations client tls policies patch*](https://docs.rs/google-networksecurity1/5.0.3+20230106/google_networksecurity1/api::ProjectLocationClientTlsPolicyPatchCall), [*locations client tls policies set iam policy*](https://docs.rs/google-networksecurity1/5.0.3+20230106/google_networksecurity1/api::ProjectLocationClientTlsPolicySetIamPolicyCall), [*locations client tls policies test iam permissions*](https://docs.rs/google-networksecurity1/5.0.3+20230106/google_networksecurity1/api::ProjectLocationClientTlsPolicyTestIamPermissionCall), [*locations get*](https://docs.rs/google-networksecurity1/5.0.3+20230106/google_networksecurity1/api::ProjectLocationGetCall), [*locations list*](https://docs.rs/google-networksecurity1/5.0.3+20230106/google_networksecurity1/api::ProjectLocationListCall), [*locations operations cancel*](https://docs.rs/google-networksecurity1/5.0.3+20230106/google_networksecurity1/api::ProjectLocationOperationCancelCall), [*locations operations delete*](https://docs.rs/google-networksecurity1/5.0.3+20230106/google_networksecurity1/api::ProjectLocationOperationDeleteCall), [*locations operations get*](https://docs.rs/google-networksecurity1/5.0.3+20230106/google_networksecurity1/api::ProjectLocationOperationGetCall), [*locations operations list*](https://docs.rs/google-networksecurity1/5.0.3+20230106/google_networksecurity1/api::ProjectLocationOperationListCall), [*locations server tls policies create*](https://docs.rs/google-networksecurity1/5.0.3+20230106/google_networksecurity1/api::ProjectLocationServerTlsPolicyCreateCall), [*locations server tls policies delete*](https://docs.rs/google-networksecurity1/5.0.3+20230106/google_networksecurity1/api::ProjectLocationServerTlsPolicyDeleteCall), [*locations server tls policies get*](https://docs.rs/google-networksecurity1/5.0.3+20230106/google_networksecurity1/api::ProjectLocationServerTlsPolicyGetCall), [*locations server tls policies get iam policy*](https://docs.rs/google-networksecurity1/5.0.3+20230106/google_networksecurity1/api::ProjectLocationServerTlsPolicyGetIamPolicyCall), [*locations server tls policies list*](https://docs.rs/google-networksecurity1/5.0.3+20230106/google_networksecurity1/api::ProjectLocationServerTlsPolicyListCall), [*locations server tls policies patch*](https://docs.rs/google-networksecurity1/5.0.3+20230106/google_networksecurity1/api::ProjectLocationServerTlsPolicyPatchCall), [*locations server tls policies set iam policy*](https://docs.rs/google-networksecurity1/5.0.3+20230106/google_networksecurity1/api::ProjectLocationServerTlsPolicySetIamPolicyCall) and [*locations server tls policies test iam permissions*](https://docs.rs/google-networksecurity1/5.0.3+20230106/google_networksecurity1/api::ProjectLocationServerTlsPolicyTestIamPermissionCall) @@ -59,8 +59,8 @@ let r = hub.projects().locations_server_tls_policies_delete(...).doit().await let r = hub.projects().locations_server_tls_policies_patch(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -88,12 +88,12 @@ use networksecurity1::{Result, Error}; use std::default::Default; use networksecurity1::{NetworkSecurity, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -135,10 +135,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-networksecurity1/5.0.3+20230106/google_networksecurity1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-networksecurity1/5.0.3+20230106/google_networksecurity1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -148,25 +148,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-networ You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-networksecurity1/5.0.3+20230106/google_networksecurity1/client::Delegate) to the -[Method Builder](https://docs.rs/google-networksecurity1/5.0.3+20230106/google_networksecurity1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-networksecurity1/5.0.3+20230106/google_networksecurity1/client::Delegate) to the +[Method Builder](https://docs.rs/google-networksecurity1/5.0.3+20230106/google_networksecurity1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-networksecurity1/5.0.3+20230106/google_networksecurity1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-networksecurity1/5.0.3+20230106/google_networksecurity1/client::RequestValue) and -[decodable](https://docs.rs/google-networksecurity1/5.0.3+20230106/google_networksecurity1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-networksecurity1/5.0.3+20230106/google_networksecurity1/client::RequestValue) and +[decodable](https://docs.rs/google-networksecurity1/5.0.3+20230106/google_networksecurity1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-networksecurity1/5.0.3+20230106/google_networksecurity1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-networksecurity1/5.0.3+20230106/google_networksecurity1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -185,7 +185,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **networksecurity1** library was generated by Sebastian Thiel, and is placed +The **networksecurity1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/networksecurity1/src/api.rs b/gen/networksecurity1/src/api.rs index 4201df6e91..f908c1ee90 100644 --- a/gen/networksecurity1/src/api.rs +++ b/gen/networksecurity1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use networksecurity1::{NetworkSecurity, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/networksecurity1/src/lib.rs b/gen/networksecurity1/src/lib.rs index e1de332686..0f89885b25 100644 --- a/gen/networksecurity1/src/lib.rs +++ b/gen/networksecurity1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/networksecurity1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](NetworkSecurity) ... +//! Handle the following *Resources* with ease from the central [hub](NetworkSecurity) ... //! //! * projects //! * [*locations authorization policies create*](api::ProjectLocationAuthorizationPolicyCreateCall), [*locations authorization policies delete*](api::ProjectLocationAuthorizationPolicyDeleteCall), [*locations authorization policies get*](api::ProjectLocationAuthorizationPolicyGetCall), [*locations authorization policies get iam policy*](api::ProjectLocationAuthorizationPolicyGetIamPolicyCall), [*locations authorization policies list*](api::ProjectLocationAuthorizationPolicyListCall), [*locations authorization policies patch*](api::ProjectLocationAuthorizationPolicyPatchCall), [*locations authorization policies set iam policy*](api::ProjectLocationAuthorizationPolicySetIamPolicyCall), [*locations authorization policies test iam permissions*](api::ProjectLocationAuthorizationPolicyTestIamPermissionCall), [*locations client tls policies create*](api::ProjectLocationClientTlsPolicyCreateCall), [*locations client tls policies delete*](api::ProjectLocationClientTlsPolicyDeleteCall), [*locations client tls policies get*](api::ProjectLocationClientTlsPolicyGetCall), [*locations client tls policies get iam policy*](api::ProjectLocationClientTlsPolicyGetIamPolicyCall), [*locations client tls policies list*](api::ProjectLocationClientTlsPolicyListCall), [*locations client tls policies patch*](api::ProjectLocationClientTlsPolicyPatchCall), [*locations client tls policies set iam policy*](api::ProjectLocationClientTlsPolicySetIamPolicyCall), [*locations client tls policies test iam permissions*](api::ProjectLocationClientTlsPolicyTestIamPermissionCall), [*locations get*](api::ProjectLocationGetCall), [*locations list*](api::ProjectLocationListCall), [*locations operations cancel*](api::ProjectLocationOperationCancelCall), [*locations operations delete*](api::ProjectLocationOperationDeleteCall), [*locations operations get*](api::ProjectLocationOperationGetCall), [*locations operations list*](api::ProjectLocationOperationListCall), [*locations server tls policies create*](api::ProjectLocationServerTlsPolicyCreateCall), [*locations server tls policies delete*](api::ProjectLocationServerTlsPolicyDeleteCall), [*locations server tls policies get*](api::ProjectLocationServerTlsPolicyGetCall), [*locations server tls policies get iam policy*](api::ProjectLocationServerTlsPolicyGetIamPolicyCall), [*locations server tls policies list*](api::ProjectLocationServerTlsPolicyListCall), [*locations server tls policies patch*](api::ProjectLocationServerTlsPolicyPatchCall), [*locations server tls policies set iam policy*](api::ProjectLocationServerTlsPolicySetIamPolicyCall) and [*locations server tls policies test iam permissions*](api::ProjectLocationServerTlsPolicyTestIamPermissionCall) @@ -59,8 +59,8 @@ //! let r = hub.projects().locations_server_tls_policies_patch(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -89,12 +89,12 @@ //! use std::default::Default; //! use networksecurity1::{NetworkSecurity, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -136,10 +136,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -149,25 +149,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/networkservices1/README.md b/gen/networkservices1/README.md index ec570b7f2e..28b8c1a903 100644 --- a/gen/networkservices1/README.md +++ b/gen/networkservices1/README.md @@ -11,7 +11,7 @@ Everything else about the *NetworkServices* *v1* API can be found at the [official documentation site](https://cloud.google.com/networking). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/NetworkServices) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/NetworkServices) ... * projects * [*locations edge cache keysets get iam policy*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationEdgeCacheKeysetGetIamPolicyCall), [*locations edge cache keysets set iam policy*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationEdgeCacheKeysetSetIamPolicyCall), [*locations edge cache keysets test iam permissions*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationEdgeCacheKeysetTestIamPermissionCall), [*locations edge cache origins get iam policy*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationEdgeCacheOriginGetIamPolicyCall), [*locations edge cache origins set iam policy*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationEdgeCacheOriginSetIamPolicyCall), [*locations edge cache origins test iam permissions*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationEdgeCacheOriginTestIamPermissionCall), [*locations edge cache services get iam policy*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationEdgeCacheServiceGetIamPolicyCall), [*locations edge cache services set iam policy*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationEdgeCacheServiceSetIamPolicyCall), [*locations edge cache services test iam permissions*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationEdgeCacheServiceTestIamPermissionCall), [*locations endpoint policies create*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationEndpointPolicyCreateCall), [*locations endpoint policies delete*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationEndpointPolicyDeleteCall), [*locations endpoint policies get*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationEndpointPolicyGetCall), [*locations endpoint policies get iam policy*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationEndpointPolicyGetIamPolicyCall), [*locations endpoint policies list*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationEndpointPolicyListCall), [*locations endpoint policies patch*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationEndpointPolicyPatchCall), [*locations endpoint policies set iam policy*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationEndpointPolicySetIamPolicyCall), [*locations endpoint policies test iam permissions*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationEndpointPolicyTestIamPermissionCall), [*locations gateways create*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationGatewayCreateCall), [*locations gateways delete*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationGatewayDeleteCall), [*locations gateways get*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationGatewayGetCall), [*locations gateways get iam policy*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationGatewayGetIamPolicyCall), [*locations gateways list*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationGatewayListCall), [*locations gateways patch*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationGatewayPatchCall), [*locations gateways set iam policy*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationGatewaySetIamPolicyCall), [*locations gateways test iam permissions*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationGatewayTestIamPermissionCall), [*locations get*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationGetCall), [*locations grpc routes create*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationGrpcRouteCreateCall), [*locations grpc routes delete*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationGrpcRouteDeleteCall), [*locations grpc routes get*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationGrpcRouteGetCall), [*locations grpc routes list*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationGrpcRouteListCall), [*locations grpc routes patch*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationGrpcRoutePatchCall), [*locations http routes create*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationHttpRouteCreateCall), [*locations http routes delete*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationHttpRouteDeleteCall), [*locations http routes get*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationHttpRouteGetCall), [*locations http routes list*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationHttpRouteListCall), [*locations http routes patch*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationHttpRoutePatchCall), [*locations list*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationListCall), [*locations meshes create*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationMeshCreateCall), [*locations meshes delete*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationMeshDeleteCall), [*locations meshes get*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationMeshGetCall), [*locations meshes get iam policy*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationMeshGetIamPolicyCall), [*locations meshes list*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationMeshListCall), [*locations meshes patch*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationMeshPatchCall), [*locations meshes set iam policy*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationMeshSetIamPolicyCall), [*locations meshes test iam permissions*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationMeshTestIamPermissionCall), [*locations operations cancel*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationOperationCancelCall), [*locations operations delete*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationOperationDeleteCall), [*locations operations get*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationOperationGetCall), [*locations operations list*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationOperationListCall), [*locations service bindings create*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationServiceBindingCreateCall), [*locations service bindings delete*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationServiceBindingDeleteCall), [*locations service bindings get*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationServiceBindingGetCall), [*locations service bindings get iam policy*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationServiceBindingGetIamPolicyCall), [*locations service bindings list*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationServiceBindingListCall), [*locations service bindings set iam policy*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationServiceBindingSetIamPolicyCall), [*locations service bindings test iam permissions*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationServiceBindingTestIamPermissionCall), [*locations tcp routes create*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationTcpRouteCreateCall), [*locations tcp routes delete*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationTcpRouteDeleteCall), [*locations tcp routes get*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationTcpRouteGetCall), [*locations tcp routes list*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationTcpRouteListCall), [*locations tcp routes patch*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationTcpRoutePatchCall), [*locations tls routes create*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationTlsRouteCreateCall), [*locations tls routes delete*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationTlsRouteDeleteCall), [*locations tls routes get*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationTlsRouteGetCall), [*locations tls routes list*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationTlsRouteListCall) and [*locations tls routes patch*](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/api::ProjectLocationTlsRoutePatchCall) @@ -73,8 +73,8 @@ let r = hub.projects().locations_tls_routes_delete(...).doit().await let r = hub.projects().locations_tls_routes_patch(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -102,12 +102,12 @@ use networkservices1::{Result, Error}; use std::default::Default; use networkservices1::{NetworkServices, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -149,10 +149,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -162,25 +162,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-networ You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/client::Delegate) to the -[Method Builder](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/client::Delegate) to the +[Method Builder](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/client::RequestValue) and -[decodable](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/client::RequestValue) and +[decodable](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-networkservices1/5.0.3+20230105/google_networkservices1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -199,7 +199,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **networkservices1** library was generated by Sebastian Thiel, and is placed +The **networkservices1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/networkservices1/src/api.rs b/gen/networkservices1/src/api.rs index d93f099f6e..4258a03e22 100644 --- a/gen/networkservices1/src/api.rs +++ b/gen/networkservices1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use networkservices1::{NetworkServices, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/networkservices1/src/lib.rs b/gen/networkservices1/src/lib.rs index 75e7f85fed..11e2c6ec20 100644 --- a/gen/networkservices1/src/lib.rs +++ b/gen/networkservices1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/networkservices1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](NetworkServices) ... +//! Handle the following *Resources* with ease from the central [hub](NetworkServices) ... //! //! * projects //! * [*locations edge cache keysets get iam policy*](api::ProjectLocationEdgeCacheKeysetGetIamPolicyCall), [*locations edge cache keysets set iam policy*](api::ProjectLocationEdgeCacheKeysetSetIamPolicyCall), [*locations edge cache keysets test iam permissions*](api::ProjectLocationEdgeCacheKeysetTestIamPermissionCall), [*locations edge cache origins get iam policy*](api::ProjectLocationEdgeCacheOriginGetIamPolicyCall), [*locations edge cache origins set iam policy*](api::ProjectLocationEdgeCacheOriginSetIamPolicyCall), [*locations edge cache origins test iam permissions*](api::ProjectLocationEdgeCacheOriginTestIamPermissionCall), [*locations edge cache services get iam policy*](api::ProjectLocationEdgeCacheServiceGetIamPolicyCall), [*locations edge cache services set iam policy*](api::ProjectLocationEdgeCacheServiceSetIamPolicyCall), [*locations edge cache services test iam permissions*](api::ProjectLocationEdgeCacheServiceTestIamPermissionCall), [*locations endpoint policies create*](api::ProjectLocationEndpointPolicyCreateCall), [*locations endpoint policies delete*](api::ProjectLocationEndpointPolicyDeleteCall), [*locations endpoint policies get*](api::ProjectLocationEndpointPolicyGetCall), [*locations endpoint policies get iam policy*](api::ProjectLocationEndpointPolicyGetIamPolicyCall), [*locations endpoint policies list*](api::ProjectLocationEndpointPolicyListCall), [*locations endpoint policies patch*](api::ProjectLocationEndpointPolicyPatchCall), [*locations endpoint policies set iam policy*](api::ProjectLocationEndpointPolicySetIamPolicyCall), [*locations endpoint policies test iam permissions*](api::ProjectLocationEndpointPolicyTestIamPermissionCall), [*locations gateways create*](api::ProjectLocationGatewayCreateCall), [*locations gateways delete*](api::ProjectLocationGatewayDeleteCall), [*locations gateways get*](api::ProjectLocationGatewayGetCall), [*locations gateways get iam policy*](api::ProjectLocationGatewayGetIamPolicyCall), [*locations gateways list*](api::ProjectLocationGatewayListCall), [*locations gateways patch*](api::ProjectLocationGatewayPatchCall), [*locations gateways set iam policy*](api::ProjectLocationGatewaySetIamPolicyCall), [*locations gateways test iam permissions*](api::ProjectLocationGatewayTestIamPermissionCall), [*locations get*](api::ProjectLocationGetCall), [*locations grpc routes create*](api::ProjectLocationGrpcRouteCreateCall), [*locations grpc routes delete*](api::ProjectLocationGrpcRouteDeleteCall), [*locations grpc routes get*](api::ProjectLocationGrpcRouteGetCall), [*locations grpc routes list*](api::ProjectLocationGrpcRouteListCall), [*locations grpc routes patch*](api::ProjectLocationGrpcRoutePatchCall), [*locations http routes create*](api::ProjectLocationHttpRouteCreateCall), [*locations http routes delete*](api::ProjectLocationHttpRouteDeleteCall), [*locations http routes get*](api::ProjectLocationHttpRouteGetCall), [*locations http routes list*](api::ProjectLocationHttpRouteListCall), [*locations http routes patch*](api::ProjectLocationHttpRoutePatchCall), [*locations list*](api::ProjectLocationListCall), [*locations meshes create*](api::ProjectLocationMeshCreateCall), [*locations meshes delete*](api::ProjectLocationMeshDeleteCall), [*locations meshes get*](api::ProjectLocationMeshGetCall), [*locations meshes get iam policy*](api::ProjectLocationMeshGetIamPolicyCall), [*locations meshes list*](api::ProjectLocationMeshListCall), [*locations meshes patch*](api::ProjectLocationMeshPatchCall), [*locations meshes set iam policy*](api::ProjectLocationMeshSetIamPolicyCall), [*locations meshes test iam permissions*](api::ProjectLocationMeshTestIamPermissionCall), [*locations operations cancel*](api::ProjectLocationOperationCancelCall), [*locations operations delete*](api::ProjectLocationOperationDeleteCall), [*locations operations get*](api::ProjectLocationOperationGetCall), [*locations operations list*](api::ProjectLocationOperationListCall), [*locations service bindings create*](api::ProjectLocationServiceBindingCreateCall), [*locations service bindings delete*](api::ProjectLocationServiceBindingDeleteCall), [*locations service bindings get*](api::ProjectLocationServiceBindingGetCall), [*locations service bindings get iam policy*](api::ProjectLocationServiceBindingGetIamPolicyCall), [*locations service bindings list*](api::ProjectLocationServiceBindingListCall), [*locations service bindings set iam policy*](api::ProjectLocationServiceBindingSetIamPolicyCall), [*locations service bindings test iam permissions*](api::ProjectLocationServiceBindingTestIamPermissionCall), [*locations tcp routes create*](api::ProjectLocationTcpRouteCreateCall), [*locations tcp routes delete*](api::ProjectLocationTcpRouteDeleteCall), [*locations tcp routes get*](api::ProjectLocationTcpRouteGetCall), [*locations tcp routes list*](api::ProjectLocationTcpRouteListCall), [*locations tcp routes patch*](api::ProjectLocationTcpRoutePatchCall), [*locations tls routes create*](api::ProjectLocationTlsRouteCreateCall), [*locations tls routes delete*](api::ProjectLocationTlsRouteDeleteCall), [*locations tls routes get*](api::ProjectLocationTlsRouteGetCall), [*locations tls routes list*](api::ProjectLocationTlsRouteListCall) and [*locations tls routes patch*](api::ProjectLocationTlsRoutePatchCall) @@ -73,8 +73,8 @@ //! let r = hub.projects().locations_tls_routes_patch(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -103,12 +103,12 @@ //! use std::default::Default; //! use networkservices1::{NetworkServices, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -150,10 +150,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -163,25 +163,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/notebooks1/README.md b/gen/notebooks1/README.md index b31f0ca770..87cba44ddd 100644 --- a/gen/notebooks1/README.md +++ b/gen/notebooks1/README.md @@ -11,7 +11,7 @@ Everything else about the *AI Platform Notebooks* *v1* API can be found at the [official documentation site](https://cloud.google.com/notebooks/docs/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/AIPlatformNotebooks) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/AIPlatformNotebooks) ... * projects * [*locations environments create*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationEnvironmentCreateCall), [*locations environments delete*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationEnvironmentDeleteCall), [*locations environments get*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationEnvironmentGetCall), [*locations environments list*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationEnvironmentListCall), [*locations executions create*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationExecutionCreateCall), [*locations executions delete*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationExecutionDeleteCall), [*locations executions get*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationExecutionGetCall), [*locations executions list*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationExecutionListCall), [*locations get*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationGetCall), [*locations instances create*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationInstanceCreateCall), [*locations instances delete*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationInstanceDeleteCall), [*locations instances diagnose*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationInstanceDiagnoseCall), [*locations instances get*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationInstanceGetCall), [*locations instances get iam policy*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationInstanceGetIamPolicyCall), [*locations instances get instance health*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationInstanceGetInstanceHealthCall), [*locations instances is upgradeable*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationInstanceIsUpgradeableCall), [*locations instances list*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationInstanceListCall), [*locations instances register*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationInstanceRegisterCall), [*locations instances report*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationInstanceReportCall), [*locations instances reset*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationInstanceResetCall), [*locations instances rollback*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationInstanceRollbackCall), [*locations instances set accelerator*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationInstanceSetAcceleratorCall), [*locations instances set iam policy*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationInstanceSetIamPolicyCall), [*locations instances set labels*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationInstanceSetLabelCall), [*locations instances set machine type*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationInstanceSetMachineTypeCall), [*locations instances start*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationInstanceStartCall), [*locations instances stop*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationInstanceStopCall), [*locations instances test iam permissions*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationInstanceTestIamPermissionCall), [*locations instances update config*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationInstanceUpdateConfigCall), [*locations instances update metadata items*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationInstanceUpdateMetadataItemCall), [*locations instances update shielded instance config*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationInstanceUpdateShieldedInstanceConfigCall), [*locations instances upgrade*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationInstanceUpgradeCall), [*locations instances upgrade internal*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationInstanceUpgradeInternalCall), [*locations list*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationListCall), [*locations operations cancel*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationOperationCancelCall), [*locations operations delete*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationOperationDeleteCall), [*locations operations get*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationOperationGetCall), [*locations operations list*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationOperationListCall), [*locations runtimes create*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationRuntimeCreateCall), [*locations runtimes delete*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationRuntimeDeleteCall), [*locations runtimes diagnose*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationRuntimeDiagnoseCall), [*locations runtimes get*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationRuntimeGetCall), [*locations runtimes get iam policy*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationRuntimeGetIamPolicyCall), [*locations runtimes list*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationRuntimeListCall), [*locations runtimes patch*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationRuntimePatchCall), [*locations runtimes refresh runtime token internal*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationRuntimeRefreshRuntimeTokenInternalCall), [*locations runtimes report event*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationRuntimeReportEventCall), [*locations runtimes reset*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationRuntimeResetCall), [*locations runtimes set iam policy*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationRuntimeSetIamPolicyCall), [*locations runtimes start*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationRuntimeStartCall), [*locations runtimes stop*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationRuntimeStopCall), [*locations runtimes switch*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationRuntimeSwitchCall), [*locations runtimes test iam permissions*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationRuntimeTestIamPermissionCall), [*locations runtimes upgrade*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationRuntimeUpgradeCall), [*locations schedules create*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationScheduleCreateCall), [*locations schedules delete*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationScheduleDeleteCall), [*locations schedules get*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationScheduleGetCall), [*locations schedules list*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationScheduleListCall) and [*locations schedules trigger*](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/api::ProjectLocationScheduleTriggerCall) @@ -83,8 +83,8 @@ let r = hub.projects().locations_schedules_delete(...).doit().await let r = hub.projects().locations_schedules_trigger(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -112,12 +112,12 @@ use notebooks1::{Result, Error}; use std::default::Default; use notebooks1::{AIPlatformNotebooks, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -160,10 +160,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -173,25 +173,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-notebo You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/client::Delegate) to the -[Method Builder](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/client::Delegate) to the +[Method Builder](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/client::RequestValue) and -[decodable](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/client::RequestValue) and +[decodable](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-notebooks1/5.0.3+20221213/google_notebooks1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -210,7 +210,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **notebooks1** library was generated by Sebastian Thiel, and is placed +The **notebooks1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/notebooks1/src/api.rs b/gen/notebooks1/src/api.rs index 74cbc4af10..f8e5cf07e6 100644 --- a/gen/notebooks1/src/api.rs +++ b/gen/notebooks1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use notebooks1::{AIPlatformNotebooks, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/notebooks1/src/lib.rs b/gen/notebooks1/src/lib.rs index 5f12627ecd..469343cafd 100644 --- a/gen/notebooks1/src/lib.rs +++ b/gen/notebooks1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/notebooks1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](AIPlatformNotebooks) ... +//! Handle the following *Resources* with ease from the central [hub](AIPlatformNotebooks) ... //! //! * projects //! * [*locations environments create*](api::ProjectLocationEnvironmentCreateCall), [*locations environments delete*](api::ProjectLocationEnvironmentDeleteCall), [*locations environments get*](api::ProjectLocationEnvironmentGetCall), [*locations environments list*](api::ProjectLocationEnvironmentListCall), [*locations executions create*](api::ProjectLocationExecutionCreateCall), [*locations executions delete*](api::ProjectLocationExecutionDeleteCall), [*locations executions get*](api::ProjectLocationExecutionGetCall), [*locations executions list*](api::ProjectLocationExecutionListCall), [*locations get*](api::ProjectLocationGetCall), [*locations instances create*](api::ProjectLocationInstanceCreateCall), [*locations instances delete*](api::ProjectLocationInstanceDeleteCall), [*locations instances diagnose*](api::ProjectLocationInstanceDiagnoseCall), [*locations instances get*](api::ProjectLocationInstanceGetCall), [*locations instances get iam policy*](api::ProjectLocationInstanceGetIamPolicyCall), [*locations instances get instance health*](api::ProjectLocationInstanceGetInstanceHealthCall), [*locations instances is upgradeable*](api::ProjectLocationInstanceIsUpgradeableCall), [*locations instances list*](api::ProjectLocationInstanceListCall), [*locations instances register*](api::ProjectLocationInstanceRegisterCall), [*locations instances report*](api::ProjectLocationInstanceReportCall), [*locations instances reset*](api::ProjectLocationInstanceResetCall), [*locations instances rollback*](api::ProjectLocationInstanceRollbackCall), [*locations instances set accelerator*](api::ProjectLocationInstanceSetAcceleratorCall), [*locations instances set iam policy*](api::ProjectLocationInstanceSetIamPolicyCall), [*locations instances set labels*](api::ProjectLocationInstanceSetLabelCall), [*locations instances set machine type*](api::ProjectLocationInstanceSetMachineTypeCall), [*locations instances start*](api::ProjectLocationInstanceStartCall), [*locations instances stop*](api::ProjectLocationInstanceStopCall), [*locations instances test iam permissions*](api::ProjectLocationInstanceTestIamPermissionCall), [*locations instances update config*](api::ProjectLocationInstanceUpdateConfigCall), [*locations instances update metadata items*](api::ProjectLocationInstanceUpdateMetadataItemCall), [*locations instances update shielded instance config*](api::ProjectLocationInstanceUpdateShieldedInstanceConfigCall), [*locations instances upgrade*](api::ProjectLocationInstanceUpgradeCall), [*locations instances upgrade internal*](api::ProjectLocationInstanceUpgradeInternalCall), [*locations list*](api::ProjectLocationListCall), [*locations operations cancel*](api::ProjectLocationOperationCancelCall), [*locations operations delete*](api::ProjectLocationOperationDeleteCall), [*locations operations get*](api::ProjectLocationOperationGetCall), [*locations operations list*](api::ProjectLocationOperationListCall), [*locations runtimes create*](api::ProjectLocationRuntimeCreateCall), [*locations runtimes delete*](api::ProjectLocationRuntimeDeleteCall), [*locations runtimes diagnose*](api::ProjectLocationRuntimeDiagnoseCall), [*locations runtimes get*](api::ProjectLocationRuntimeGetCall), [*locations runtimes get iam policy*](api::ProjectLocationRuntimeGetIamPolicyCall), [*locations runtimes list*](api::ProjectLocationRuntimeListCall), [*locations runtimes patch*](api::ProjectLocationRuntimePatchCall), [*locations runtimes refresh runtime token internal*](api::ProjectLocationRuntimeRefreshRuntimeTokenInternalCall), [*locations runtimes report event*](api::ProjectLocationRuntimeReportEventCall), [*locations runtimes reset*](api::ProjectLocationRuntimeResetCall), [*locations runtimes set iam policy*](api::ProjectLocationRuntimeSetIamPolicyCall), [*locations runtimes start*](api::ProjectLocationRuntimeStartCall), [*locations runtimes stop*](api::ProjectLocationRuntimeStopCall), [*locations runtimes switch*](api::ProjectLocationRuntimeSwitchCall), [*locations runtimes test iam permissions*](api::ProjectLocationRuntimeTestIamPermissionCall), [*locations runtimes upgrade*](api::ProjectLocationRuntimeUpgradeCall), [*locations schedules create*](api::ProjectLocationScheduleCreateCall), [*locations schedules delete*](api::ProjectLocationScheduleDeleteCall), [*locations schedules get*](api::ProjectLocationScheduleGetCall), [*locations schedules list*](api::ProjectLocationScheduleListCall) and [*locations schedules trigger*](api::ProjectLocationScheduleTriggerCall) @@ -83,8 +83,8 @@ //! let r = hub.projects().locations_schedules_trigger(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -113,12 +113,12 @@ //! use std::default::Default; //! use notebooks1::{AIPlatformNotebooks, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -161,10 +161,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -174,25 +174,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/ondemandscanning1/README.md b/gen/ondemandscanning1/README.md index 90dfb55524..034bf5afc3 100644 --- a/gen/ondemandscanning1/README.md +++ b/gen/ondemandscanning1/README.md @@ -11,7 +11,7 @@ Everything else about the *On-Demand Scanning* *v1* API can be found at the [official documentation site](https://cloud.google.com/container-analysis/docs/on-demand-scanning/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-ondemandscanning1/5.0.3+20230109/google_ondemandscanning1/OnDemandScanning) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-ondemandscanning1/5.0.3+20230109/google_ondemandscanning1/OnDemandScanning) ... * projects * [*locations operations cancel*](https://docs.rs/google-ondemandscanning1/5.0.3+20230109/google_ondemandscanning1/api::ProjectLocationOperationCancelCall), [*locations operations delete*](https://docs.rs/google-ondemandscanning1/5.0.3+20230109/google_ondemandscanning1/api::ProjectLocationOperationDeleteCall), [*locations operations get*](https://docs.rs/google-ondemandscanning1/5.0.3+20230109/google_ondemandscanning1/api::ProjectLocationOperationGetCall), [*locations operations list*](https://docs.rs/google-ondemandscanning1/5.0.3+20230109/google_ondemandscanning1/api::ProjectLocationOperationListCall), [*locations operations wait*](https://docs.rs/google-ondemandscanning1/5.0.3+20230109/google_ondemandscanning1/api::ProjectLocationOperationWaitCall), [*locations scans analyze packages*](https://docs.rs/google-ondemandscanning1/5.0.3+20230109/google_ondemandscanning1/api::ProjectLocationScanAnalyzePackageCall) and [*locations scans vulnerabilities list*](https://docs.rs/google-ondemandscanning1/5.0.3+20230109/google_ondemandscanning1/api::ProjectLocationScanVulnerabilityListCall) @@ -52,8 +52,8 @@ let r = hub.projects().locations_operations_wait(...).doit().await let r = hub.projects().locations_scans_analyze_packages(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -80,12 +80,12 @@ use ondemandscanning1::{Result, Error}; use std::default::Default; use ondemandscanning1::{OnDemandScanning, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -122,10 +122,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-ondemandscanning1/5.0.3+20230109/google_ondemandscanning1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-ondemandscanning1/5.0.3+20230109/google_ondemandscanning1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -135,25 +135,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-ondema You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-ondemandscanning1/5.0.3+20230109/google_ondemandscanning1/client::Delegate) to the -[Method Builder](https://docs.rs/google-ondemandscanning1/5.0.3+20230109/google_ondemandscanning1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-ondemandscanning1/5.0.3+20230109/google_ondemandscanning1/client::Delegate) to the +[Method Builder](https://docs.rs/google-ondemandscanning1/5.0.3+20230109/google_ondemandscanning1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-ondemandscanning1/5.0.3+20230109/google_ondemandscanning1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-ondemandscanning1/5.0.3+20230109/google_ondemandscanning1/client::RequestValue) and -[decodable](https://docs.rs/google-ondemandscanning1/5.0.3+20230109/google_ondemandscanning1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-ondemandscanning1/5.0.3+20230109/google_ondemandscanning1/client::RequestValue) and +[decodable](https://docs.rs/google-ondemandscanning1/5.0.3+20230109/google_ondemandscanning1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-ondemandscanning1/5.0.3+20230109/google_ondemandscanning1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-ondemandscanning1/5.0.3+20230109/google_ondemandscanning1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -172,7 +172,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **ondemandscanning1** library was generated by Sebastian Thiel, and is placed +The **ondemandscanning1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/ondemandscanning1/src/api.rs b/gen/ondemandscanning1/src/api.rs index 63489057dc..e4ddc35502 100644 --- a/gen/ondemandscanning1/src/api.rs +++ b/gen/ondemandscanning1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use ondemandscanning1::{OnDemandScanning, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/ondemandscanning1/src/lib.rs b/gen/ondemandscanning1/src/lib.rs index 9dcdb03147..800ce1a236 100644 --- a/gen/ondemandscanning1/src/lib.rs +++ b/gen/ondemandscanning1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/ondemandscanning1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](OnDemandScanning) ... +//! Handle the following *Resources* with ease from the central [hub](OnDemandScanning) ... //! //! * projects //! * [*locations operations cancel*](api::ProjectLocationOperationCancelCall), [*locations operations delete*](api::ProjectLocationOperationDeleteCall), [*locations operations get*](api::ProjectLocationOperationGetCall), [*locations operations list*](api::ProjectLocationOperationListCall), [*locations operations wait*](api::ProjectLocationOperationWaitCall), [*locations scans analyze packages*](api::ProjectLocationScanAnalyzePackageCall) and [*locations scans vulnerabilities list*](api::ProjectLocationScanVulnerabilityListCall) @@ -52,8 +52,8 @@ //! let r = hub.projects().locations_scans_analyze_packages(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -81,12 +81,12 @@ //! use std::default::Default; //! use ondemandscanning1::{OnDemandScanning, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -123,10 +123,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -136,25 +136,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/orgpolicy2/README.md b/gen/orgpolicy2/README.md index eaf7414f32..dbc5f34e78 100644 --- a/gen/orgpolicy2/README.md +++ b/gen/orgpolicy2/README.md @@ -11,7 +11,7 @@ Everything else about the *OrgPolicy API* *v2* API can be found at the [official documentation site](https://cloud.google.com/orgpolicy/docs/reference/rest/index.html). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-orgpolicy2/5.0.3+20230123/google_orgpolicy2/OrgPolicyAPI) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-orgpolicy2/5.0.3+20230123/google_orgpolicy2/OrgPolicyAPI) ... * folders * [*constraints list*](https://docs.rs/google-orgpolicy2/5.0.3+20230123/google_orgpolicy2/api::FolderConstraintListCall), [*policies create*](https://docs.rs/google-orgpolicy2/5.0.3+20230123/google_orgpolicy2/api::FolderPolicyCreateCall), [*policies delete*](https://docs.rs/google-orgpolicy2/5.0.3+20230123/google_orgpolicy2/api::FolderPolicyDeleteCall), [*policies get*](https://docs.rs/google-orgpolicy2/5.0.3+20230123/google_orgpolicy2/api::FolderPolicyGetCall), [*policies get effective policy*](https://docs.rs/google-orgpolicy2/5.0.3+20230123/google_orgpolicy2/api::FolderPolicyGetEffectivePolicyCall), [*policies list*](https://docs.rs/google-orgpolicy2/5.0.3+20230123/google_orgpolicy2/api::FolderPolicyListCall) and [*policies patch*](https://docs.rs/google-orgpolicy2/5.0.3+20230123/google_orgpolicy2/api::FolderPolicyPatchCall) @@ -65,8 +65,8 @@ let r = hub.projects().policies_get_effective_policy(...).doit().await let r = hub.projects().policies_patch(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -94,12 +94,12 @@ use orgpolicy2::{Result, Error}; use std::default::Default; use orgpolicy2::{OrgPolicyAPI, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -141,10 +141,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-orgpolicy2/5.0.3+20230123/google_orgpolicy2/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-orgpolicy2/5.0.3+20230123/google_orgpolicy2/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -154,25 +154,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-orgpol You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-orgpolicy2/5.0.3+20230123/google_orgpolicy2/client::Delegate) to the -[Method Builder](https://docs.rs/google-orgpolicy2/5.0.3+20230123/google_orgpolicy2/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-orgpolicy2/5.0.3+20230123/google_orgpolicy2/client::Delegate) to the +[Method Builder](https://docs.rs/google-orgpolicy2/5.0.3+20230123/google_orgpolicy2/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-orgpolicy2/5.0.3+20230123/google_orgpolicy2/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-orgpolicy2/5.0.3+20230123/google_orgpolicy2/client::RequestValue) and -[decodable](https://docs.rs/google-orgpolicy2/5.0.3+20230123/google_orgpolicy2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-orgpolicy2/5.0.3+20230123/google_orgpolicy2/client::RequestValue) and +[decodable](https://docs.rs/google-orgpolicy2/5.0.3+20230123/google_orgpolicy2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-orgpolicy2/5.0.3+20230123/google_orgpolicy2/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-orgpolicy2/5.0.3+20230123/google_orgpolicy2/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -191,7 +191,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **orgpolicy2** library was generated by Sebastian Thiel, and is placed +The **orgpolicy2** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/orgpolicy2/src/api.rs b/gen/orgpolicy2/src/api.rs index 80d1020121..8fa6b6cf95 100644 --- a/gen/orgpolicy2/src/api.rs +++ b/gen/orgpolicy2/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use orgpolicy2::{OrgPolicyAPI, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/orgpolicy2/src/lib.rs b/gen/orgpolicy2/src/lib.rs index af9f86d201..4488e95d88 100644 --- a/gen/orgpolicy2/src/lib.rs +++ b/gen/orgpolicy2/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/orgpolicy2). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](OrgPolicyAPI) ... +//! Handle the following *Resources* with ease from the central [hub](OrgPolicyAPI) ... //! //! * folders //! * [*constraints list*](api::FolderConstraintListCall), [*policies create*](api::FolderPolicyCreateCall), [*policies delete*](api::FolderPolicyDeleteCall), [*policies get*](api::FolderPolicyGetCall), [*policies get effective policy*](api::FolderPolicyGetEffectivePolicyCall), [*policies list*](api::FolderPolicyListCall) and [*policies patch*](api::FolderPolicyPatchCall) @@ -65,8 +65,8 @@ //! let r = hub.projects().policies_patch(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -95,12 +95,12 @@ //! use std::default::Default; //! use orgpolicy2::{OrgPolicyAPI, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -142,10 +142,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -155,25 +155,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/oslogin1/README.md b/gen/oslogin1/README.md index fe3e5b2588..2aef30f625 100644 --- a/gen/oslogin1/README.md +++ b/gen/oslogin1/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud OS Login* *v1* API can be found at the [official documentation site](https://cloud.google.com/compute/docs/oslogin/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-oslogin1/5.0.3+20230115/google_oslogin1/CloudOSLogin) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-oslogin1/5.0.3+20230115/google_oslogin1/CloudOSLogin) ... * users * [*get login profile*](https://docs.rs/google-oslogin1/5.0.3+20230115/google_oslogin1/api::UserGetLoginProfileCall), [*import ssh public key*](https://docs.rs/google-oslogin1/5.0.3+20230115/google_oslogin1/api::UserImportSshPublicKeyCall), [*projects delete*](https://docs.rs/google-oslogin1/5.0.3+20230115/google_oslogin1/api::UserProjectDeleteCall), [*ssh public keys create*](https://docs.rs/google-oslogin1/5.0.3+20230115/google_oslogin1/api::UserSshPublicKeyCreateCall), [*ssh public keys delete*](https://docs.rs/google-oslogin1/5.0.3+20230115/google_oslogin1/api::UserSshPublicKeyDeleteCall), [*ssh public keys get*](https://docs.rs/google-oslogin1/5.0.3+20230115/google_oslogin1/api::UserSshPublicKeyGetCall) and [*ssh public keys patch*](https://docs.rs/google-oslogin1/5.0.3+20230115/google_oslogin1/api::UserSshPublicKeyPatchCall) @@ -53,8 +53,8 @@ let r = hub.users().ssh_public_keys_patch(...).doit().await let r = hub.users().import_ssh_public_key(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -82,12 +82,12 @@ use oslogin1::{Result, Error}; use std::default::Default; use oslogin1::{CloudOSLogin, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -129,10 +129,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-oslogin1/5.0.3+20230115/google_oslogin1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-oslogin1/5.0.3+20230115/google_oslogin1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -142,25 +142,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-oslogi You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-oslogin1/5.0.3+20230115/google_oslogin1/client::Delegate) to the -[Method Builder](https://docs.rs/google-oslogin1/5.0.3+20230115/google_oslogin1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-oslogin1/5.0.3+20230115/google_oslogin1/client::Delegate) to the +[Method Builder](https://docs.rs/google-oslogin1/5.0.3+20230115/google_oslogin1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-oslogin1/5.0.3+20230115/google_oslogin1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-oslogin1/5.0.3+20230115/google_oslogin1/client::RequestValue) and -[decodable](https://docs.rs/google-oslogin1/5.0.3+20230115/google_oslogin1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-oslogin1/5.0.3+20230115/google_oslogin1/client::RequestValue) and +[decodable](https://docs.rs/google-oslogin1/5.0.3+20230115/google_oslogin1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-oslogin1/5.0.3+20230115/google_oslogin1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-oslogin1/5.0.3+20230115/google_oslogin1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -179,7 +179,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **oslogin1** library was generated by Sebastian Thiel, and is placed +The **oslogin1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/oslogin1/src/api.rs b/gen/oslogin1/src/api.rs index eac7c2d8fc..d34f9f89c2 100644 --- a/gen/oslogin1/src/api.rs +++ b/gen/oslogin1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -77,12 +77,12 @@ impl Default for Scope { /// use std::default::Default; /// use oslogin1::{CloudOSLogin, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/oslogin1/src/lib.rs b/gen/oslogin1/src/lib.rs index d08e769bc1..c262ccf2ce 100644 --- a/gen/oslogin1/src/lib.rs +++ b/gen/oslogin1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/oslogin1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudOSLogin) ... +//! Handle the following *Resources* with ease from the central [hub](CloudOSLogin) ... //! //! * users //! * [*get login profile*](api::UserGetLoginProfileCall), [*import ssh public key*](api::UserImportSshPublicKeyCall), [*projects delete*](api::UserProjectDeleteCall), [*ssh public keys create*](api::UserSshPublicKeyCreateCall), [*ssh public keys delete*](api::UserSshPublicKeyDeleteCall), [*ssh public keys get*](api::UserSshPublicKeyGetCall) and [*ssh public keys patch*](api::UserSshPublicKeyPatchCall) @@ -53,8 +53,8 @@ //! let r = hub.users().import_ssh_public_key(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -83,12 +83,12 @@ //! use std::default::Default; //! use oslogin1::{CloudOSLogin, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -130,10 +130,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -143,25 +143,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/oslogin1_beta/README.md b/gen/oslogin1_beta/README.md index adc1e93afe..f740ec629b 100644 --- a/gen/oslogin1_beta/README.md +++ b/gen/oslogin1_beta/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud OS Login* *v1_beta* API can be found at the [official documentation site](https://cloud.google.com/compute/docs/oslogin/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-oslogin1_beta/5.0.3+20230115/google_oslogin1_beta/CloudOSLogin) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-oslogin1_beta/5.0.3+20230115/google_oslogin1_beta/CloudOSLogin) ... * users * [*get login profile*](https://docs.rs/google-oslogin1_beta/5.0.3+20230115/google_oslogin1_beta/api::UserGetLoginProfileCall), [*import ssh public key*](https://docs.rs/google-oslogin1_beta/5.0.3+20230115/google_oslogin1_beta/api::UserImportSshPublicKeyCall), [*projects delete*](https://docs.rs/google-oslogin1_beta/5.0.3+20230115/google_oslogin1_beta/api::UserProjectDeleteCall), [*ssh public keys create*](https://docs.rs/google-oslogin1_beta/5.0.3+20230115/google_oslogin1_beta/api::UserSshPublicKeyCreateCall), [*ssh public keys delete*](https://docs.rs/google-oslogin1_beta/5.0.3+20230115/google_oslogin1_beta/api::UserSshPublicKeyDeleteCall), [*ssh public keys get*](https://docs.rs/google-oslogin1_beta/5.0.3+20230115/google_oslogin1_beta/api::UserSshPublicKeyGetCall) and [*ssh public keys patch*](https://docs.rs/google-oslogin1_beta/5.0.3+20230115/google_oslogin1_beta/api::UserSshPublicKeyPatchCall) @@ -53,8 +53,8 @@ let r = hub.users().ssh_public_keys_patch(...).doit().await let r = hub.users().import_ssh_public_key(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -82,12 +82,12 @@ use oslogin1_beta::{Result, Error}; use std::default::Default; use oslogin1_beta::{CloudOSLogin, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -130,10 +130,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-oslogin1_beta/5.0.3+20230115/google_oslogin1_beta/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-oslogin1_beta/5.0.3+20230115/google_oslogin1_beta/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -143,25 +143,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-oslogi You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-oslogin1_beta/5.0.3+20230115/google_oslogin1_beta/client::Delegate) to the -[Method Builder](https://docs.rs/google-oslogin1_beta/5.0.3+20230115/google_oslogin1_beta/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-oslogin1_beta/5.0.3+20230115/google_oslogin1_beta/client::Delegate) to the +[Method Builder](https://docs.rs/google-oslogin1_beta/5.0.3+20230115/google_oslogin1_beta/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-oslogin1_beta/5.0.3+20230115/google_oslogin1_beta/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-oslogin1_beta/5.0.3+20230115/google_oslogin1_beta/client::RequestValue) and -[decodable](https://docs.rs/google-oslogin1_beta/5.0.3+20230115/google_oslogin1_beta/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-oslogin1_beta/5.0.3+20230115/google_oslogin1_beta/client::RequestValue) and +[decodable](https://docs.rs/google-oslogin1_beta/5.0.3+20230115/google_oslogin1_beta/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-oslogin1_beta/5.0.3+20230115/google_oslogin1_beta/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-oslogin1_beta/5.0.3+20230115/google_oslogin1_beta/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -180,7 +180,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **oslogin1_beta** library was generated by Sebastian Thiel, and is placed +The **oslogin1_beta** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/oslogin1_beta/src/api.rs b/gen/oslogin1_beta/src/api.rs index caffa08c66..a9d9983041 100644 --- a/gen/oslogin1_beta/src/api.rs +++ b/gen/oslogin1_beta/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -77,12 +77,12 @@ impl Default for Scope { /// use std::default::Default; /// use oslogin1_beta::{CloudOSLogin, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/oslogin1_beta/src/lib.rs b/gen/oslogin1_beta/src/lib.rs index dd4fd3daf7..5ece36fc5f 100644 --- a/gen/oslogin1_beta/src/lib.rs +++ b/gen/oslogin1_beta/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/oslogin1_beta). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudOSLogin) ... +//! Handle the following *Resources* with ease from the central [hub](CloudOSLogin) ... //! //! * users //! * [*get login profile*](api::UserGetLoginProfileCall), [*import ssh public key*](api::UserImportSshPublicKeyCall), [*projects delete*](api::UserProjectDeleteCall), [*ssh public keys create*](api::UserSshPublicKeyCreateCall), [*ssh public keys delete*](api::UserSshPublicKeyDeleteCall), [*ssh public keys get*](api::UserSshPublicKeyGetCall) and [*ssh public keys patch*](api::UserSshPublicKeyPatchCall) @@ -53,8 +53,8 @@ //! let r = hub.users().import_ssh_public_key(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -83,12 +83,12 @@ //! use std::default::Default; //! use oslogin1_beta::{CloudOSLogin, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -131,10 +131,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -144,25 +144,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/pagespeedonline2/README.md b/gen/pagespeedonline2/README.md index a494f67d28..054c573e44 100644 --- a/gen/pagespeedonline2/README.md +++ b/gen/pagespeedonline2/README.md @@ -11,7 +11,7 @@ Everything else about the *pagespeedonline* *v2* API can be found at the [official documentation site](https://developers.google.com/speed/docs/insights/v2/getting-started). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-pagespeedonline2/5.0.3+20191206/google_pagespeedonline2/Pagespeedonline) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-pagespeedonline2/5.0.3+20191206/google_pagespeedonline2/Pagespeedonline) ... * pagespeedapi * [*runpagespeed*](https://docs.rs/google-pagespeedonline2/5.0.3+20191206/google_pagespeedonline2/api::PagespeedapiRunpagespeedCall) @@ -50,8 +50,8 @@ Or specifically ... let r = hub.pagespeedapi().runpagespeed(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -78,12 +78,12 @@ use pagespeedonline2::{Result, Error}; use std::default::Default; use pagespeedonline2::{Pagespeedonline, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -124,10 +124,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-pagespeedonline2/5.0.3+20191206/google_pagespeedonline2/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-pagespeedonline2/5.0.3+20191206/google_pagespeedonline2/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -137,25 +137,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-pagesp You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-pagespeedonline2/5.0.3+20191206/google_pagespeedonline2/client::Delegate) to the -[Method Builder](https://docs.rs/google-pagespeedonline2/5.0.3+20191206/google_pagespeedonline2/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-pagespeedonline2/5.0.3+20191206/google_pagespeedonline2/client::Delegate) to the +[Method Builder](https://docs.rs/google-pagespeedonline2/5.0.3+20191206/google_pagespeedonline2/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-pagespeedonline2/5.0.3+20191206/google_pagespeedonline2/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-pagespeedonline2/5.0.3+20191206/google_pagespeedonline2/client::RequestValue) and -[decodable](https://docs.rs/google-pagespeedonline2/5.0.3+20191206/google_pagespeedonline2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-pagespeedonline2/5.0.3+20191206/google_pagespeedonline2/client::RequestValue) and +[decodable](https://docs.rs/google-pagespeedonline2/5.0.3+20191206/google_pagespeedonline2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-pagespeedonline2/5.0.3+20191206/google_pagespeedonline2/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-pagespeedonline2/5.0.3+20191206/google_pagespeedonline2/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -174,7 +174,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **pagespeedonline2** library was generated by Sebastian Thiel, and is placed +The **pagespeedonline2** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/pagespeedonline2/src/api.rs b/gen/pagespeedonline2/src/api.rs index 62ea258ccf..b0f253e33b 100644 --- a/gen/pagespeedonline2/src/api.rs +++ b/gen/pagespeedonline2/src/api.rs @@ -42,12 +42,12 @@ use crate::{client, client::GetToken, client::serde_with}; /// use std::default::Default; /// use pagespeedonline2::{Pagespeedonline, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/pagespeedonline2/src/lib.rs b/gen/pagespeedonline2/src/lib.rs index 5cdbaa0f50..5011094a60 100644 --- a/gen/pagespeedonline2/src/lib.rs +++ b/gen/pagespeedonline2/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/pagespeedonline2). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Pagespeedonline) ... +//! Handle the following *Resources* with ease from the central [hub](Pagespeedonline) ... //! //! * pagespeedapi //! * [*runpagespeed*](api::PagespeedapiRunpagespeedCall) @@ -50,8 +50,8 @@ //! let r = hub.pagespeedapi().runpagespeed(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -79,12 +79,12 @@ //! use std::default::Default; //! use pagespeedonline2::{Pagespeedonline, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -125,10 +125,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -138,25 +138,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/pagespeedonline4/README.md b/gen/pagespeedonline4/README.md index 14b46fe230..8ec1c9c310 100644 --- a/gen/pagespeedonline4/README.md +++ b/gen/pagespeedonline4/README.md @@ -11,7 +11,7 @@ Everything else about the *pagespeedonline* *v4* API can be found at the [official documentation site](https://developers.google.com/speed/docs/insights/v4/getting-started). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-pagespeedonline4/5.0.3+20191206/google_pagespeedonline4/Pagespeedonline) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-pagespeedonline4/5.0.3+20191206/google_pagespeedonline4/Pagespeedonline) ... * pagespeedapi * [*runpagespeed*](https://docs.rs/google-pagespeedonline4/5.0.3+20191206/google_pagespeedonline4/api::PagespeedapiRunpagespeedCall) @@ -50,8 +50,8 @@ Or specifically ... let r = hub.pagespeedapi().runpagespeed(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -78,12 +78,12 @@ use pagespeedonline4::{Result, Error}; use std::default::Default; use pagespeedonline4::{Pagespeedonline, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -127,10 +127,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-pagespeedonline4/5.0.3+20191206/google_pagespeedonline4/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-pagespeedonline4/5.0.3+20191206/google_pagespeedonline4/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -140,25 +140,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-pagesp You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-pagespeedonline4/5.0.3+20191206/google_pagespeedonline4/client::Delegate) to the -[Method Builder](https://docs.rs/google-pagespeedonline4/5.0.3+20191206/google_pagespeedonline4/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-pagespeedonline4/5.0.3+20191206/google_pagespeedonline4/client::Delegate) to the +[Method Builder](https://docs.rs/google-pagespeedonline4/5.0.3+20191206/google_pagespeedonline4/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-pagespeedonline4/5.0.3+20191206/google_pagespeedonline4/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-pagespeedonline4/5.0.3+20191206/google_pagespeedonline4/client::RequestValue) and -[decodable](https://docs.rs/google-pagespeedonline4/5.0.3+20191206/google_pagespeedonline4/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-pagespeedonline4/5.0.3+20191206/google_pagespeedonline4/client::RequestValue) and +[decodable](https://docs.rs/google-pagespeedonline4/5.0.3+20191206/google_pagespeedonline4/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-pagespeedonline4/5.0.3+20191206/google_pagespeedonline4/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-pagespeedonline4/5.0.3+20191206/google_pagespeedonline4/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -177,7 +177,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **pagespeedonline4** library was generated by Sebastian Thiel, and is placed +The **pagespeedonline4** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/pagespeedonline4/src/api.rs b/gen/pagespeedonline4/src/api.rs index 035ee55787..6301967fb5 100644 --- a/gen/pagespeedonline4/src/api.rs +++ b/gen/pagespeedonline4/src/api.rs @@ -42,12 +42,12 @@ use crate::{client, client::GetToken, client::serde_with}; /// use std::default::Default; /// use pagespeedonline4::{Pagespeedonline, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/pagespeedonline4/src/lib.rs b/gen/pagespeedonline4/src/lib.rs index ffa0b35a28..57a1178a2c 100644 --- a/gen/pagespeedonline4/src/lib.rs +++ b/gen/pagespeedonline4/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/pagespeedonline4). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Pagespeedonline) ... +//! Handle the following *Resources* with ease from the central [hub](Pagespeedonline) ... //! //! * pagespeedapi //! * [*runpagespeed*](api::PagespeedapiRunpagespeedCall) @@ -50,8 +50,8 @@ //! let r = hub.pagespeedapi().runpagespeed(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -79,12 +79,12 @@ //! use std::default::Default; //! use pagespeedonline4::{Pagespeedonline, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -128,10 +128,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -141,25 +141,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/pagespeedonline5/README.md b/gen/pagespeedonline5/README.md index 206c233969..84959b3fc7 100644 --- a/gen/pagespeedonline5/README.md +++ b/gen/pagespeedonline5/README.md @@ -11,7 +11,7 @@ Everything else about the *Pagespeed Insights* *v5* API can be found at the [official documentation site](https://developers.google.com/speed/docs/insights/v5/about). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-pagespeedonline5/5.0.3+20230123/google_pagespeedonline5/PagespeedInsights) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-pagespeedonline5/5.0.3+20230123/google_pagespeedonline5/PagespeedInsights) ... * pagespeedapi * [*runpagespeed*](https://docs.rs/google-pagespeedonline5/5.0.3+20230123/google_pagespeedonline5/api::PagespeedapiRunpagespeedCall) @@ -50,8 +50,8 @@ Or specifically ... let r = hub.pagespeedapi().runpagespeed(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -78,12 +78,12 @@ use pagespeedonline5::{Result, Error}; use std::default::Default; use pagespeedonline5::{PagespeedInsights, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -125,10 +125,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-pagespeedonline5/5.0.3+20230123/google_pagespeedonline5/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-pagespeedonline5/5.0.3+20230123/google_pagespeedonline5/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -138,25 +138,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-pagesp You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-pagespeedonline5/5.0.3+20230123/google_pagespeedonline5/client::Delegate) to the -[Method Builder](https://docs.rs/google-pagespeedonline5/5.0.3+20230123/google_pagespeedonline5/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-pagespeedonline5/5.0.3+20230123/google_pagespeedonline5/client::Delegate) to the +[Method Builder](https://docs.rs/google-pagespeedonline5/5.0.3+20230123/google_pagespeedonline5/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-pagespeedonline5/5.0.3+20230123/google_pagespeedonline5/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-pagespeedonline5/5.0.3+20230123/google_pagespeedonline5/client::RequestValue) and -[decodable](https://docs.rs/google-pagespeedonline5/5.0.3+20230123/google_pagespeedonline5/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-pagespeedonline5/5.0.3+20230123/google_pagespeedonline5/client::RequestValue) and +[decodable](https://docs.rs/google-pagespeedonline5/5.0.3+20230123/google_pagespeedonline5/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-pagespeedonline5/5.0.3+20230123/google_pagespeedonline5/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-pagespeedonline5/5.0.3+20230123/google_pagespeedonline5/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -175,7 +175,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **pagespeedonline5** library was generated by Sebastian Thiel, and is placed +The **pagespeedonline5** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/pagespeedonline5/src/api.rs b/gen/pagespeedonline5/src/api.rs index 9bc133f6ab..3885d48603 100644 --- a/gen/pagespeedonline5/src/api.rs +++ b/gen/pagespeedonline5/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// Associate you with your personal info on Google Openid, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use pagespeedonline5::{PagespeedInsights, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/pagespeedonline5/src/lib.rs b/gen/pagespeedonline5/src/lib.rs index 2a909b52d3..c84a2726cc 100644 --- a/gen/pagespeedonline5/src/lib.rs +++ b/gen/pagespeedonline5/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/pagespeedonline5). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](PagespeedInsights) ... +//! Handle the following *Resources* with ease from the central [hub](PagespeedInsights) ... //! //! * pagespeedapi //! * [*runpagespeed*](api::PagespeedapiRunpagespeedCall) @@ -50,8 +50,8 @@ //! let r = hub.pagespeedapi().runpagespeed(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -79,12 +79,12 @@ //! use std::default::Default; //! use pagespeedonline5::{PagespeedInsights, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -126,10 +126,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -139,25 +139,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/partners2/README.md b/gen/partners2/README.md index 4103876995..2ab944b175 100644 --- a/gen/partners2/README.md +++ b/gen/partners2/README.md @@ -11,7 +11,7 @@ Everything else about the *Partners* *v2* API can be found at the [official documentation site](https://developers.google.com/partners/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-partners2/5.0.3+20180925/google_partners2/Partners) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-partners2/5.0.3+20180925/google_partners2/Partners) ... * analytics * [*list*](https://docs.rs/google-partners2/5.0.3+20180925/google_partners2/api::AnalyticListCall) @@ -72,8 +72,8 @@ let r = hub.users().delete_company_relation(...).doit().await let r = hub.users().get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -101,12 +101,12 @@ use partners2::{Result, Error}; use std::default::Default; use partners2::{Partners, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -154,10 +154,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-partners2/5.0.3+20180925/google_partners2/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-partners2/5.0.3+20180925/google_partners2/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -167,25 +167,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-partne You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-partners2/5.0.3+20180925/google_partners2/client::Delegate) to the -[Method Builder](https://docs.rs/google-partners2/5.0.3+20180925/google_partners2/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-partners2/5.0.3+20180925/google_partners2/client::Delegate) to the +[Method Builder](https://docs.rs/google-partners2/5.0.3+20180925/google_partners2/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-partners2/5.0.3+20180925/google_partners2/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-partners2/5.0.3+20180925/google_partners2/client::RequestValue) and -[decodable](https://docs.rs/google-partners2/5.0.3+20180925/google_partners2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-partners2/5.0.3+20180925/google_partners2/client::RequestValue) and +[decodable](https://docs.rs/google-partners2/5.0.3+20180925/google_partners2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-partners2/5.0.3+20180925/google_partners2/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-partners2/5.0.3+20180925/google_partners2/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -204,7 +204,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **partners2** library was generated by Sebastian Thiel, and is placed +The **partners2** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/partners2/src/api.rs b/gen/partners2/src/api.rs index 378a1563ea..c371757c01 100644 --- a/gen/partners2/src/api.rs +++ b/gen/partners2/src/api.rs @@ -43,12 +43,12 @@ use crate::{client, client::GetToken, client::serde_with}; /// use std::default::Default; /// use partners2::{Partners, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/partners2/src/lib.rs b/gen/partners2/src/lib.rs index 853f086333..fcfcd55273 100644 --- a/gen/partners2/src/lib.rs +++ b/gen/partners2/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/partners2). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Partners) ... +//! Handle the following *Resources* with ease from the central [hub](Partners) ... //! //! * analytics //! * [*list*](api::AnalyticListCall) @@ -72,8 +72,8 @@ //! let r = hub.users().get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -102,12 +102,12 @@ //! use std::default::Default; //! use partners2::{Partners, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -155,10 +155,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -168,25 +168,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/paymentsresellersubscription1/README.md b/gen/paymentsresellersubscription1/README.md index 696a07ae83..4c3b91ff29 100644 --- a/gen/paymentsresellersubscription1/README.md +++ b/gen/paymentsresellersubscription1/README.md @@ -11,7 +11,7 @@ Everything else about the *Payments Reseller Subscription* *v1* API can be found [official documentation site](https://developers.google.com/payments/reseller/subscription/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-paymentsresellersubscription1/5.0.3+20230123/google_paymentsresellersubscription1/PaymentsResellerSubscription) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-paymentsresellersubscription1/5.0.3+20230123/google_paymentsresellersubscription1/PaymentsResellerSubscription) ... * partners * [*products list*](https://docs.rs/google-paymentsresellersubscription1/5.0.3+20230123/google_paymentsresellersubscription1/api::PartnerProductListCall), [*promotions find eligible*](https://docs.rs/google-paymentsresellersubscription1/5.0.3+20230123/google_paymentsresellersubscription1/api::PartnerPromotionFindEligibleCall), [*promotions list*](https://docs.rs/google-paymentsresellersubscription1/5.0.3+20230123/google_paymentsresellersubscription1/api::PartnerPromotionListCall), [*subscriptions cancel*](https://docs.rs/google-paymentsresellersubscription1/5.0.3+20230123/google_paymentsresellersubscription1/api::PartnerSubscriptionCancelCall), [*subscriptions create*](https://docs.rs/google-paymentsresellersubscription1/5.0.3+20230123/google_paymentsresellersubscription1/api::PartnerSubscriptionCreateCall), [*subscriptions entitle*](https://docs.rs/google-paymentsresellersubscription1/5.0.3+20230123/google_paymentsresellersubscription1/api::PartnerSubscriptionEntitleCall), [*subscriptions extend*](https://docs.rs/google-paymentsresellersubscription1/5.0.3+20230123/google_paymentsresellersubscription1/api::PartnerSubscriptionExtendCall), [*subscriptions get*](https://docs.rs/google-paymentsresellersubscription1/5.0.3+20230123/google_paymentsresellersubscription1/api::PartnerSubscriptionGetCall), [*subscriptions provision*](https://docs.rs/google-paymentsresellersubscription1/5.0.3+20230123/google_paymentsresellersubscription1/api::PartnerSubscriptionProvisionCall) and [*subscriptions undo cancel*](https://docs.rs/google-paymentsresellersubscription1/5.0.3+20230123/google_paymentsresellersubscription1/api::PartnerSubscriptionUndoCancelCall) @@ -52,8 +52,8 @@ let r = hub.partners().subscriptions_get(...).doit().await let r = hub.partners().subscriptions_provision(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -81,12 +81,12 @@ use paymentsresellersubscription1::{Result, Error}; use std::default::Default; use paymentsresellersubscription1::{PaymentsResellerSubscription, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -128,10 +128,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-paymentsresellersubscription1/5.0.3+20230123/google_paymentsresellersubscription1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-paymentsresellersubscription1/5.0.3+20230123/google_paymentsresellersubscription1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -141,25 +141,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-paymen You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-paymentsresellersubscription1/5.0.3+20230123/google_paymentsresellersubscription1/client::Delegate) to the -[Method Builder](https://docs.rs/google-paymentsresellersubscription1/5.0.3+20230123/google_paymentsresellersubscription1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-paymentsresellersubscription1/5.0.3+20230123/google_paymentsresellersubscription1/client::Delegate) to the +[Method Builder](https://docs.rs/google-paymentsresellersubscription1/5.0.3+20230123/google_paymentsresellersubscription1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-paymentsresellersubscription1/5.0.3+20230123/google_paymentsresellersubscription1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-paymentsresellersubscription1/5.0.3+20230123/google_paymentsresellersubscription1/client::RequestValue) and -[decodable](https://docs.rs/google-paymentsresellersubscription1/5.0.3+20230123/google_paymentsresellersubscription1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-paymentsresellersubscription1/5.0.3+20230123/google_paymentsresellersubscription1/client::RequestValue) and +[decodable](https://docs.rs/google-paymentsresellersubscription1/5.0.3+20230123/google_paymentsresellersubscription1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-paymentsresellersubscription1/5.0.3+20230123/google_paymentsresellersubscription1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-paymentsresellersubscription1/5.0.3+20230123/google_paymentsresellersubscription1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -178,7 +178,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **paymentsresellersubscription1** library was generated by Sebastian Thiel, and is placed +The **paymentsresellersubscription1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/paymentsresellersubscription1/src/api.rs b/gen/paymentsresellersubscription1/src/api.rs index baf4bca8df..7f0cb37051 100644 --- a/gen/paymentsresellersubscription1/src/api.rs +++ b/gen/paymentsresellersubscription1/src/api.rs @@ -43,12 +43,12 @@ use crate::{client, client::GetToken, client::serde_with}; /// use std::default::Default; /// use paymentsresellersubscription1::{PaymentsResellerSubscription, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/paymentsresellersubscription1/src/lib.rs b/gen/paymentsresellersubscription1/src/lib.rs index 4897fafcf7..bd3bdc4a44 100644 --- a/gen/paymentsresellersubscription1/src/lib.rs +++ b/gen/paymentsresellersubscription1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/paymentsresellersubscription1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](PaymentsResellerSubscription) ... +//! Handle the following *Resources* with ease from the central [hub](PaymentsResellerSubscription) ... //! //! * partners //! * [*products list*](api::PartnerProductListCall), [*promotions find eligible*](api::PartnerPromotionFindEligibleCall), [*promotions list*](api::PartnerPromotionListCall), [*subscriptions cancel*](api::PartnerSubscriptionCancelCall), [*subscriptions create*](api::PartnerSubscriptionCreateCall), [*subscriptions entitle*](api::PartnerSubscriptionEntitleCall), [*subscriptions extend*](api::PartnerSubscriptionExtendCall), [*subscriptions get*](api::PartnerSubscriptionGetCall), [*subscriptions provision*](api::PartnerSubscriptionProvisionCall) and [*subscriptions undo cancel*](api::PartnerSubscriptionUndoCancelCall) @@ -52,8 +52,8 @@ //! let r = hub.partners().subscriptions_provision(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -82,12 +82,12 @@ //! use std::default::Default; //! use paymentsresellersubscription1::{PaymentsResellerSubscription, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -129,10 +129,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -142,25 +142,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/people1/README.md b/gen/people1/README.md index 07298813a5..af50c481db 100644 --- a/gen/people1/README.md +++ b/gen/people1/README.md @@ -11,7 +11,7 @@ Everything else about the *People Service* *v1* API can be found at the [official documentation site](https://developers.google.com/people/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-people1/5.0.3+20230123/google_people1/PeopleService) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-people1/5.0.3+20230123/google_people1/PeopleService) ... * [contact groups](https://docs.rs/google-people1/5.0.3+20230123/google_people1/api::ContactGroup) * [*batch get*](https://docs.rs/google-people1/5.0.3+20230123/google_people1/api::ContactGroupBatchGetCall), [*create*](https://docs.rs/google-people1/5.0.3+20230123/google_people1/api::ContactGroupCreateCall), [*delete*](https://docs.rs/google-people1/5.0.3+20230123/google_people1/api::ContactGroupDeleteCall), [*get*](https://docs.rs/google-people1/5.0.3+20230123/google_people1/api::ContactGroupGetCall), [*list*](https://docs.rs/google-people1/5.0.3+20230123/google_people1/api::ContactGroupListCall), [*members modify*](https://docs.rs/google-people1/5.0.3+20230123/google_people1/api::ContactGroupMemberModifyCall) and [*update*](https://docs.rs/google-people1/5.0.3+20230123/google_people1/api::ContactGroupUpdateCall) @@ -60,8 +60,8 @@ let r = hub.contact_groups().list(...).doit().await let r = hub.contact_groups().update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -88,12 +88,12 @@ use people1::{Result, Error}; use std::default::Default; use people1::{PeopleService, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -133,10 +133,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-people1/5.0.3+20230123/google_people1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-people1/5.0.3+20230123/google_people1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -146,25 +146,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-people You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-people1/5.0.3+20230123/google_people1/client::Delegate) to the -[Method Builder](https://docs.rs/google-people1/5.0.3+20230123/google_people1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-people1/5.0.3+20230123/google_people1/client::Delegate) to the +[Method Builder](https://docs.rs/google-people1/5.0.3+20230123/google_people1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-people1/5.0.3+20230123/google_people1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-people1/5.0.3+20230123/google_people1/client::RequestValue) and -[decodable](https://docs.rs/google-people1/5.0.3+20230123/google_people1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-people1/5.0.3+20230123/google_people1/client::RequestValue) and +[decodable](https://docs.rs/google-people1/5.0.3+20230123/google_people1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-people1/5.0.3+20230123/google_people1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-people1/5.0.3+20230123/google_people1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -183,7 +183,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **people1** library was generated by Sebastian Thiel, and is placed +The **people1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/people1/src/api.rs b/gen/people1/src/api.rs index 105fedccea..aaea6b20a9 100644 --- a/gen/people1/src/api.rs +++ b/gen/people1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, download, and permanently delete your contacts Contact, @@ -108,12 +108,12 @@ impl Default for Scope { /// use std::default::Default; /// use people1::{PeopleService, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/people1/src/lib.rs b/gen/people1/src/lib.rs index a0a2777738..0df5d2f324 100644 --- a/gen/people1/src/lib.rs +++ b/gen/people1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/people1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](PeopleService) ... +//! Handle the following *Resources* with ease from the central [hub](PeopleService) ... //! //! * [contact groups](api::ContactGroup) //! * [*batch get*](api::ContactGroupBatchGetCall), [*create*](api::ContactGroupCreateCall), [*delete*](api::ContactGroupDeleteCall), [*get*](api::ContactGroupGetCall), [*list*](api::ContactGroupListCall), [*members modify*](api::ContactGroupMemberModifyCall) and [*update*](api::ContactGroupUpdateCall) @@ -60,8 +60,8 @@ //! let r = hub.contact_groups().update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -89,12 +89,12 @@ //! use std::default::Default; //! use people1::{PeopleService, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -134,10 +134,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -147,25 +147,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/photoslibrary1/README.md b/gen/photoslibrary1/README.md index 8243a1446e..cc37ed586b 100644 --- a/gen/photoslibrary1/README.md +++ b/gen/photoslibrary1/README.md @@ -11,7 +11,7 @@ Everything else about the *Photos Library* *v1* API can be found at the [official documentation site](https://developers.google.com/photos/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-photoslibrary1/5.0.3+20230117/google_photoslibrary1/PhotosLibrary) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-photoslibrary1/5.0.3+20230117/google_photoslibrary1/PhotosLibrary) ... * [albums](https://docs.rs/google-photoslibrary1/5.0.3+20230117/google_photoslibrary1/api::Album) * [*add enrichment*](https://docs.rs/google-photoslibrary1/5.0.3+20230117/google_photoslibrary1/api::AlbumAddEnrichmentCall), [*batch add media items*](https://docs.rs/google-photoslibrary1/5.0.3+20230117/google_photoslibrary1/api::AlbumBatchAddMediaItemCall), [*batch remove media items*](https://docs.rs/google-photoslibrary1/5.0.3+20230117/google_photoslibrary1/api::AlbumBatchRemoveMediaItemCall), [*create*](https://docs.rs/google-photoslibrary1/5.0.3+20230117/google_photoslibrary1/api::AlbumCreateCall), [*get*](https://docs.rs/google-photoslibrary1/5.0.3+20230117/google_photoslibrary1/api::AlbumGetCall), [*list*](https://docs.rs/google-photoslibrary1/5.0.3+20230117/google_photoslibrary1/api::AlbumListCall), [*patch*](https://docs.rs/google-photoslibrary1/5.0.3+20230117/google_photoslibrary1/api::AlbumPatchCall), [*share*](https://docs.rs/google-photoslibrary1/5.0.3+20230117/google_photoslibrary1/api::AlbumShareCall) and [*unshare*](https://docs.rs/google-photoslibrary1/5.0.3+20230117/google_photoslibrary1/api::AlbumUnshareCall) @@ -63,8 +63,8 @@ let r = hub.albums().unshare(...).doit().await let r = hub.shared_albums().get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -91,12 +91,12 @@ use photoslibrary1::{Result, Error}; use std::default::Default; use photoslibrary1::{PhotosLibrary, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -135,10 +135,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-photoslibrary1/5.0.3+20230117/google_photoslibrary1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-photoslibrary1/5.0.3+20230117/google_photoslibrary1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -148,25 +148,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-photos You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-photoslibrary1/5.0.3+20230117/google_photoslibrary1/client::Delegate) to the -[Method Builder](https://docs.rs/google-photoslibrary1/5.0.3+20230117/google_photoslibrary1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-photoslibrary1/5.0.3+20230117/google_photoslibrary1/client::Delegate) to the +[Method Builder](https://docs.rs/google-photoslibrary1/5.0.3+20230117/google_photoslibrary1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-photoslibrary1/5.0.3+20230117/google_photoslibrary1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-photoslibrary1/5.0.3+20230117/google_photoslibrary1/client::RequestValue) and -[decodable](https://docs.rs/google-photoslibrary1/5.0.3+20230117/google_photoslibrary1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-photoslibrary1/5.0.3+20230117/google_photoslibrary1/client::RequestValue) and +[decodable](https://docs.rs/google-photoslibrary1/5.0.3+20230117/google_photoslibrary1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-photoslibrary1/5.0.3+20230117/google_photoslibrary1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-photoslibrary1/5.0.3+20230117/google_photoslibrary1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -185,7 +185,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **photoslibrary1** library was generated by Sebastian Thiel, and is placed +The **photoslibrary1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/photoslibrary1/src/api.rs b/gen/photoslibrary1/src/api.rs index b5f1aeab4b..15f7e14fd5 100644 --- a/gen/photoslibrary1/src/api.rs +++ b/gen/photoslibrary1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, upload, and organize items in your Google Photos library Full, @@ -84,12 +84,12 @@ impl Default for Scope { /// use std::default::Default; /// use photoslibrary1::{PhotosLibrary, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/photoslibrary1/src/lib.rs b/gen/photoslibrary1/src/lib.rs index 7c64adc981..f127c78d55 100644 --- a/gen/photoslibrary1/src/lib.rs +++ b/gen/photoslibrary1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/photoslibrary1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](PhotosLibrary) ... +//! Handle the following *Resources* with ease from the central [hub](PhotosLibrary) ... //! //! * [albums](api::Album) //! * [*add enrichment*](api::AlbumAddEnrichmentCall), [*batch add media items*](api::AlbumBatchAddMediaItemCall), [*batch remove media items*](api::AlbumBatchRemoveMediaItemCall), [*create*](api::AlbumCreateCall), [*get*](api::AlbumGetCall), [*list*](api::AlbumListCall), [*patch*](api::AlbumPatchCall), [*share*](api::AlbumShareCall) and [*unshare*](api::AlbumUnshareCall) @@ -63,8 +63,8 @@ //! let r = hub.shared_albums().get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -92,12 +92,12 @@ //! use std::default::Default; //! use photoslibrary1::{PhotosLibrary, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -136,10 +136,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -149,25 +149,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/playablelocations3/README.md b/gen/playablelocations3/README.md index 3c084a224f..9cc957f1fb 100644 --- a/gen/playablelocations3/README.md +++ b/gen/playablelocations3/README.md @@ -11,7 +11,7 @@ Everything else about the *Playable Locations* *v3* API can be found at the [official documentation site](https://developers.google.com/maps/contact-sales/). # Features -Use the following functionality with ease from the central [hub](https://docs.rs/google-playablelocations3/5.0.3+20200707/google_playablelocations3/PlayableLocations) ... +Use the following functionality with ease from the central [hub](https://docs.rs/google-playablelocations3/5.0.3+20200707/google_playablelocations3/PlayableLocations) ... * [log impressions](https://docs.rs/google-playablelocations3/5.0.3+20200707/google_playablelocations3/api::MethodLogImpressionCall) @@ -51,8 +51,8 @@ Or specifically ... let r = hub.methods().log_impressions(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -80,12 +80,12 @@ use playablelocations3::{Result, Error}; use std::default::Default; use playablelocations3::{PlayableLocations, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -126,10 +126,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-playablelocations3/5.0.3+20200707/google_playablelocations3/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-playablelocations3/5.0.3+20200707/google_playablelocations3/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -139,25 +139,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-playab You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-playablelocations3/5.0.3+20200707/google_playablelocations3/client::Delegate) to the -[Method Builder](https://docs.rs/google-playablelocations3/5.0.3+20200707/google_playablelocations3/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-playablelocations3/5.0.3+20200707/google_playablelocations3/client::Delegate) to the +[Method Builder](https://docs.rs/google-playablelocations3/5.0.3+20200707/google_playablelocations3/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-playablelocations3/5.0.3+20200707/google_playablelocations3/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-playablelocations3/5.0.3+20200707/google_playablelocations3/client::RequestValue) and -[decodable](https://docs.rs/google-playablelocations3/5.0.3+20200707/google_playablelocations3/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-playablelocations3/5.0.3+20200707/google_playablelocations3/client::RequestValue) and +[decodable](https://docs.rs/google-playablelocations3/5.0.3+20200707/google_playablelocations3/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-playablelocations3/5.0.3+20200707/google_playablelocations3/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-playablelocations3/5.0.3+20200707/google_playablelocations3/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -176,7 +176,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **playablelocations3** library was generated by Sebastian Thiel, and is placed +The **playablelocations3** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/playablelocations3/src/api.rs b/gen/playablelocations3/src/api.rs index 007e6adfe5..1d63f7b21e 100644 --- a/gen/playablelocations3/src/api.rs +++ b/gen/playablelocations3/src/api.rs @@ -43,12 +43,12 @@ use crate::{client, client::GetToken, client::serde_with}; /// use std::default::Default; /// use playablelocations3::{PlayableLocations, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/playablelocations3/src/lib.rs b/gen/playablelocations3/src/lib.rs index a692e0ab0a..cbdfbb7188 100644 --- a/gen/playablelocations3/src/lib.rs +++ b/gen/playablelocations3/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/playablelocations3). //! # Features //! -//! Use the following functionality with ease from the central [hub](PlayableLocations) ... +//! Use the following functionality with ease from the central [hub](PlayableLocations) ... //! //! //! * [log impressions](api::MethodLogImpressionCall) @@ -51,8 +51,8 @@ //! let r = hub.methods().log_impressions(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -81,12 +81,12 @@ //! use std::default::Default; //! use playablelocations3::{PlayableLocations, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -127,10 +127,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -140,25 +140,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/playcustomapp1/README.md b/gen/playcustomapp1/README.md index b53ab6fe67..02ca9d4b46 100644 --- a/gen/playcustomapp1/README.md +++ b/gen/playcustomapp1/README.md @@ -11,7 +11,7 @@ Everything else about the *playcustomapp* *v1* API can be found at the [official documentation site](https://developers.google.com/android/work/play/custom-app-api/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-playcustomapp1/5.0.3+20230123/google_playcustomapp1/Playcustomapp) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-playcustomapp1/5.0.3+20230123/google_playcustomapp1/Playcustomapp) ... * accounts * [*custom apps create*](https://docs.rs/google-playcustomapp1/5.0.3+20230123/google_playcustomapp1/api::AccountCustomAppCreateCall) @@ -54,8 +54,8 @@ Or specifically ... let r = hub.accounts().custom_apps_create(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -84,12 +84,12 @@ use std::fs; use std::default::Default; use playcustomapp1::{Playcustomapp, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -130,10 +130,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-playcustomapp1/5.0.3+20230123/google_playcustomapp1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-playcustomapp1/5.0.3+20230123/google_playcustomapp1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -143,25 +143,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-playcu You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-playcustomapp1/5.0.3+20230123/google_playcustomapp1/client::Delegate) to the -[Method Builder](https://docs.rs/google-playcustomapp1/5.0.3+20230123/google_playcustomapp1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-playcustomapp1/5.0.3+20230123/google_playcustomapp1/client::Delegate) to the +[Method Builder](https://docs.rs/google-playcustomapp1/5.0.3+20230123/google_playcustomapp1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-playcustomapp1/5.0.3+20230123/google_playcustomapp1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-playcustomapp1/5.0.3+20230123/google_playcustomapp1/client::RequestValue) and -[decodable](https://docs.rs/google-playcustomapp1/5.0.3+20230123/google_playcustomapp1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-playcustomapp1/5.0.3+20230123/google_playcustomapp1/client::RequestValue) and +[decodable](https://docs.rs/google-playcustomapp1/5.0.3+20230123/google_playcustomapp1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-playcustomapp1/5.0.3+20230123/google_playcustomapp1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-playcustomapp1/5.0.3+20230123/google_playcustomapp1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -180,7 +180,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **playcustomapp1** library was generated by Sebastian Thiel, and is placed +The **playcustomapp1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/playcustomapp1/src/api.rs b/gen/playcustomapp1/src/api.rs index a0973f4273..691257f20f 100644 --- a/gen/playcustomapp1/src/api.rs +++ b/gen/playcustomapp1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your Google Play Developer account Androidpublisher, @@ -66,12 +66,12 @@ impl Default for Scope { /// use std::default::Default; /// use playcustomapp1::{Playcustomapp, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/playcustomapp1/src/lib.rs b/gen/playcustomapp1/src/lib.rs index a7822f392e..5689b57293 100644 --- a/gen/playcustomapp1/src/lib.rs +++ b/gen/playcustomapp1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/playcustomapp1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Playcustomapp) ... +//! Handle the following *Resources* with ease from the central [hub](Playcustomapp) ... //! //! * accounts //! * [*custom apps create*](api::AccountCustomAppCreateCall) @@ -54,8 +54,8 @@ //! let r = hub.accounts().custom_apps_create(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -85,12 +85,12 @@ //! use std::default::Default; //! use playcustomapp1::{Playcustomapp, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -131,10 +131,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -144,25 +144,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/playintegrity1/README.md b/gen/playintegrity1/README.md index 1d711f6dac..77a3e818a8 100644 --- a/gen/playintegrity1/README.md +++ b/gen/playintegrity1/README.md @@ -11,7 +11,7 @@ Everything else about the *Play Integrity* *v1* API can be found at the [official documentation site](https://developer.android.com/google/play/integrity). # Features -Use the following functionality with ease from the central [hub](https://docs.rs/google-playintegrity1/5.0.3+20230123/google_playintegrity1/PlayIntegrity) ... +Use the following functionality with ease from the central [hub](https://docs.rs/google-playintegrity1/5.0.3+20230123/google_playintegrity1/PlayIntegrity) ... * [decode integrity token](https://docs.rs/google-playintegrity1/5.0.3+20230123/google_playintegrity1/api::MethodDecodeIntegrityTokenCall) @@ -49,8 +49,8 @@ Or specifically ... let r = hub.methods().decode_integrity_token(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -78,12 +78,12 @@ use playintegrity1::{Result, Error}; use std::default::Default; use playintegrity1::{PlayIntegrity, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -124,10 +124,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-playintegrity1/5.0.3+20230123/google_playintegrity1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-playintegrity1/5.0.3+20230123/google_playintegrity1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -137,25 +137,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-playin You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-playintegrity1/5.0.3+20230123/google_playintegrity1/client::Delegate) to the -[Method Builder](https://docs.rs/google-playintegrity1/5.0.3+20230123/google_playintegrity1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-playintegrity1/5.0.3+20230123/google_playintegrity1/client::Delegate) to the +[Method Builder](https://docs.rs/google-playintegrity1/5.0.3+20230123/google_playintegrity1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-playintegrity1/5.0.3+20230123/google_playintegrity1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-playintegrity1/5.0.3+20230123/google_playintegrity1/client::RequestValue) and -[decodable](https://docs.rs/google-playintegrity1/5.0.3+20230123/google_playintegrity1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-playintegrity1/5.0.3+20230123/google_playintegrity1/client::RequestValue) and +[decodable](https://docs.rs/google-playintegrity1/5.0.3+20230123/google_playintegrity1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-playintegrity1/5.0.3+20230123/google_playintegrity1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-playintegrity1/5.0.3+20230123/google_playintegrity1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -174,7 +174,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **playintegrity1** library was generated by Sebastian Thiel, and is placed +The **playintegrity1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/playintegrity1/src/api.rs b/gen/playintegrity1/src/api.rs index 8bb2bd0e00..890296c78a 100644 --- a/gen/playintegrity1/src/api.rs +++ b/gen/playintegrity1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// Private Service: https://www.googleapis.com/auth/playintegrity Full, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use playintegrity1::{PlayIntegrity, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/playintegrity1/src/lib.rs b/gen/playintegrity1/src/lib.rs index b8aefe4ab6..6d5e9283a7 100644 --- a/gen/playintegrity1/src/lib.rs +++ b/gen/playintegrity1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/playintegrity1). //! # Features //! -//! Use the following functionality with ease from the central [hub](PlayIntegrity) ... +//! Use the following functionality with ease from the central [hub](PlayIntegrity) ... //! //! //! * [decode integrity token](api::MethodDecodeIntegrityTokenCall) @@ -49,8 +49,8 @@ //! let r = hub.methods().decode_integrity_token(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -79,12 +79,12 @@ //! use std::default::Default; //! use playintegrity1::{PlayIntegrity, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -125,10 +125,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -138,25 +138,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/playmoviespartner1/README.md b/gen/playmoviespartner1/README.md index a1410b2e05..7e02d92d4e 100644 --- a/gen/playmoviespartner1/README.md +++ b/gen/playmoviespartner1/README.md @@ -11,7 +11,7 @@ Everything else about the *Play Movies* *v1* API can be found at the [official documentation site](https://developers.google.com/playmoviespartner/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-playmoviespartner1/5.0.3+20170919/google_playmoviespartner1/PlayMovies) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-playmoviespartner1/5.0.3+20170919/google_playmoviespartner1/PlayMovies) ... * accounts * [*avails get*](https://docs.rs/google-playmoviespartner1/5.0.3+20170919/google_playmoviespartner1/api::AccountAvailGetCall), [*avails list*](https://docs.rs/google-playmoviespartner1/5.0.3+20170919/google_playmoviespartner1/api::AccountAvailListCall), [*orders get*](https://docs.rs/google-playmoviespartner1/5.0.3+20170919/google_playmoviespartner1/api::AccountOrderGetCall), [*orders list*](https://docs.rs/google-playmoviespartner1/5.0.3+20170919/google_playmoviespartner1/api::AccountOrderListCall), [*store infos country get*](https://docs.rs/google-playmoviespartner1/5.0.3+20170919/google_playmoviespartner1/api::AccountStoreInfoCountryGetCall) and [*store infos list*](https://docs.rs/google-playmoviespartner1/5.0.3+20170919/google_playmoviespartner1/api::AccountStoreInfoListCall) @@ -50,8 +50,8 @@ Or specifically ... let r = hub.accounts().avails_get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -78,12 +78,12 @@ use playmoviespartner1::{Result, Error}; use std::default::Default; use playmoviespartner1::{PlayMovies, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -119,10 +119,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-playmoviespartner1/5.0.3+20170919/google_playmoviespartner1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-playmoviespartner1/5.0.3+20170919/google_playmoviespartner1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -132,25 +132,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-playmo You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-playmoviespartner1/5.0.3+20170919/google_playmoviespartner1/client::Delegate) to the -[Method Builder](https://docs.rs/google-playmoviespartner1/5.0.3+20170919/google_playmoviespartner1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-playmoviespartner1/5.0.3+20170919/google_playmoviespartner1/client::Delegate) to the +[Method Builder](https://docs.rs/google-playmoviespartner1/5.0.3+20170919/google_playmoviespartner1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-playmoviespartner1/5.0.3+20170919/google_playmoviespartner1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-playmoviespartner1/5.0.3+20170919/google_playmoviespartner1/client::RequestValue) and -[decodable](https://docs.rs/google-playmoviespartner1/5.0.3+20170919/google_playmoviespartner1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-playmoviespartner1/5.0.3+20170919/google_playmoviespartner1/client::RequestValue) and +[decodable](https://docs.rs/google-playmoviespartner1/5.0.3+20170919/google_playmoviespartner1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-playmoviespartner1/5.0.3+20170919/google_playmoviespartner1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-playmoviespartner1/5.0.3+20170919/google_playmoviespartner1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -169,7 +169,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **playmoviespartner1** library was generated by Sebastian Thiel, and is placed +The **playmoviespartner1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/playmoviespartner1/src/api.rs b/gen/playmoviespartner1/src/api.rs index f8ce143c13..c583620f99 100644 --- a/gen/playmoviespartner1/src/api.rs +++ b/gen/playmoviespartner1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View the digital assets you publish on Google Play Movies and TV PlaymovyPartnerReadonly, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use playmoviespartner1::{PlayMovies, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/playmoviespartner1/src/lib.rs b/gen/playmoviespartner1/src/lib.rs index a62690f49b..781391c5ee 100644 --- a/gen/playmoviespartner1/src/lib.rs +++ b/gen/playmoviespartner1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/playmoviespartner1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](PlayMovies) ... +//! Handle the following *Resources* with ease from the central [hub](PlayMovies) ... //! //! * accounts //! * [*avails get*](api::AccountAvailGetCall), [*avails list*](api::AccountAvailListCall), [*orders get*](api::AccountOrderGetCall), [*orders list*](api::AccountOrderListCall), [*store infos country get*](api::AccountStoreInfoCountryGetCall) and [*store infos list*](api::AccountStoreInfoListCall) @@ -50,8 +50,8 @@ //! let r = hub.accounts().avails_get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -79,12 +79,12 @@ //! use std::default::Default; //! use playmoviespartner1::{PlayMovies, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -120,10 +120,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -133,25 +133,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/plus1/README.md b/gen/plus1/README.md index c44b59ea0c..e12f426ad3 100644 --- a/gen/plus1/README.md +++ b/gen/plus1/README.md @@ -11,7 +11,7 @@ Everything else about the *plus* *v1* API can be found at the [official documentation site](https://developers.google.com/+/api/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-plus1/5.0.3+20190616/google_plus1/Plus) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-plus1/5.0.3+20190616/google_plus1/Plus) ... * [activities](https://docs.rs/google-plus1/5.0.3+20190616/google_plus1/api::Activity) * [*get*](https://docs.rs/google-plus1/5.0.3+20190616/google_plus1/api::ActivityGetCall), [*list*](https://docs.rs/google-plus1/5.0.3+20190616/google_plus1/api::ActivityListCall) and [*search*](https://docs.rs/google-plus1/5.0.3+20190616/google_plus1/api::ActivitySearchCall) @@ -56,8 +56,8 @@ let r = hub.people().list_by_activity(...).doit().await let r = hub.people().search(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -84,12 +84,12 @@ use plus1::{Result, Error}; use std::default::Default; use plus1::{Plus, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -128,10 +128,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-plus1/5.0.3+20190616/google_plus1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-plus1/5.0.3+20190616/google_plus1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -141,25 +141,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-plus1/ You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-plus1/5.0.3+20190616/google_plus1/client::Delegate) to the -[Method Builder](https://docs.rs/google-plus1/5.0.3+20190616/google_plus1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-plus1/5.0.3+20190616/google_plus1/client::Delegate) to the +[Method Builder](https://docs.rs/google-plus1/5.0.3+20190616/google_plus1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-plus1/5.0.3+20190616/google_plus1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-plus1/5.0.3+20190616/google_plus1/client::RequestValue) and -[decodable](https://docs.rs/google-plus1/5.0.3+20190616/google_plus1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-plus1/5.0.3+20190616/google_plus1/client::RequestValue) and +[decodable](https://docs.rs/google-plus1/5.0.3+20190616/google_plus1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-plus1/5.0.3+20190616/google_plus1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-plus1/5.0.3+20190616/google_plus1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -178,7 +178,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **plus1** library was generated by Sebastian Thiel, and is placed +The **plus1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/plus1/src/api.rs b/gen/plus1/src/api.rs index 03613d8ff0..8bb152fbcb 100644 --- a/gen/plus1/src/api.rs +++ b/gen/plus1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View your basic profile info, including your age range and language Login, @@ -76,12 +76,12 @@ impl Default for Scope { /// use std::default::Default; /// use plus1::{Plus, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/plus1/src/lib.rs b/gen/plus1/src/lib.rs index 4adc45cf55..8f19974d96 100644 --- a/gen/plus1/src/lib.rs +++ b/gen/plus1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/plus1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Plus) ... +//! Handle the following *Resources* with ease from the central [hub](Plus) ... //! //! * [activities](api::Activity) //! * [*get*](api::ActivityGetCall), [*list*](api::ActivityListCall) and [*search*](api::ActivitySearchCall) @@ -56,8 +56,8 @@ //! let r = hub.people().search(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -85,12 +85,12 @@ //! use std::default::Default; //! use plus1::{Plus, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -129,10 +129,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -142,25 +142,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/plusdomains1/README.md b/gen/plusdomains1/README.md index 2c2efd531a..df24999734 100644 --- a/gen/plusdomains1/README.md +++ b/gen/plusdomains1/README.md @@ -11,7 +11,7 @@ Everything else about the *plusDomains* *v1* API can be found at the [official documentation site](https://developers.google.com/+/domains/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-plusdomains1/5.0.3+20190616/google_plusdomains1/PlusDomains) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-plusdomains1/5.0.3+20190616/google_plusdomains1/PlusDomains) ... * [activities](https://docs.rs/google-plusdomains1/5.0.3+20190616/google_plusdomains1/api::Activity) * [*get*](https://docs.rs/google-plusdomains1/5.0.3+20190616/google_plusdomains1/api::ActivityGetCall) and [*list*](https://docs.rs/google-plusdomains1/5.0.3+20190616/google_plusdomains1/api::ActivityListCall) @@ -65,8 +65,8 @@ let r = hub.comments().get(...).doit().await let r = hub.comments().list(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -93,12 +93,12 @@ use plusdomains1::{Result, Error}; use std::default::Default; use plusdomains1::{PlusDomains, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -137,10 +137,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-plusdomains1/5.0.3+20190616/google_plusdomains1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-plusdomains1/5.0.3+20190616/google_plusdomains1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -150,25 +150,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-plusdo You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-plusdomains1/5.0.3+20190616/google_plusdomains1/client::Delegate) to the -[Method Builder](https://docs.rs/google-plusdomains1/5.0.3+20190616/google_plusdomains1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-plusdomains1/5.0.3+20190616/google_plusdomains1/client::Delegate) to the +[Method Builder](https://docs.rs/google-plusdomains1/5.0.3+20190616/google_plusdomains1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-plusdomains1/5.0.3+20190616/google_plusdomains1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-plusdomains1/5.0.3+20190616/google_plusdomains1/client::RequestValue) and -[decodable](https://docs.rs/google-plusdomains1/5.0.3+20190616/google_plusdomains1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-plusdomains1/5.0.3+20190616/google_plusdomains1/client::RequestValue) and +[decodable](https://docs.rs/google-plusdomains1/5.0.3+20190616/google_plusdomains1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-plusdomains1/5.0.3+20190616/google_plusdomains1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-plusdomains1/5.0.3+20190616/google_plusdomains1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -187,7 +187,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **plusdomains1** library was generated by Sebastian Thiel, and is placed +The **plusdomains1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/plusdomains1/src/api.rs b/gen/plusdomains1/src/api.rs index 9224f4454b..1ca54c9aea 100644 --- a/gen/plusdomains1/src/api.rs +++ b/gen/plusdomains1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View your circles and the people and pages in them PluCircleRead, @@ -92,12 +92,12 @@ impl Default for Scope { /// use std::default::Default; /// use plusdomains1::{PlusDomains, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/plusdomains1/src/lib.rs b/gen/plusdomains1/src/lib.rs index 7c914fe7e8..766cdee7b2 100644 --- a/gen/plusdomains1/src/lib.rs +++ b/gen/plusdomains1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/plusdomains1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](PlusDomains) ... +//! Handle the following *Resources* with ease from the central [hub](PlusDomains) ... //! //! * [activities](api::Activity) //! * [*get*](api::ActivityGetCall) and [*list*](api::ActivityListCall) @@ -65,8 +65,8 @@ //! let r = hub.comments().list(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -94,12 +94,12 @@ //! use std::default::Default; //! use plusdomains1::{PlusDomains, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -138,10 +138,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -151,25 +151,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/policyanalyzer1/README.md b/gen/policyanalyzer1/README.md index 8ab50ce0a1..736ca7ddc0 100644 --- a/gen/policyanalyzer1/README.md +++ b/gen/policyanalyzer1/README.md @@ -11,7 +11,7 @@ Everything else about the *Policy Analyzer* *v1* API can be found at the [official documentation site](https://www.google.com). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-policyanalyzer1/5.0.3+20230122/google_policyanalyzer1/PolicyAnalyzer) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-policyanalyzer1/5.0.3+20230122/google_policyanalyzer1/PolicyAnalyzer) ... * projects * [*locations activity types activities query*](https://docs.rs/google-policyanalyzer1/5.0.3+20230122/google_policyanalyzer1/api::ProjectLocationActivityTypeActivityQueryCall) @@ -50,8 +50,8 @@ Or specifically ... let r = hub.projects().locations_activity_types_activities_query(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -78,12 +78,12 @@ use policyanalyzer1::{Result, Error}; use std::default::Default; use policyanalyzer1::{PolicyAnalyzer, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -122,10 +122,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-policyanalyzer1/5.0.3+20230122/google_policyanalyzer1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-policyanalyzer1/5.0.3+20230122/google_policyanalyzer1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -135,25 +135,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-policy You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-policyanalyzer1/5.0.3+20230122/google_policyanalyzer1/client::Delegate) to the -[Method Builder](https://docs.rs/google-policyanalyzer1/5.0.3+20230122/google_policyanalyzer1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-policyanalyzer1/5.0.3+20230122/google_policyanalyzer1/client::Delegate) to the +[Method Builder](https://docs.rs/google-policyanalyzer1/5.0.3+20230122/google_policyanalyzer1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-policyanalyzer1/5.0.3+20230122/google_policyanalyzer1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-policyanalyzer1/5.0.3+20230122/google_policyanalyzer1/client::RequestValue) and -[decodable](https://docs.rs/google-policyanalyzer1/5.0.3+20230122/google_policyanalyzer1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-policyanalyzer1/5.0.3+20230122/google_policyanalyzer1/client::RequestValue) and +[decodable](https://docs.rs/google-policyanalyzer1/5.0.3+20230122/google_policyanalyzer1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-policyanalyzer1/5.0.3+20230122/google_policyanalyzer1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-policyanalyzer1/5.0.3+20230122/google_policyanalyzer1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -172,7 +172,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **policyanalyzer1** library was generated by Sebastian Thiel, and is placed +The **policyanalyzer1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/policyanalyzer1/src/api.rs b/gen/policyanalyzer1/src/api.rs index 456b9d7fa4..a2602bfab6 100644 --- a/gen/policyanalyzer1/src/api.rs +++ b/gen/policyanalyzer1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use policyanalyzer1::{PolicyAnalyzer, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/policyanalyzer1/src/lib.rs b/gen/policyanalyzer1/src/lib.rs index 21a4bc10c8..85f9bfe4d3 100644 --- a/gen/policyanalyzer1/src/lib.rs +++ b/gen/policyanalyzer1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/policyanalyzer1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](PolicyAnalyzer) ... +//! Handle the following *Resources* with ease from the central [hub](PolicyAnalyzer) ... //! //! * projects //! * [*locations activity types activities query*](api::ProjectLocationActivityTypeActivityQueryCall) @@ -50,8 +50,8 @@ //! let r = hub.projects().locations_activity_types_activities_query(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -79,12 +79,12 @@ //! use std::default::Default; //! use policyanalyzer1::{PolicyAnalyzer, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -123,10 +123,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -136,25 +136,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/policysimulator1/README.md b/gen/policysimulator1/README.md index 351416a27d..f8865aae7a 100644 --- a/gen/policysimulator1/README.md +++ b/gen/policysimulator1/README.md @@ -11,7 +11,7 @@ Everything else about the *Policy Simulator* *v1* API can be found at the [official documentation site](https://cloud.google.com/iam/docs/simulating-access). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-policysimulator1/5.0.3+20230115/google_policysimulator1/PolicySimulator) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-policysimulator1/5.0.3+20230115/google_policysimulator1/PolicySimulator) ... * folders * [*locations replays create*](https://docs.rs/google-policysimulator1/5.0.3+20230115/google_policysimulator1/api::FolderLocationReplayCreateCall), [*locations replays get*](https://docs.rs/google-policysimulator1/5.0.3+20230115/google_policysimulator1/api::FolderLocationReplayGetCall), [*locations replays operations get*](https://docs.rs/google-policysimulator1/5.0.3+20230115/google_policysimulator1/api::FolderLocationReplayOperationGetCall), [*locations replays operations list*](https://docs.rs/google-policysimulator1/5.0.3+20230115/google_policysimulator1/api::FolderLocationReplayOperationListCall) and [*locations replays results list*](https://docs.rs/google-policysimulator1/5.0.3+20230115/google_policysimulator1/api::FolderLocationReplayResultListCall) @@ -62,8 +62,8 @@ let r = hub.projects().locations_replays_operations_get(...).doit().await let r = hub.projects().locations_replays_create(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -91,12 +91,12 @@ use policysimulator1::{Result, Error}; use std::default::Default; use policysimulator1::{PolicySimulator, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -137,10 +137,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-policysimulator1/5.0.3+20230115/google_policysimulator1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-policysimulator1/5.0.3+20230115/google_policysimulator1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -150,25 +150,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-policy You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-policysimulator1/5.0.3+20230115/google_policysimulator1/client::Delegate) to the -[Method Builder](https://docs.rs/google-policysimulator1/5.0.3+20230115/google_policysimulator1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-policysimulator1/5.0.3+20230115/google_policysimulator1/client::Delegate) to the +[Method Builder](https://docs.rs/google-policysimulator1/5.0.3+20230115/google_policysimulator1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-policysimulator1/5.0.3+20230115/google_policysimulator1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-policysimulator1/5.0.3+20230115/google_policysimulator1/client::RequestValue) and -[decodable](https://docs.rs/google-policysimulator1/5.0.3+20230115/google_policysimulator1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-policysimulator1/5.0.3+20230115/google_policysimulator1/client::RequestValue) and +[decodable](https://docs.rs/google-policysimulator1/5.0.3+20230115/google_policysimulator1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-policysimulator1/5.0.3+20230115/google_policysimulator1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-policysimulator1/5.0.3+20230115/google_policysimulator1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -187,7 +187,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **policysimulator1** library was generated by Sebastian Thiel, and is placed +The **policysimulator1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/policysimulator1/src/api.rs b/gen/policysimulator1/src/api.rs index af4eb5e9f1..1b99ab368c 100644 --- a/gen/policysimulator1/src/api.rs +++ b/gen/policysimulator1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use policysimulator1::{PolicySimulator, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/policysimulator1/src/lib.rs b/gen/policysimulator1/src/lib.rs index c15a0470ab..f3eceb74a0 100644 --- a/gen/policysimulator1/src/lib.rs +++ b/gen/policysimulator1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/policysimulator1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](PolicySimulator) ... +//! Handle the following *Resources* with ease from the central [hub](PolicySimulator) ... //! //! * folders //! * [*locations replays create*](api::FolderLocationReplayCreateCall), [*locations replays get*](api::FolderLocationReplayGetCall), [*locations replays operations get*](api::FolderLocationReplayOperationGetCall), [*locations replays operations list*](api::FolderLocationReplayOperationListCall) and [*locations replays results list*](api::FolderLocationReplayResultListCall) @@ -62,8 +62,8 @@ //! let r = hub.projects().locations_replays_create(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -92,12 +92,12 @@ //! use std::default::Default; //! use policysimulator1::{PolicySimulator, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -138,10 +138,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -151,25 +151,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/policytroubleshooter1/README.md b/gen/policytroubleshooter1/README.md index 16c4a8d13e..79b3f635d2 100644 --- a/gen/policytroubleshooter1/README.md +++ b/gen/policytroubleshooter1/README.md @@ -11,7 +11,7 @@ Everything else about the *Policy Troubleshooter* *v1* API can be found at the [official documentation site](https://cloud.google.com/iam/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-policytroubleshooter1/5.0.3+20230121/google_policytroubleshooter1/PolicyTroubleshooter) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-policytroubleshooter1/5.0.3+20230121/google_policytroubleshooter1/PolicyTroubleshooter) ... * iam * [*troubleshoot*](https://docs.rs/google-policytroubleshooter1/5.0.3+20230121/google_policytroubleshooter1/api::IamTroubleshootCall) @@ -50,8 +50,8 @@ Or specifically ... let r = hub.iam().troubleshoot(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -79,12 +79,12 @@ use policytroubleshooter1::{Result, Error}; use std::default::Default; use policytroubleshooter1::{PolicyTroubleshooter, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -125,10 +125,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-policytroubleshooter1/5.0.3+20230121/google_policytroubleshooter1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-policytroubleshooter1/5.0.3+20230121/google_policytroubleshooter1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -138,25 +138,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-policy You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-policytroubleshooter1/5.0.3+20230121/google_policytroubleshooter1/client::Delegate) to the -[Method Builder](https://docs.rs/google-policytroubleshooter1/5.0.3+20230121/google_policytroubleshooter1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-policytroubleshooter1/5.0.3+20230121/google_policytroubleshooter1/client::Delegate) to the +[Method Builder](https://docs.rs/google-policytroubleshooter1/5.0.3+20230121/google_policytroubleshooter1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-policytroubleshooter1/5.0.3+20230121/google_policytroubleshooter1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-policytroubleshooter1/5.0.3+20230121/google_policytroubleshooter1/client::RequestValue) and -[decodable](https://docs.rs/google-policytroubleshooter1/5.0.3+20230121/google_policytroubleshooter1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-policytroubleshooter1/5.0.3+20230121/google_policytroubleshooter1/client::RequestValue) and +[decodable](https://docs.rs/google-policytroubleshooter1/5.0.3+20230121/google_policytroubleshooter1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-policytroubleshooter1/5.0.3+20230121/google_policytroubleshooter1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-policytroubleshooter1/5.0.3+20230121/google_policytroubleshooter1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -175,7 +175,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **policytroubleshooter1** library was generated by Sebastian Thiel, and is placed +The **policytroubleshooter1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/policytroubleshooter1/src/api.rs b/gen/policytroubleshooter1/src/api.rs index ce1f3d2ff0..fbbaffcc67 100644 --- a/gen/policytroubleshooter1/src/api.rs +++ b/gen/policytroubleshooter1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use policytroubleshooter1::{PolicyTroubleshooter, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/policytroubleshooter1/src/lib.rs b/gen/policytroubleshooter1/src/lib.rs index dbef0efcc4..3bbfaa35bb 100644 --- a/gen/policytroubleshooter1/src/lib.rs +++ b/gen/policytroubleshooter1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/policytroubleshooter1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](PolicyTroubleshooter) ... +//! Handle the following *Resources* with ease from the central [hub](PolicyTroubleshooter) ... //! //! * iam //! * [*troubleshoot*](api::IamTroubleshootCall) @@ -50,8 +50,8 @@ //! let r = hub.iam().troubleshoot(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -80,12 +80,12 @@ //! use std::default::Default; //! use policytroubleshooter1::{PolicyTroubleshooter, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -126,10 +126,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -139,25 +139,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/prediction1d6/README.md b/gen/prediction1d6/README.md index 9a8da7ac5d..84e3d11c94 100644 --- a/gen/prediction1d6/README.md +++ b/gen/prediction1d6/README.md @@ -11,7 +11,7 @@ Everything else about the *prediction* *v1d6* API can be found at the [official documentation site](https://developers.google.com/prediction/docs/developer-guide). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-prediction1d6/5.0.3+20160511/google_prediction1d6/Prediction) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-prediction1d6/5.0.3+20160511/google_prediction1d6/Prediction) ... * hostedmodels * [*predict*](https://docs.rs/google-prediction1d6/5.0.3+20160511/google_prediction1d6/api::HostedmodelPredictCall) @@ -54,8 +54,8 @@ let r = hub.trainedmodels().insert(...).doit().await let r = hub.trainedmodels().update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -83,12 +83,12 @@ use prediction1d6::{Result, Error}; use std::default::Default; use prediction1d6::{Prediction, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -129,10 +129,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-prediction1d6/5.0.3+20160511/google_prediction1d6/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-prediction1d6/5.0.3+20160511/google_prediction1d6/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -142,25 +142,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-predic You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-prediction1d6/5.0.3+20160511/google_prediction1d6/client::Delegate) to the -[Method Builder](https://docs.rs/google-prediction1d6/5.0.3+20160511/google_prediction1d6/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-prediction1d6/5.0.3+20160511/google_prediction1d6/client::Delegate) to the +[Method Builder](https://docs.rs/google-prediction1d6/5.0.3+20160511/google_prediction1d6/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-prediction1d6/5.0.3+20160511/google_prediction1d6/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-prediction1d6/5.0.3+20160511/google_prediction1d6/client::RequestValue) and -[decodable](https://docs.rs/google-prediction1d6/5.0.3+20160511/google_prediction1d6/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-prediction1d6/5.0.3+20160511/google_prediction1d6/client::RequestValue) and +[decodable](https://docs.rs/google-prediction1d6/5.0.3+20160511/google_prediction1d6/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-prediction1d6/5.0.3+20160511/google_prediction1d6/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-prediction1d6/5.0.3+20160511/google_prediction1d6/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -179,7 +179,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **prediction1d6** library was generated by Sebastian Thiel, and is placed +The **prediction1d6** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/prediction1d6/src/api.rs b/gen/prediction1d6/src/api.rs index ddf567c158..4a4fafe4a8 100644 --- a/gen/prediction1d6/src/api.rs +++ b/gen/prediction1d6/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your data across Google Cloud Platform services CloudPlatform, @@ -81,12 +81,12 @@ impl Default for Scope { /// use std::default::Default; /// use prediction1d6::{Prediction, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/prediction1d6/src/lib.rs b/gen/prediction1d6/src/lib.rs index aa62f115c9..6d0f9a0f58 100644 --- a/gen/prediction1d6/src/lib.rs +++ b/gen/prediction1d6/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/prediction1d6). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Prediction) ... +//! Handle the following *Resources* with ease from the central [hub](Prediction) ... //! //! * hostedmodels //! * [*predict*](api::HostedmodelPredictCall) @@ -54,8 +54,8 @@ //! let r = hub.trainedmodels().update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -84,12 +84,12 @@ //! use std::default::Default; //! use prediction1d6::{Prediction, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -130,10 +130,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -143,25 +143,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/privateca1/README.md b/gen/privateca1/README.md index 004cd20c4d..109e840dd3 100644 --- a/gen/privateca1/README.md +++ b/gen/privateca1/README.md @@ -11,7 +11,7 @@ Everything else about the *Certificate Authority Service* *v1* API can be found [official documentation site](https://cloud.google.com/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/CertificateAuthorityService) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/CertificateAuthorityService) ... * projects * [*locations ca pools certificate authorities activate*](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/api::ProjectLocationCaPoolCertificateAuthorityActivateCall), [*locations ca pools certificate authorities certificate revocation lists get*](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/api::ProjectLocationCaPoolCertificateAuthorityCertificateRevocationListGetCall), [*locations ca pools certificate authorities certificate revocation lists get iam policy*](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/api::ProjectLocationCaPoolCertificateAuthorityCertificateRevocationListGetIamPolicyCall), [*locations ca pools certificate authorities certificate revocation lists list*](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/api::ProjectLocationCaPoolCertificateAuthorityCertificateRevocationListListCall), [*locations ca pools certificate authorities certificate revocation lists patch*](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/api::ProjectLocationCaPoolCertificateAuthorityCertificateRevocationListPatchCall), [*locations ca pools certificate authorities certificate revocation lists set iam policy*](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/api::ProjectLocationCaPoolCertificateAuthorityCertificateRevocationListSetIamPolicyCall), [*locations ca pools certificate authorities certificate revocation lists test iam permissions*](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/api::ProjectLocationCaPoolCertificateAuthorityCertificateRevocationListTestIamPermissionCall), [*locations ca pools certificate authorities create*](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/api::ProjectLocationCaPoolCertificateAuthorityCreateCall), [*locations ca pools certificate authorities delete*](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/api::ProjectLocationCaPoolCertificateAuthorityDeleteCall), [*locations ca pools certificate authorities disable*](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/api::ProjectLocationCaPoolCertificateAuthorityDisableCall), [*locations ca pools certificate authorities enable*](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/api::ProjectLocationCaPoolCertificateAuthorityEnableCall), [*locations ca pools certificate authorities fetch*](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/api::ProjectLocationCaPoolCertificateAuthorityFetchCall), [*locations ca pools certificate authorities get*](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/api::ProjectLocationCaPoolCertificateAuthorityGetCall), [*locations ca pools certificate authorities list*](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/api::ProjectLocationCaPoolCertificateAuthorityListCall), [*locations ca pools certificate authorities patch*](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/api::ProjectLocationCaPoolCertificateAuthorityPatchCall), [*locations ca pools certificate authorities undelete*](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/api::ProjectLocationCaPoolCertificateAuthorityUndeleteCall), [*locations ca pools certificates create*](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/api::ProjectLocationCaPoolCertificateCreateCall), [*locations ca pools certificates get*](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/api::ProjectLocationCaPoolCertificateGetCall), [*locations ca pools certificates list*](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/api::ProjectLocationCaPoolCertificateListCall), [*locations ca pools certificates patch*](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/api::ProjectLocationCaPoolCertificatePatchCall), [*locations ca pools certificates revoke*](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/api::ProjectLocationCaPoolCertificateRevokeCall), [*locations ca pools create*](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/api::ProjectLocationCaPoolCreateCall), [*locations ca pools delete*](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/api::ProjectLocationCaPoolDeleteCall), [*locations ca pools fetch ca certs*](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/api::ProjectLocationCaPoolFetchCaCertCall), [*locations ca pools get*](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/api::ProjectLocationCaPoolGetCall), [*locations ca pools get iam policy*](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/api::ProjectLocationCaPoolGetIamPolicyCall), [*locations ca pools list*](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/api::ProjectLocationCaPoolListCall), [*locations ca pools patch*](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/api::ProjectLocationCaPoolPatchCall), [*locations ca pools set iam policy*](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/api::ProjectLocationCaPoolSetIamPolicyCall), [*locations ca pools test iam permissions*](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/api::ProjectLocationCaPoolTestIamPermissionCall), [*locations certificate templates create*](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/api::ProjectLocationCertificateTemplateCreateCall), [*locations certificate templates delete*](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/api::ProjectLocationCertificateTemplateDeleteCall), [*locations certificate templates get*](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/api::ProjectLocationCertificateTemplateGetCall), [*locations certificate templates get iam policy*](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/api::ProjectLocationCertificateTemplateGetIamPolicyCall), [*locations certificate templates list*](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/api::ProjectLocationCertificateTemplateListCall), [*locations certificate templates patch*](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/api::ProjectLocationCertificateTemplatePatchCall), [*locations certificate templates set iam policy*](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/api::ProjectLocationCertificateTemplateSetIamPolicyCall), [*locations certificate templates test iam permissions*](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/api::ProjectLocationCertificateTemplateTestIamPermissionCall), [*locations get*](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/api::ProjectLocationGetCall), [*locations list*](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/api::ProjectLocationListCall), [*locations operations cancel*](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/api::ProjectLocationOperationCancelCall), [*locations operations delete*](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/api::ProjectLocationOperationDeleteCall), [*locations operations get*](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/api::ProjectLocationOperationGetCall) and [*locations operations list*](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/api::ProjectLocationOperationListCall) @@ -64,8 +64,8 @@ let r = hub.projects().locations_certificate_templates_patch(...).doit().await let r = hub.projects().locations_operations_get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -93,12 +93,12 @@ use privateca1::{Result, Error}; use std::default::Default; use privateca1::{CertificateAuthorityService, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -141,10 +141,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -154,25 +154,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-privat You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/client::Delegate) to the -[Method Builder](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/client::Delegate) to the +[Method Builder](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/client::RequestValue) and -[decodable](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/client::RequestValue) and +[decodable](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-privateca1/5.0.3+20230105/google_privateca1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -191,7 +191,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **privateca1** library was generated by Sebastian Thiel, and is placed +The **privateca1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/privateca1/src/api.rs b/gen/privateca1/src/api.rs index 33d885c4a9..9c36f79de6 100644 --- a/gen/privateca1/src/api.rs +++ b/gen/privateca1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use privateca1::{CertificateAuthorityService, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/privateca1/src/lib.rs b/gen/privateca1/src/lib.rs index 34d5321bb5..eabe216859 100644 --- a/gen/privateca1/src/lib.rs +++ b/gen/privateca1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/privateca1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CertificateAuthorityService) ... +//! Handle the following *Resources* with ease from the central [hub](CertificateAuthorityService) ... //! //! * projects //! * [*locations ca pools certificate authorities activate*](api::ProjectLocationCaPoolCertificateAuthorityActivateCall), [*locations ca pools certificate authorities certificate revocation lists get*](api::ProjectLocationCaPoolCertificateAuthorityCertificateRevocationListGetCall), [*locations ca pools certificate authorities certificate revocation lists get iam policy*](api::ProjectLocationCaPoolCertificateAuthorityCertificateRevocationListGetIamPolicyCall), [*locations ca pools certificate authorities certificate revocation lists list*](api::ProjectLocationCaPoolCertificateAuthorityCertificateRevocationListListCall), [*locations ca pools certificate authorities certificate revocation lists patch*](api::ProjectLocationCaPoolCertificateAuthorityCertificateRevocationListPatchCall), [*locations ca pools certificate authorities certificate revocation lists set iam policy*](api::ProjectLocationCaPoolCertificateAuthorityCertificateRevocationListSetIamPolicyCall), [*locations ca pools certificate authorities certificate revocation lists test iam permissions*](api::ProjectLocationCaPoolCertificateAuthorityCertificateRevocationListTestIamPermissionCall), [*locations ca pools certificate authorities create*](api::ProjectLocationCaPoolCertificateAuthorityCreateCall), [*locations ca pools certificate authorities delete*](api::ProjectLocationCaPoolCertificateAuthorityDeleteCall), [*locations ca pools certificate authorities disable*](api::ProjectLocationCaPoolCertificateAuthorityDisableCall), [*locations ca pools certificate authorities enable*](api::ProjectLocationCaPoolCertificateAuthorityEnableCall), [*locations ca pools certificate authorities fetch*](api::ProjectLocationCaPoolCertificateAuthorityFetchCall), [*locations ca pools certificate authorities get*](api::ProjectLocationCaPoolCertificateAuthorityGetCall), [*locations ca pools certificate authorities list*](api::ProjectLocationCaPoolCertificateAuthorityListCall), [*locations ca pools certificate authorities patch*](api::ProjectLocationCaPoolCertificateAuthorityPatchCall), [*locations ca pools certificate authorities undelete*](api::ProjectLocationCaPoolCertificateAuthorityUndeleteCall), [*locations ca pools certificates create*](api::ProjectLocationCaPoolCertificateCreateCall), [*locations ca pools certificates get*](api::ProjectLocationCaPoolCertificateGetCall), [*locations ca pools certificates list*](api::ProjectLocationCaPoolCertificateListCall), [*locations ca pools certificates patch*](api::ProjectLocationCaPoolCertificatePatchCall), [*locations ca pools certificates revoke*](api::ProjectLocationCaPoolCertificateRevokeCall), [*locations ca pools create*](api::ProjectLocationCaPoolCreateCall), [*locations ca pools delete*](api::ProjectLocationCaPoolDeleteCall), [*locations ca pools fetch ca certs*](api::ProjectLocationCaPoolFetchCaCertCall), [*locations ca pools get*](api::ProjectLocationCaPoolGetCall), [*locations ca pools get iam policy*](api::ProjectLocationCaPoolGetIamPolicyCall), [*locations ca pools list*](api::ProjectLocationCaPoolListCall), [*locations ca pools patch*](api::ProjectLocationCaPoolPatchCall), [*locations ca pools set iam policy*](api::ProjectLocationCaPoolSetIamPolicyCall), [*locations ca pools test iam permissions*](api::ProjectLocationCaPoolTestIamPermissionCall), [*locations certificate templates create*](api::ProjectLocationCertificateTemplateCreateCall), [*locations certificate templates delete*](api::ProjectLocationCertificateTemplateDeleteCall), [*locations certificate templates get*](api::ProjectLocationCertificateTemplateGetCall), [*locations certificate templates get iam policy*](api::ProjectLocationCertificateTemplateGetIamPolicyCall), [*locations certificate templates list*](api::ProjectLocationCertificateTemplateListCall), [*locations certificate templates patch*](api::ProjectLocationCertificateTemplatePatchCall), [*locations certificate templates set iam policy*](api::ProjectLocationCertificateTemplateSetIamPolicyCall), [*locations certificate templates test iam permissions*](api::ProjectLocationCertificateTemplateTestIamPermissionCall), [*locations get*](api::ProjectLocationGetCall), [*locations list*](api::ProjectLocationListCall), [*locations operations cancel*](api::ProjectLocationOperationCancelCall), [*locations operations delete*](api::ProjectLocationOperationDeleteCall), [*locations operations get*](api::ProjectLocationOperationGetCall) and [*locations operations list*](api::ProjectLocationOperationListCall) @@ -64,8 +64,8 @@ //! let r = hub.projects().locations_operations_get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -94,12 +94,12 @@ //! use std::default::Default; //! use privateca1::{CertificateAuthorityService, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -142,10 +142,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -155,25 +155,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/privateca1_beta1/README.md b/gen/privateca1_beta1/README.md index e213eed746..25eda9ea5a 100644 --- a/gen/privateca1_beta1/README.md +++ b/gen/privateca1_beta1/README.md @@ -11,7 +11,7 @@ Everything else about the *Certificate Authority Service* *v1_beta1* API can be [official documentation site](https://cloud.google.com/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/CertificateAuthorityService) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/CertificateAuthorityService) ... * projects * [*locations certificate authorities activate*](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/api::ProjectLocationCertificateAuthorityActivateCall), [*locations certificate authorities certificate revocation lists get*](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/api::ProjectLocationCertificateAuthorityCertificateRevocationListGetCall), [*locations certificate authorities certificate revocation lists get iam policy*](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/api::ProjectLocationCertificateAuthorityCertificateRevocationListGetIamPolicyCall), [*locations certificate authorities certificate revocation lists list*](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/api::ProjectLocationCertificateAuthorityCertificateRevocationListListCall), [*locations certificate authorities certificate revocation lists patch*](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/api::ProjectLocationCertificateAuthorityCertificateRevocationListPatchCall), [*locations certificate authorities certificate revocation lists set iam policy*](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/api::ProjectLocationCertificateAuthorityCertificateRevocationListSetIamPolicyCall), [*locations certificate authorities certificate revocation lists test iam permissions*](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/api::ProjectLocationCertificateAuthorityCertificateRevocationListTestIamPermissionCall), [*locations certificate authorities certificates create*](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/api::ProjectLocationCertificateAuthorityCertificateCreateCall), [*locations certificate authorities certificates get*](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/api::ProjectLocationCertificateAuthorityCertificateGetCall), [*locations certificate authorities certificates list*](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/api::ProjectLocationCertificateAuthorityCertificateListCall), [*locations certificate authorities certificates patch*](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/api::ProjectLocationCertificateAuthorityCertificatePatchCall), [*locations certificate authorities certificates revoke*](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/api::ProjectLocationCertificateAuthorityCertificateRevokeCall), [*locations certificate authorities create*](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/api::ProjectLocationCertificateAuthorityCreateCall), [*locations certificate authorities disable*](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/api::ProjectLocationCertificateAuthorityDisableCall), [*locations certificate authorities enable*](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/api::ProjectLocationCertificateAuthorityEnableCall), [*locations certificate authorities fetch*](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/api::ProjectLocationCertificateAuthorityFetchCall), [*locations certificate authorities get*](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/api::ProjectLocationCertificateAuthorityGetCall), [*locations certificate authorities get iam policy*](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/api::ProjectLocationCertificateAuthorityGetIamPolicyCall), [*locations certificate authorities list*](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/api::ProjectLocationCertificateAuthorityListCall), [*locations certificate authorities patch*](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/api::ProjectLocationCertificateAuthorityPatchCall), [*locations certificate authorities restore*](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/api::ProjectLocationCertificateAuthorityRestoreCall), [*locations certificate authorities schedule delete*](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/api::ProjectLocationCertificateAuthorityScheduleDeleteCall), [*locations certificate authorities set iam policy*](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/api::ProjectLocationCertificateAuthoritySetIamPolicyCall), [*locations certificate authorities test iam permissions*](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/api::ProjectLocationCertificateAuthorityTestIamPermissionCall), [*locations get*](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/api::ProjectLocationGetCall), [*locations list*](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/api::ProjectLocationListCall), [*locations operations cancel*](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/api::ProjectLocationOperationCancelCall), [*locations operations delete*](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/api::ProjectLocationOperationDeleteCall), [*locations operations get*](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/api::ProjectLocationOperationGetCall), [*locations operations list*](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/api::ProjectLocationOperationListCall), [*locations reusable configs get*](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/api::ProjectLocationReusableConfigGetCall), [*locations reusable configs get iam policy*](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/api::ProjectLocationReusableConfigGetIamPolicyCall), [*locations reusable configs list*](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/api::ProjectLocationReusableConfigListCall), [*locations reusable configs set iam policy*](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/api::ProjectLocationReusableConfigSetIamPolicyCall) and [*locations reusable configs test iam permissions*](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/api::ProjectLocationReusableConfigTestIamPermissionCall) @@ -58,8 +58,8 @@ let r = hub.projects().locations_certificate_authorities_schedule_delete(...).do let r = hub.projects().locations_operations_get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -87,12 +87,12 @@ use privateca1_beta1::{Result, Error}; use std::default::Default; use privateca1_beta1::{CertificateAuthorityService, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -135,10 +135,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -148,25 +148,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-privat You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/client::Delegate) to the -[Method Builder](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/client::Delegate) to the +[Method Builder](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/client::RequestValue) and -[decodable](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/client::RequestValue) and +[decodable](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-privateca1_beta1/5.0.3+20230105/google_privateca1_beta1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -185,7 +185,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **privateca1_beta1** library was generated by Sebastian Thiel, and is placed +The **privateca1_beta1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/privateca1_beta1/src/api.rs b/gen/privateca1_beta1/src/api.rs index 182622435a..2e5ca01003 100644 --- a/gen/privateca1_beta1/src/api.rs +++ b/gen/privateca1_beta1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use privateca1_beta1::{CertificateAuthorityService, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/privateca1_beta1/src/lib.rs b/gen/privateca1_beta1/src/lib.rs index 9eab014800..d2f15960cc 100644 --- a/gen/privateca1_beta1/src/lib.rs +++ b/gen/privateca1_beta1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/privateca1_beta1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CertificateAuthorityService) ... +//! Handle the following *Resources* with ease from the central [hub](CertificateAuthorityService) ... //! //! * projects //! * [*locations certificate authorities activate*](api::ProjectLocationCertificateAuthorityActivateCall), [*locations certificate authorities certificate revocation lists get*](api::ProjectLocationCertificateAuthorityCertificateRevocationListGetCall), [*locations certificate authorities certificate revocation lists get iam policy*](api::ProjectLocationCertificateAuthorityCertificateRevocationListGetIamPolicyCall), [*locations certificate authorities certificate revocation lists list*](api::ProjectLocationCertificateAuthorityCertificateRevocationListListCall), [*locations certificate authorities certificate revocation lists patch*](api::ProjectLocationCertificateAuthorityCertificateRevocationListPatchCall), [*locations certificate authorities certificate revocation lists set iam policy*](api::ProjectLocationCertificateAuthorityCertificateRevocationListSetIamPolicyCall), [*locations certificate authorities certificate revocation lists test iam permissions*](api::ProjectLocationCertificateAuthorityCertificateRevocationListTestIamPermissionCall), [*locations certificate authorities certificates create*](api::ProjectLocationCertificateAuthorityCertificateCreateCall), [*locations certificate authorities certificates get*](api::ProjectLocationCertificateAuthorityCertificateGetCall), [*locations certificate authorities certificates list*](api::ProjectLocationCertificateAuthorityCertificateListCall), [*locations certificate authorities certificates patch*](api::ProjectLocationCertificateAuthorityCertificatePatchCall), [*locations certificate authorities certificates revoke*](api::ProjectLocationCertificateAuthorityCertificateRevokeCall), [*locations certificate authorities create*](api::ProjectLocationCertificateAuthorityCreateCall), [*locations certificate authorities disable*](api::ProjectLocationCertificateAuthorityDisableCall), [*locations certificate authorities enable*](api::ProjectLocationCertificateAuthorityEnableCall), [*locations certificate authorities fetch*](api::ProjectLocationCertificateAuthorityFetchCall), [*locations certificate authorities get*](api::ProjectLocationCertificateAuthorityGetCall), [*locations certificate authorities get iam policy*](api::ProjectLocationCertificateAuthorityGetIamPolicyCall), [*locations certificate authorities list*](api::ProjectLocationCertificateAuthorityListCall), [*locations certificate authorities patch*](api::ProjectLocationCertificateAuthorityPatchCall), [*locations certificate authorities restore*](api::ProjectLocationCertificateAuthorityRestoreCall), [*locations certificate authorities schedule delete*](api::ProjectLocationCertificateAuthorityScheduleDeleteCall), [*locations certificate authorities set iam policy*](api::ProjectLocationCertificateAuthoritySetIamPolicyCall), [*locations certificate authorities test iam permissions*](api::ProjectLocationCertificateAuthorityTestIamPermissionCall), [*locations get*](api::ProjectLocationGetCall), [*locations list*](api::ProjectLocationListCall), [*locations operations cancel*](api::ProjectLocationOperationCancelCall), [*locations operations delete*](api::ProjectLocationOperationDeleteCall), [*locations operations get*](api::ProjectLocationOperationGetCall), [*locations operations list*](api::ProjectLocationOperationListCall), [*locations reusable configs get*](api::ProjectLocationReusableConfigGetCall), [*locations reusable configs get iam policy*](api::ProjectLocationReusableConfigGetIamPolicyCall), [*locations reusable configs list*](api::ProjectLocationReusableConfigListCall), [*locations reusable configs set iam policy*](api::ProjectLocationReusableConfigSetIamPolicyCall) and [*locations reusable configs test iam permissions*](api::ProjectLocationReusableConfigTestIamPermissionCall) @@ -58,8 +58,8 @@ //! let r = hub.projects().locations_operations_get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -88,12 +88,12 @@ //! use std::default::Default; //! use privateca1_beta1::{CertificateAuthorityService, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -136,10 +136,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -149,25 +149,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/prod_tt_sasportal1_alpha1/README.md b/gen/prod_tt_sasportal1_alpha1/README.md index 54d934b967..697218ae37 100644 --- a/gen/prod_tt_sasportal1_alpha1/README.md +++ b/gen/prod_tt_sasportal1_alpha1/README.md @@ -11,7 +11,7 @@ Everything else about the *SAS Portal Testing* *v1_alpha1* API can be found at t [official documentation site](https://developers.google.com/spectrum-access-system/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/SASPortalTesting) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/SASPortalTesting) ... * customers * [*deployments create*](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/api::CustomerDeploymentCreateCall), [*deployments delete*](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/api::CustomerDeploymentDeleteCall), [*deployments devices create*](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/api::CustomerDeploymentDeviceCreateCall), [*deployments devices create signed*](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/api::CustomerDeploymentDeviceCreateSignedCall), [*deployments devices list*](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/api::CustomerDeploymentDeviceListCall), [*deployments get*](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/api::CustomerDeploymentGetCall), [*deployments list*](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/api::CustomerDeploymentListCall), [*deployments move*](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/api::CustomerDeploymentMoveCall), [*deployments patch*](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/api::CustomerDeploymentPatchCall), [*devices create*](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/api::CustomerDeviceCreateCall), [*devices create signed*](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/api::CustomerDeviceCreateSignedCall), [*devices delete*](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/api::CustomerDeviceDeleteCall), [*devices get*](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/api::CustomerDeviceGetCall), [*devices list*](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/api::CustomerDeviceListCall), [*devices move*](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/api::CustomerDeviceMoveCall), [*devices patch*](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/api::CustomerDevicePatchCall), [*devices sign device*](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/api::CustomerDeviceSignDeviceCall), [*devices update signed*](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/api::CustomerDeviceUpdateSignedCall), [*get*](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/api::CustomerGetCall), [*list*](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/api::CustomerListCall), [*nodes create*](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/api::CustomerNodeCreateCall), [*nodes delete*](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/api::CustomerNodeDeleteCall), [*nodes deployments create*](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/api::CustomerNodeDeploymentCreateCall), [*nodes deployments list*](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/api::CustomerNodeDeploymentListCall), [*nodes devices create*](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/api::CustomerNodeDeviceCreateCall), [*nodes devices create signed*](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/api::CustomerNodeDeviceCreateSignedCall), [*nodes devices list*](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/api::CustomerNodeDeviceListCall), [*nodes get*](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/api::CustomerNodeGetCall), [*nodes list*](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/api::CustomerNodeListCall), [*nodes move*](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/api::CustomerNodeMoveCall), [*nodes nodes create*](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/api::CustomerNodeNodeCreateCall), [*nodes nodes list*](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/api::CustomerNodeNodeListCall), [*nodes patch*](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/api::CustomerNodePatchCall) and [*patch*](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/api::CustomerPatchCall) @@ -78,8 +78,8 @@ let r = hub.nodes().nodes_devices_create(...).doit().await let r = hub.nodes().nodes_devices_create_signed(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -107,12 +107,12 @@ use prod_tt_sasportal1_alpha1::{Result, Error}; use std::default::Default; use prod_tt_sasportal1_alpha1::{SASPortalTesting, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -154,10 +154,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -167,25 +167,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-prod_t You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/client::Delegate) to the -[Method Builder](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/client::Delegate) to the +[Method Builder](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/client::RequestValue) and -[decodable](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/client::RequestValue) and +[decodable](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-prod_tt_sasportal1_alpha1/5.0.3+20230121/google_prod_tt_sasportal1_alpha1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -204,7 +204,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **prod_tt_sasportal1_alpha1** library was generated by Sebastian Thiel, and is placed +The **prod_tt_sasportal1_alpha1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/prod_tt_sasportal1_alpha1/src/api.rs b/gen/prod_tt_sasportal1_alpha1/src/api.rs index d4f9e9cdb4..bbe40ee811 100644 --- a/gen/prod_tt_sasportal1_alpha1/src/api.rs +++ b/gen/prod_tt_sasportal1_alpha1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// Read, create, update, and delete your SAS Portal data. Sasportal, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use prod_tt_sasportal1_alpha1::{SASPortalTesting, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/prod_tt_sasportal1_alpha1/src/lib.rs b/gen/prod_tt_sasportal1_alpha1/src/lib.rs index fc017c3612..0abb192a6a 100644 --- a/gen/prod_tt_sasportal1_alpha1/src/lib.rs +++ b/gen/prod_tt_sasportal1_alpha1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/prod_tt_sasportal1_alpha1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](SASPortalTesting) ... +//! Handle the following *Resources* with ease from the central [hub](SASPortalTesting) ... //! //! * customers //! * [*deployments create*](api::CustomerDeploymentCreateCall), [*deployments delete*](api::CustomerDeploymentDeleteCall), [*deployments devices create*](api::CustomerDeploymentDeviceCreateCall), [*deployments devices create signed*](api::CustomerDeploymentDeviceCreateSignedCall), [*deployments devices list*](api::CustomerDeploymentDeviceListCall), [*deployments get*](api::CustomerDeploymentGetCall), [*deployments list*](api::CustomerDeploymentListCall), [*deployments move*](api::CustomerDeploymentMoveCall), [*deployments patch*](api::CustomerDeploymentPatchCall), [*devices create*](api::CustomerDeviceCreateCall), [*devices create signed*](api::CustomerDeviceCreateSignedCall), [*devices delete*](api::CustomerDeviceDeleteCall), [*devices get*](api::CustomerDeviceGetCall), [*devices list*](api::CustomerDeviceListCall), [*devices move*](api::CustomerDeviceMoveCall), [*devices patch*](api::CustomerDevicePatchCall), [*devices sign device*](api::CustomerDeviceSignDeviceCall), [*devices update signed*](api::CustomerDeviceUpdateSignedCall), [*get*](api::CustomerGetCall), [*list*](api::CustomerListCall), [*nodes create*](api::CustomerNodeCreateCall), [*nodes delete*](api::CustomerNodeDeleteCall), [*nodes deployments create*](api::CustomerNodeDeploymentCreateCall), [*nodes deployments list*](api::CustomerNodeDeploymentListCall), [*nodes devices create*](api::CustomerNodeDeviceCreateCall), [*nodes devices create signed*](api::CustomerNodeDeviceCreateSignedCall), [*nodes devices list*](api::CustomerNodeDeviceListCall), [*nodes get*](api::CustomerNodeGetCall), [*nodes list*](api::CustomerNodeListCall), [*nodes move*](api::CustomerNodeMoveCall), [*nodes nodes create*](api::CustomerNodeNodeCreateCall), [*nodes nodes list*](api::CustomerNodeNodeListCall), [*nodes patch*](api::CustomerNodePatchCall) and [*patch*](api::CustomerPatchCall) @@ -78,8 +78,8 @@ //! let r = hub.nodes().nodes_devices_create_signed(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -108,12 +108,12 @@ //! use std::default::Default; //! use prod_tt_sasportal1_alpha1::{SASPortalTesting, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -155,10 +155,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -168,25 +168,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/proximitybeacon1_beta1/README.md b/gen/proximitybeacon1_beta1/README.md index 2873396c38..8dcb4c672f 100644 --- a/gen/proximitybeacon1_beta1/README.md +++ b/gen/proximitybeacon1_beta1/README.md @@ -11,7 +11,7 @@ Everything else about the *proximitybeacon* *v1_beta1* API can be found at the [official documentation site](https://developers.google.com/beacons/proximity/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-proximitybeacon1_beta1/5.0.3+20200127/google_proximitybeacon1_beta1/Proximitybeacon) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-proximitybeacon1_beta1/5.0.3+20200127/google_proximitybeacon1_beta1/Proximitybeacon) ... * beaconinfo * [*getforobserved*](https://docs.rs/google-proximitybeacon1_beta1/5.0.3+20200127/google_proximitybeacon1_beta1/api::BeaconinfoGetforobservedCall) @@ -69,8 +69,8 @@ let r = hub.beacons().register(...).doit().await let r = hub.beacons().update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -97,12 +97,12 @@ use proximitybeacon1_beta1::{Result, Error}; use std::default::Default; use proximitybeacon1_beta1::{Proximitybeacon, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -142,10 +142,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-proximitybeacon1_beta1/5.0.3+20200127/google_proximitybeacon1_beta1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-proximitybeacon1_beta1/5.0.3+20200127/google_proximitybeacon1_beta1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -155,25 +155,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-proxim You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-proximitybeacon1_beta1/5.0.3+20200127/google_proximitybeacon1_beta1/client::Delegate) to the -[Method Builder](https://docs.rs/google-proximitybeacon1_beta1/5.0.3+20200127/google_proximitybeacon1_beta1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-proximitybeacon1_beta1/5.0.3+20200127/google_proximitybeacon1_beta1/client::Delegate) to the +[Method Builder](https://docs.rs/google-proximitybeacon1_beta1/5.0.3+20200127/google_proximitybeacon1_beta1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-proximitybeacon1_beta1/5.0.3+20200127/google_proximitybeacon1_beta1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-proximitybeacon1_beta1/5.0.3+20200127/google_proximitybeacon1_beta1/client::RequestValue) and -[decodable](https://docs.rs/google-proximitybeacon1_beta1/5.0.3+20200127/google_proximitybeacon1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-proximitybeacon1_beta1/5.0.3+20200127/google_proximitybeacon1_beta1/client::RequestValue) and +[decodable](https://docs.rs/google-proximitybeacon1_beta1/5.0.3+20200127/google_proximitybeacon1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-proximitybeacon1_beta1/5.0.3+20200127/google_proximitybeacon1_beta1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-proximitybeacon1_beta1/5.0.3+20200127/google_proximitybeacon1_beta1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -192,7 +192,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **proximitybeacon1_beta1** library was generated by Sebastian Thiel, and is placed +The **proximitybeacon1_beta1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/proximitybeacon1_beta1/src/api.rs b/gen/proximitybeacon1_beta1/src/api.rs index 3235a5c9c8..0e2a140141 100644 --- a/gen/proximitybeacon1_beta1/src/api.rs +++ b/gen/proximitybeacon1_beta1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and modify your beacons UserlocationBeaconRegistry, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use proximitybeacon1_beta1::{Proximitybeacon, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/proximitybeacon1_beta1/src/lib.rs b/gen/proximitybeacon1_beta1/src/lib.rs index 063a150099..2902e0d627 100644 --- a/gen/proximitybeacon1_beta1/src/lib.rs +++ b/gen/proximitybeacon1_beta1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/proximitybeacon1_beta1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Proximitybeacon) ... +//! Handle the following *Resources* with ease from the central [hub](Proximitybeacon) ... //! //! * beaconinfo //! * [*getforobserved*](api::BeaconinfoGetforobservedCall) @@ -69,8 +69,8 @@ //! let r = hub.beacons().update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -98,12 +98,12 @@ //! use std::default::Default; //! use proximitybeacon1_beta1::{Proximitybeacon, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -143,10 +143,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -156,25 +156,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/pubsub1/README.md b/gen/pubsub1/README.md index 69a81789e3..357989c488 100644 --- a/gen/pubsub1/README.md +++ b/gen/pubsub1/README.md @@ -11,7 +11,7 @@ Everything else about the *Pubsub* *v1* API can be found at the [official documentation site](https://cloud.google.com/pubsub/docs). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/Pubsub) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/Pubsub) ... * projects * [*schemas commit*](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/api::ProjectSchemaCommitCall), [*schemas create*](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/api::ProjectSchemaCreateCall), [*schemas delete*](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/api::ProjectSchemaDeleteCall), [*schemas delete revision*](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/api::ProjectSchemaDeleteRevisionCall), [*schemas get*](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/api::ProjectSchemaGetCall), [*schemas get iam policy*](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/api::ProjectSchemaGetIamPolicyCall), [*schemas list*](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/api::ProjectSchemaListCall), [*schemas list revisions*](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/api::ProjectSchemaListRevisionCall), [*schemas rollback*](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/api::ProjectSchemaRollbackCall), [*schemas set iam policy*](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/api::ProjectSchemaSetIamPolicyCall), [*schemas test iam permissions*](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/api::ProjectSchemaTestIamPermissionCall), [*schemas validate*](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/api::ProjectSchemaValidateCall), [*schemas validate message*](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/api::ProjectSchemaValidateMessageCall), [*snapshots create*](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/api::ProjectSnapshotCreateCall), [*snapshots delete*](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/api::ProjectSnapshotDeleteCall), [*snapshots get*](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/api::ProjectSnapshotGetCall), [*snapshots get iam policy*](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/api::ProjectSnapshotGetIamPolicyCall), [*snapshots list*](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/api::ProjectSnapshotListCall), [*snapshots patch*](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/api::ProjectSnapshotPatchCall), [*snapshots set iam policy*](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/api::ProjectSnapshotSetIamPolicyCall), [*snapshots test iam permissions*](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/api::ProjectSnapshotTestIamPermissionCall), [*subscriptions acknowledge*](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/api::ProjectSubscriptionAcknowledgeCall), [*subscriptions create*](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/api::ProjectSubscriptionCreateCall), [*subscriptions delete*](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/api::ProjectSubscriptionDeleteCall), [*subscriptions detach*](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/api::ProjectSubscriptionDetachCall), [*subscriptions get*](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/api::ProjectSubscriptionGetCall), [*subscriptions get iam policy*](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/api::ProjectSubscriptionGetIamPolicyCall), [*subscriptions list*](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/api::ProjectSubscriptionListCall), [*subscriptions modify ack deadline*](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/api::ProjectSubscriptionModifyAckDeadlineCall), [*subscriptions modify push config*](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/api::ProjectSubscriptionModifyPushConfigCall), [*subscriptions patch*](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/api::ProjectSubscriptionPatchCall), [*subscriptions pull*](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/api::ProjectSubscriptionPullCall), [*subscriptions seek*](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/api::ProjectSubscriptionSeekCall), [*subscriptions set iam policy*](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/api::ProjectSubscriptionSetIamPolicyCall), [*subscriptions test iam permissions*](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/api::ProjectSubscriptionTestIamPermissionCall), [*topics create*](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/api::ProjectTopicCreateCall), [*topics delete*](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/api::ProjectTopicDeleteCall), [*topics get*](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/api::ProjectTopicGetCall), [*topics get iam policy*](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/api::ProjectTopicGetIamPolicyCall), [*topics list*](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/api::ProjectTopicListCall), [*topics patch*](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/api::ProjectTopicPatchCall), [*topics publish*](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/api::ProjectTopicPublishCall), [*topics set iam policy*](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/api::ProjectTopicSetIamPolicyCall), [*topics snapshots list*](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/api::ProjectTopicSnapshotListCall), [*topics subscriptions list*](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/api::ProjectTopicSubscriptionListCall) and [*topics test iam permissions*](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/api::ProjectTopicTestIamPermissionCall) @@ -57,8 +57,8 @@ let r = hub.projects().topics_get_iam_policy(...).doit().await let r = hub.projects().topics_set_iam_policy(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -85,12 +85,12 @@ use pubsub1::{Result, Error}; use std::default::Default; use pubsub1::{Pubsub, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -127,10 +127,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -140,25 +140,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-pubsub You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/client::Delegate) to the -[Method Builder](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/client::Delegate) to the +[Method Builder](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/client::RequestValue) and -[decodable](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/client::RequestValue) and +[decodable](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-pubsub1/5.0.3+20230119/google_pubsub1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -177,7 +177,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **pubsub1** library was generated by Sebastian Thiel, and is placed +The **pubsub1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/pubsub1/src/api.rs b/gen/pubsub1/src/api.rs index b960cb4bdf..02751810c4 100644 --- a/gen/pubsub1/src/api.rs +++ b/gen/pubsub1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -68,12 +68,12 @@ impl Default for Scope { /// use std::default::Default; /// use pubsub1::{Pubsub, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/pubsub1/src/lib.rs b/gen/pubsub1/src/lib.rs index 722e18bd9e..965aecd730 100644 --- a/gen/pubsub1/src/lib.rs +++ b/gen/pubsub1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/pubsub1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Pubsub) ... +//! Handle the following *Resources* with ease from the central [hub](Pubsub) ... //! //! * projects //! * [*schemas commit*](api::ProjectSchemaCommitCall), [*schemas create*](api::ProjectSchemaCreateCall), [*schemas delete*](api::ProjectSchemaDeleteCall), [*schemas delete revision*](api::ProjectSchemaDeleteRevisionCall), [*schemas get*](api::ProjectSchemaGetCall), [*schemas get iam policy*](api::ProjectSchemaGetIamPolicyCall), [*schemas list*](api::ProjectSchemaListCall), [*schemas list revisions*](api::ProjectSchemaListRevisionCall), [*schemas rollback*](api::ProjectSchemaRollbackCall), [*schemas set iam policy*](api::ProjectSchemaSetIamPolicyCall), [*schemas test iam permissions*](api::ProjectSchemaTestIamPermissionCall), [*schemas validate*](api::ProjectSchemaValidateCall), [*schemas validate message*](api::ProjectSchemaValidateMessageCall), [*snapshots create*](api::ProjectSnapshotCreateCall), [*snapshots delete*](api::ProjectSnapshotDeleteCall), [*snapshots get*](api::ProjectSnapshotGetCall), [*snapshots get iam policy*](api::ProjectSnapshotGetIamPolicyCall), [*snapshots list*](api::ProjectSnapshotListCall), [*snapshots patch*](api::ProjectSnapshotPatchCall), [*snapshots set iam policy*](api::ProjectSnapshotSetIamPolicyCall), [*snapshots test iam permissions*](api::ProjectSnapshotTestIamPermissionCall), [*subscriptions acknowledge*](api::ProjectSubscriptionAcknowledgeCall), [*subscriptions create*](api::ProjectSubscriptionCreateCall), [*subscriptions delete*](api::ProjectSubscriptionDeleteCall), [*subscriptions detach*](api::ProjectSubscriptionDetachCall), [*subscriptions get*](api::ProjectSubscriptionGetCall), [*subscriptions get iam policy*](api::ProjectSubscriptionGetIamPolicyCall), [*subscriptions list*](api::ProjectSubscriptionListCall), [*subscriptions modify ack deadline*](api::ProjectSubscriptionModifyAckDeadlineCall), [*subscriptions modify push config*](api::ProjectSubscriptionModifyPushConfigCall), [*subscriptions patch*](api::ProjectSubscriptionPatchCall), [*subscriptions pull*](api::ProjectSubscriptionPullCall), [*subscriptions seek*](api::ProjectSubscriptionSeekCall), [*subscriptions set iam policy*](api::ProjectSubscriptionSetIamPolicyCall), [*subscriptions test iam permissions*](api::ProjectSubscriptionTestIamPermissionCall), [*topics create*](api::ProjectTopicCreateCall), [*topics delete*](api::ProjectTopicDeleteCall), [*topics get*](api::ProjectTopicGetCall), [*topics get iam policy*](api::ProjectTopicGetIamPolicyCall), [*topics list*](api::ProjectTopicListCall), [*topics patch*](api::ProjectTopicPatchCall), [*topics publish*](api::ProjectTopicPublishCall), [*topics set iam policy*](api::ProjectTopicSetIamPolicyCall), [*topics snapshots list*](api::ProjectTopicSnapshotListCall), [*topics subscriptions list*](api::ProjectTopicSubscriptionListCall) and [*topics test iam permissions*](api::ProjectTopicTestIamPermissionCall) @@ -57,8 +57,8 @@ //! let r = hub.projects().topics_set_iam_policy(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -86,12 +86,12 @@ //! use std::default::Default; //! use pubsub1::{Pubsub, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -128,10 +128,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -141,25 +141,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/pubsub1_beta2/README.md b/gen/pubsub1_beta2/README.md index d73e6a8ddb..241ebdfd2b 100644 --- a/gen/pubsub1_beta2/README.md +++ b/gen/pubsub1_beta2/README.md @@ -11,7 +11,7 @@ Everything else about the *Pubsub* *v1_beta2* API can be found at the [official documentation site](https://cloud.google.com/pubsub/docs). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-pubsub1_beta2/5.0.3+20230119/google_pubsub1_beta2/Pubsub) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-pubsub1_beta2/5.0.3+20230119/google_pubsub1_beta2/Pubsub) ... * projects * [*subscriptions acknowledge*](https://docs.rs/google-pubsub1_beta2/5.0.3+20230119/google_pubsub1_beta2/api::ProjectSubscriptionAcknowledgeCall), [*subscriptions create*](https://docs.rs/google-pubsub1_beta2/5.0.3+20230119/google_pubsub1_beta2/api::ProjectSubscriptionCreateCall), [*subscriptions delete*](https://docs.rs/google-pubsub1_beta2/5.0.3+20230119/google_pubsub1_beta2/api::ProjectSubscriptionDeleteCall), [*subscriptions get*](https://docs.rs/google-pubsub1_beta2/5.0.3+20230119/google_pubsub1_beta2/api::ProjectSubscriptionGetCall), [*subscriptions get iam policy*](https://docs.rs/google-pubsub1_beta2/5.0.3+20230119/google_pubsub1_beta2/api::ProjectSubscriptionGetIamPolicyCall), [*subscriptions list*](https://docs.rs/google-pubsub1_beta2/5.0.3+20230119/google_pubsub1_beta2/api::ProjectSubscriptionListCall), [*subscriptions modify ack deadline*](https://docs.rs/google-pubsub1_beta2/5.0.3+20230119/google_pubsub1_beta2/api::ProjectSubscriptionModifyAckDeadlineCall), [*subscriptions modify push config*](https://docs.rs/google-pubsub1_beta2/5.0.3+20230119/google_pubsub1_beta2/api::ProjectSubscriptionModifyPushConfigCall), [*subscriptions pull*](https://docs.rs/google-pubsub1_beta2/5.0.3+20230119/google_pubsub1_beta2/api::ProjectSubscriptionPullCall), [*subscriptions set iam policy*](https://docs.rs/google-pubsub1_beta2/5.0.3+20230119/google_pubsub1_beta2/api::ProjectSubscriptionSetIamPolicyCall), [*subscriptions test iam permissions*](https://docs.rs/google-pubsub1_beta2/5.0.3+20230119/google_pubsub1_beta2/api::ProjectSubscriptionTestIamPermissionCall), [*topics create*](https://docs.rs/google-pubsub1_beta2/5.0.3+20230119/google_pubsub1_beta2/api::ProjectTopicCreateCall), [*topics delete*](https://docs.rs/google-pubsub1_beta2/5.0.3+20230119/google_pubsub1_beta2/api::ProjectTopicDeleteCall), [*topics get*](https://docs.rs/google-pubsub1_beta2/5.0.3+20230119/google_pubsub1_beta2/api::ProjectTopicGetCall), [*topics get iam policy*](https://docs.rs/google-pubsub1_beta2/5.0.3+20230119/google_pubsub1_beta2/api::ProjectTopicGetIamPolicyCall), [*topics list*](https://docs.rs/google-pubsub1_beta2/5.0.3+20230119/google_pubsub1_beta2/api::ProjectTopicListCall), [*topics publish*](https://docs.rs/google-pubsub1_beta2/5.0.3+20230119/google_pubsub1_beta2/api::ProjectTopicPublishCall), [*topics set iam policy*](https://docs.rs/google-pubsub1_beta2/5.0.3+20230119/google_pubsub1_beta2/api::ProjectTopicSetIamPolicyCall), [*topics subscriptions list*](https://docs.rs/google-pubsub1_beta2/5.0.3+20230119/google_pubsub1_beta2/api::ProjectTopicSubscriptionListCall) and [*topics test iam permissions*](https://docs.rs/google-pubsub1_beta2/5.0.3+20230119/google_pubsub1_beta2/api::ProjectTopicTestIamPermissionCall) @@ -54,8 +54,8 @@ let r = hub.projects().subscriptions_modify_push_config(...).doit().await let r = hub.projects().topics_delete(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -83,12 +83,12 @@ use pubsub1_beta2::{Result, Error}; use std::default::Default; use pubsub1_beta2::{Pubsub, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -129,10 +129,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-pubsub1_beta2/5.0.3+20230119/google_pubsub1_beta2/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-pubsub1_beta2/5.0.3+20230119/google_pubsub1_beta2/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -142,25 +142,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-pubsub You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-pubsub1_beta2/5.0.3+20230119/google_pubsub1_beta2/client::Delegate) to the -[Method Builder](https://docs.rs/google-pubsub1_beta2/5.0.3+20230119/google_pubsub1_beta2/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-pubsub1_beta2/5.0.3+20230119/google_pubsub1_beta2/client::Delegate) to the +[Method Builder](https://docs.rs/google-pubsub1_beta2/5.0.3+20230119/google_pubsub1_beta2/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-pubsub1_beta2/5.0.3+20230119/google_pubsub1_beta2/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-pubsub1_beta2/5.0.3+20230119/google_pubsub1_beta2/client::RequestValue) and -[decodable](https://docs.rs/google-pubsub1_beta2/5.0.3+20230119/google_pubsub1_beta2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-pubsub1_beta2/5.0.3+20230119/google_pubsub1_beta2/client::RequestValue) and +[decodable](https://docs.rs/google-pubsub1_beta2/5.0.3+20230119/google_pubsub1_beta2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-pubsub1_beta2/5.0.3+20230119/google_pubsub1_beta2/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-pubsub1_beta2/5.0.3+20230119/google_pubsub1_beta2/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -179,7 +179,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **pubsub1_beta2** library was generated by Sebastian Thiel, and is placed +The **pubsub1_beta2** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/pubsub1_beta2/src/api.rs b/gen/pubsub1_beta2/src/api.rs index a0a07f5462..585ab5d271 100644 --- a/gen/pubsub1_beta2/src/api.rs +++ b/gen/pubsub1_beta2/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use pubsub1_beta2::{Pubsub, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/pubsub1_beta2/src/lib.rs b/gen/pubsub1_beta2/src/lib.rs index e2c024af41..19a65410b3 100644 --- a/gen/pubsub1_beta2/src/lib.rs +++ b/gen/pubsub1_beta2/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/pubsub1_beta2). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Pubsub) ... +//! Handle the following *Resources* with ease from the central [hub](Pubsub) ... //! //! * projects //! * [*subscriptions acknowledge*](api::ProjectSubscriptionAcknowledgeCall), [*subscriptions create*](api::ProjectSubscriptionCreateCall), [*subscriptions delete*](api::ProjectSubscriptionDeleteCall), [*subscriptions get*](api::ProjectSubscriptionGetCall), [*subscriptions get iam policy*](api::ProjectSubscriptionGetIamPolicyCall), [*subscriptions list*](api::ProjectSubscriptionListCall), [*subscriptions modify ack deadline*](api::ProjectSubscriptionModifyAckDeadlineCall), [*subscriptions modify push config*](api::ProjectSubscriptionModifyPushConfigCall), [*subscriptions pull*](api::ProjectSubscriptionPullCall), [*subscriptions set iam policy*](api::ProjectSubscriptionSetIamPolicyCall), [*subscriptions test iam permissions*](api::ProjectSubscriptionTestIamPermissionCall), [*topics create*](api::ProjectTopicCreateCall), [*topics delete*](api::ProjectTopicDeleteCall), [*topics get*](api::ProjectTopicGetCall), [*topics get iam policy*](api::ProjectTopicGetIamPolicyCall), [*topics list*](api::ProjectTopicListCall), [*topics publish*](api::ProjectTopicPublishCall), [*topics set iam policy*](api::ProjectTopicSetIamPolicyCall), [*topics subscriptions list*](api::ProjectTopicSubscriptionListCall) and [*topics test iam permissions*](api::ProjectTopicTestIamPermissionCall) @@ -54,8 +54,8 @@ //! let r = hub.projects().topics_delete(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -84,12 +84,12 @@ //! use std::default::Default; //! use pubsub1_beta2::{Pubsub, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -130,10 +130,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -143,25 +143,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/pubsublite1/README.md b/gen/pubsublite1/README.md index 26abfac2ae..5c0f9fa9ac 100644 --- a/gen/pubsublite1/README.md +++ b/gen/pubsublite1/README.md @@ -11,7 +11,7 @@ Everything else about the *PubsubLite* *v1* API can be found at the [official documentation site](https://cloud.google.com/pubsub/lite/docs). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-pubsublite1/5.0.3+20230114/google_pubsublite1/PubsubLite) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-pubsublite1/5.0.3+20230114/google_pubsublite1/PubsubLite) ... * admin * [*projects locations operations cancel*](https://docs.rs/google-pubsublite1/5.0.3+20230114/google_pubsublite1/api::AdminProjectLocationOperationCancelCall), [*projects locations operations delete*](https://docs.rs/google-pubsublite1/5.0.3+20230114/google_pubsublite1/api::AdminProjectLocationOperationDeleteCall), [*projects locations operations get*](https://docs.rs/google-pubsublite1/5.0.3+20230114/google_pubsublite1/api::AdminProjectLocationOperationGetCall), [*projects locations operations list*](https://docs.rs/google-pubsublite1/5.0.3+20230114/google_pubsublite1/api::AdminProjectLocationOperationListCall), [*projects locations reservations create*](https://docs.rs/google-pubsublite1/5.0.3+20230114/google_pubsublite1/api::AdminProjectLocationReservationCreateCall), [*projects locations reservations delete*](https://docs.rs/google-pubsublite1/5.0.3+20230114/google_pubsublite1/api::AdminProjectLocationReservationDeleteCall), [*projects locations reservations get*](https://docs.rs/google-pubsublite1/5.0.3+20230114/google_pubsublite1/api::AdminProjectLocationReservationGetCall), [*projects locations reservations list*](https://docs.rs/google-pubsublite1/5.0.3+20230114/google_pubsublite1/api::AdminProjectLocationReservationListCall), [*projects locations reservations patch*](https://docs.rs/google-pubsublite1/5.0.3+20230114/google_pubsublite1/api::AdminProjectLocationReservationPatchCall), [*projects locations reservations topics list*](https://docs.rs/google-pubsublite1/5.0.3+20230114/google_pubsublite1/api::AdminProjectLocationReservationTopicListCall), [*projects locations subscriptions create*](https://docs.rs/google-pubsublite1/5.0.3+20230114/google_pubsublite1/api::AdminProjectLocationSubscriptionCreateCall), [*projects locations subscriptions delete*](https://docs.rs/google-pubsublite1/5.0.3+20230114/google_pubsublite1/api::AdminProjectLocationSubscriptionDeleteCall), [*projects locations subscriptions get*](https://docs.rs/google-pubsublite1/5.0.3+20230114/google_pubsublite1/api::AdminProjectLocationSubscriptionGetCall), [*projects locations subscriptions list*](https://docs.rs/google-pubsublite1/5.0.3+20230114/google_pubsublite1/api::AdminProjectLocationSubscriptionListCall), [*projects locations subscriptions patch*](https://docs.rs/google-pubsublite1/5.0.3+20230114/google_pubsublite1/api::AdminProjectLocationSubscriptionPatchCall), [*projects locations subscriptions seek*](https://docs.rs/google-pubsublite1/5.0.3+20230114/google_pubsublite1/api::AdminProjectLocationSubscriptionSeekCall), [*projects locations topics create*](https://docs.rs/google-pubsublite1/5.0.3+20230114/google_pubsublite1/api::AdminProjectLocationTopicCreateCall), [*projects locations topics delete*](https://docs.rs/google-pubsublite1/5.0.3+20230114/google_pubsublite1/api::AdminProjectLocationTopicDeleteCall), [*projects locations topics get*](https://docs.rs/google-pubsublite1/5.0.3+20230114/google_pubsublite1/api::AdminProjectLocationTopicGetCall), [*projects locations topics get partitions*](https://docs.rs/google-pubsublite1/5.0.3+20230114/google_pubsublite1/api::AdminProjectLocationTopicGetPartitionCall), [*projects locations topics list*](https://docs.rs/google-pubsublite1/5.0.3+20230114/google_pubsublite1/api::AdminProjectLocationTopicListCall), [*projects locations topics patch*](https://docs.rs/google-pubsublite1/5.0.3+20230114/google_pubsublite1/api::AdminProjectLocationTopicPatchCall) and [*projects locations topics subscriptions list*](https://docs.rs/google-pubsublite1/5.0.3+20230114/google_pubsublite1/api::AdminProjectLocationTopicSubscriptionListCall) @@ -58,8 +58,8 @@ let r = hub.admin().projects_locations_subscriptions_delete(...).doit().await let r = hub.admin().projects_locations_topics_delete(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -87,12 +87,12 @@ use pubsublite1::{Result, Error}; use std::default::Default; use pubsublite1::{PubsubLite, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -133,10 +133,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-pubsublite1/5.0.3+20230114/google_pubsublite1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-pubsublite1/5.0.3+20230114/google_pubsublite1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -146,25 +146,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-pubsub You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-pubsublite1/5.0.3+20230114/google_pubsublite1/client::Delegate) to the -[Method Builder](https://docs.rs/google-pubsublite1/5.0.3+20230114/google_pubsublite1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-pubsublite1/5.0.3+20230114/google_pubsublite1/client::Delegate) to the +[Method Builder](https://docs.rs/google-pubsublite1/5.0.3+20230114/google_pubsublite1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-pubsublite1/5.0.3+20230114/google_pubsublite1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-pubsublite1/5.0.3+20230114/google_pubsublite1/client::RequestValue) and -[decodable](https://docs.rs/google-pubsublite1/5.0.3+20230114/google_pubsublite1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-pubsublite1/5.0.3+20230114/google_pubsublite1/client::RequestValue) and +[decodable](https://docs.rs/google-pubsublite1/5.0.3+20230114/google_pubsublite1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-pubsublite1/5.0.3+20230114/google_pubsublite1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-pubsublite1/5.0.3+20230114/google_pubsublite1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -183,7 +183,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **pubsublite1** library was generated by Sebastian Thiel, and is placed +The **pubsublite1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/pubsublite1/src/api.rs b/gen/pubsublite1/src/api.rs index f6c5083643..47b521de32 100644 --- a/gen/pubsublite1/src/api.rs +++ b/gen/pubsublite1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use pubsublite1::{PubsubLite, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/pubsublite1/src/lib.rs b/gen/pubsublite1/src/lib.rs index b830df4a8e..f518dcd9e3 100644 --- a/gen/pubsublite1/src/lib.rs +++ b/gen/pubsublite1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/pubsublite1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](PubsubLite) ... +//! Handle the following *Resources* with ease from the central [hub](PubsubLite) ... //! //! * admin //! * [*projects locations operations cancel*](api::AdminProjectLocationOperationCancelCall), [*projects locations operations delete*](api::AdminProjectLocationOperationDeleteCall), [*projects locations operations get*](api::AdminProjectLocationOperationGetCall), [*projects locations operations list*](api::AdminProjectLocationOperationListCall), [*projects locations reservations create*](api::AdminProjectLocationReservationCreateCall), [*projects locations reservations delete*](api::AdminProjectLocationReservationDeleteCall), [*projects locations reservations get*](api::AdminProjectLocationReservationGetCall), [*projects locations reservations list*](api::AdminProjectLocationReservationListCall), [*projects locations reservations patch*](api::AdminProjectLocationReservationPatchCall), [*projects locations reservations topics list*](api::AdminProjectLocationReservationTopicListCall), [*projects locations subscriptions create*](api::AdminProjectLocationSubscriptionCreateCall), [*projects locations subscriptions delete*](api::AdminProjectLocationSubscriptionDeleteCall), [*projects locations subscriptions get*](api::AdminProjectLocationSubscriptionGetCall), [*projects locations subscriptions list*](api::AdminProjectLocationSubscriptionListCall), [*projects locations subscriptions patch*](api::AdminProjectLocationSubscriptionPatchCall), [*projects locations subscriptions seek*](api::AdminProjectLocationSubscriptionSeekCall), [*projects locations topics create*](api::AdminProjectLocationTopicCreateCall), [*projects locations topics delete*](api::AdminProjectLocationTopicDeleteCall), [*projects locations topics get*](api::AdminProjectLocationTopicGetCall), [*projects locations topics get partitions*](api::AdminProjectLocationTopicGetPartitionCall), [*projects locations topics list*](api::AdminProjectLocationTopicListCall), [*projects locations topics patch*](api::AdminProjectLocationTopicPatchCall) and [*projects locations topics subscriptions list*](api::AdminProjectLocationTopicSubscriptionListCall) @@ -58,8 +58,8 @@ //! let r = hub.admin().projects_locations_topics_delete(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -88,12 +88,12 @@ //! use std::default::Default; //! use pubsublite1::{PubsubLite, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -134,10 +134,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -147,25 +147,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/qpxexpress1/README.md b/gen/qpxexpress1/README.md index 8d1df11b20..e7b4235125 100644 --- a/gen/qpxexpress1/README.md +++ b/gen/qpxexpress1/README.md @@ -11,7 +11,7 @@ Everything else about the *QPX Express* *v1* API can be found at the [official documentation site](http://developers.google.com/qpx-express). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-qpxexpress1/5.0.3+20160708/google_qpxexpress1/QPXExpress) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-qpxexpress1/5.0.3+20160708/google_qpxexpress1/QPXExpress) ... * trips * [*search*](https://docs.rs/google-qpxexpress1/5.0.3+20160708/google_qpxexpress1/api::TripSearchCall) @@ -50,8 +50,8 @@ Or specifically ... let r = hub.trips().search(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -79,12 +79,12 @@ use qpxexpress1::{Result, Error}; use std::default::Default; use qpxexpress1::{QPXExpress, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -125,10 +125,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-qpxexpress1/5.0.3+20160708/google_qpxexpress1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-qpxexpress1/5.0.3+20160708/google_qpxexpress1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -138,25 +138,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-qpxexp You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-qpxexpress1/5.0.3+20160708/google_qpxexpress1/client::Delegate) to the -[Method Builder](https://docs.rs/google-qpxexpress1/5.0.3+20160708/google_qpxexpress1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-qpxexpress1/5.0.3+20160708/google_qpxexpress1/client::Delegate) to the +[Method Builder](https://docs.rs/google-qpxexpress1/5.0.3+20160708/google_qpxexpress1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-qpxexpress1/5.0.3+20160708/google_qpxexpress1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-qpxexpress1/5.0.3+20160708/google_qpxexpress1/client::RequestValue) and -[decodable](https://docs.rs/google-qpxexpress1/5.0.3+20160708/google_qpxexpress1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-qpxexpress1/5.0.3+20160708/google_qpxexpress1/client::RequestValue) and +[decodable](https://docs.rs/google-qpxexpress1/5.0.3+20160708/google_qpxexpress1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-qpxexpress1/5.0.3+20160708/google_qpxexpress1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-qpxexpress1/5.0.3+20160708/google_qpxexpress1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -175,7 +175,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **qpxexpress1** library was generated by Sebastian Thiel, and is placed +The **qpxexpress1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/qpxexpress1/src/api.rs b/gen/qpxexpress1/src/api.rs index 0896123a31..ce895426e4 100644 --- a/gen/qpxexpress1/src/api.rs +++ b/gen/qpxexpress1/src/api.rs @@ -43,12 +43,12 @@ use crate::{client, client::GetToken, client::serde_with}; /// use std::default::Default; /// use qpxexpress1::{QPXExpress, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/qpxexpress1/src/lib.rs b/gen/qpxexpress1/src/lib.rs index c12a5980cf..d46e850734 100644 --- a/gen/qpxexpress1/src/lib.rs +++ b/gen/qpxexpress1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/qpxexpress1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](QPXExpress) ... +//! Handle the following *Resources* with ease from the central [hub](QPXExpress) ... //! //! * trips //! * [*search*](api::TripSearchCall) @@ -50,8 +50,8 @@ //! let r = hub.trips().search(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -80,12 +80,12 @@ //! use std::default::Default; //! use qpxexpress1::{QPXExpress, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -126,10 +126,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -139,25 +139,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/realtimebidding1/README.md b/gen/realtimebidding1/README.md index 7734d47d7e..baf5580532 100644 --- a/gen/realtimebidding1/README.md +++ b/gen/realtimebidding1/README.md @@ -11,7 +11,7 @@ Everything else about the *Real-time Bidding* *v1* API can be found at the [official documentation site](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-realtimebidding1/5.0.3+20230124/google_realtimebidding1/RealTimeBidding) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-realtimebidding1/5.0.3+20230124/google_realtimebidding1/RealTimeBidding) ... * [bidders](https://docs.rs/google-realtimebidding1/5.0.3+20230124/google_realtimebidding1/api::Bidder) * [*creatives list*](https://docs.rs/google-realtimebidding1/5.0.3+20230124/google_realtimebidding1/api::BidderCreativeListCall), [*creatives watch*](https://docs.rs/google-realtimebidding1/5.0.3+20230124/google_realtimebidding1/api::BidderCreativeWatchCall), [*endpoints get*](https://docs.rs/google-realtimebidding1/5.0.3+20230124/google_realtimebidding1/api::BidderEndpointGetCall), [*endpoints list*](https://docs.rs/google-realtimebidding1/5.0.3+20230124/google_realtimebidding1/api::BidderEndpointListCall), [*endpoints patch*](https://docs.rs/google-realtimebidding1/5.0.3+20230124/google_realtimebidding1/api::BidderEndpointPatchCall), [*get*](https://docs.rs/google-realtimebidding1/5.0.3+20230124/google_realtimebidding1/api::BidderGetCall), [*list*](https://docs.rs/google-realtimebidding1/5.0.3+20230124/google_realtimebidding1/api::BidderListCall), [*pretargeting configs activate*](https://docs.rs/google-realtimebidding1/5.0.3+20230124/google_realtimebidding1/api::BidderPretargetingConfigActivateCall), [*pretargeting configs add targeted apps*](https://docs.rs/google-realtimebidding1/5.0.3+20230124/google_realtimebidding1/api::BidderPretargetingConfigAddTargetedAppCall), [*pretargeting configs add targeted publishers*](https://docs.rs/google-realtimebidding1/5.0.3+20230124/google_realtimebidding1/api::BidderPretargetingConfigAddTargetedPublisherCall), [*pretargeting configs add targeted sites*](https://docs.rs/google-realtimebidding1/5.0.3+20230124/google_realtimebidding1/api::BidderPretargetingConfigAddTargetedSiteCall), [*pretargeting configs create*](https://docs.rs/google-realtimebidding1/5.0.3+20230124/google_realtimebidding1/api::BidderPretargetingConfigCreateCall), [*pretargeting configs delete*](https://docs.rs/google-realtimebidding1/5.0.3+20230124/google_realtimebidding1/api::BidderPretargetingConfigDeleteCall), [*pretargeting configs get*](https://docs.rs/google-realtimebidding1/5.0.3+20230124/google_realtimebidding1/api::BidderPretargetingConfigGetCall), [*pretargeting configs list*](https://docs.rs/google-realtimebidding1/5.0.3+20230124/google_realtimebidding1/api::BidderPretargetingConfigListCall), [*pretargeting configs patch*](https://docs.rs/google-realtimebidding1/5.0.3+20230124/google_realtimebidding1/api::BidderPretargetingConfigPatchCall), [*pretargeting configs remove targeted apps*](https://docs.rs/google-realtimebidding1/5.0.3+20230124/google_realtimebidding1/api::BidderPretargetingConfigRemoveTargetedAppCall), [*pretargeting configs remove targeted publishers*](https://docs.rs/google-realtimebidding1/5.0.3+20230124/google_realtimebidding1/api::BidderPretargetingConfigRemoveTargetedPublisherCall), [*pretargeting configs remove targeted sites*](https://docs.rs/google-realtimebidding1/5.0.3+20230124/google_realtimebidding1/api::BidderPretargetingConfigRemoveTargetedSiteCall), [*pretargeting configs suspend*](https://docs.rs/google-realtimebidding1/5.0.3+20230124/google_realtimebidding1/api::BidderPretargetingConfigSuspendCall), [*publisher connections batch approve*](https://docs.rs/google-realtimebidding1/5.0.3+20230124/google_realtimebidding1/api::BidderPublisherConnectionBatchApproveCall), [*publisher connections batch reject*](https://docs.rs/google-realtimebidding1/5.0.3+20230124/google_realtimebidding1/api::BidderPublisherConnectionBatchRejectCall), [*publisher connections get*](https://docs.rs/google-realtimebidding1/5.0.3+20230124/google_realtimebidding1/api::BidderPublisherConnectionGetCall) and [*publisher connections list*](https://docs.rs/google-realtimebidding1/5.0.3+20230124/google_realtimebidding1/api::BidderPublisherConnectionListCall) @@ -75,8 +75,8 @@ let r = hub.bidders().get(...).doit().await let r = hub.bidders().list(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -103,12 +103,12 @@ use realtimebidding1::{Result, Error}; use std::default::Default; use realtimebidding1::{RealTimeBidding, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -148,10 +148,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-realtimebidding1/5.0.3+20230124/google_realtimebidding1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-realtimebidding1/5.0.3+20230124/google_realtimebidding1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -161,25 +161,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-realti You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-realtimebidding1/5.0.3+20230124/google_realtimebidding1/client::Delegate) to the -[Method Builder](https://docs.rs/google-realtimebidding1/5.0.3+20230124/google_realtimebidding1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-realtimebidding1/5.0.3+20230124/google_realtimebidding1/client::Delegate) to the +[Method Builder](https://docs.rs/google-realtimebidding1/5.0.3+20230124/google_realtimebidding1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-realtimebidding1/5.0.3+20230124/google_realtimebidding1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-realtimebidding1/5.0.3+20230124/google_realtimebidding1/client::RequestValue) and -[decodable](https://docs.rs/google-realtimebidding1/5.0.3+20230124/google_realtimebidding1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-realtimebidding1/5.0.3+20230124/google_realtimebidding1/client::RequestValue) and +[decodable](https://docs.rs/google-realtimebidding1/5.0.3+20230124/google_realtimebidding1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-realtimebidding1/5.0.3+20230124/google_realtimebidding1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-realtimebidding1/5.0.3+20230124/google_realtimebidding1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -198,7 +198,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **realtimebidding1** library was generated by Sebastian Thiel, and is placed +The **realtimebidding1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/realtimebidding1/src/api.rs b/gen/realtimebidding1/src/api.rs index 2105f4bbb8..a925a91e0b 100644 --- a/gen/realtimebidding1/src/api.rs +++ b/gen/realtimebidding1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, create, edit, and delete your Authorized Buyers and Open Bidding account entities RealtimeBidding, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use realtimebidding1::{RealTimeBidding, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/realtimebidding1/src/lib.rs b/gen/realtimebidding1/src/lib.rs index b4431bd781..eda6c04576 100644 --- a/gen/realtimebidding1/src/lib.rs +++ b/gen/realtimebidding1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/realtimebidding1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](RealTimeBidding) ... +//! Handle the following *Resources* with ease from the central [hub](RealTimeBidding) ... //! //! * [bidders](api::Bidder) //! * [*creatives list*](api::BidderCreativeListCall), [*creatives watch*](api::BidderCreativeWatchCall), [*endpoints get*](api::BidderEndpointGetCall), [*endpoints list*](api::BidderEndpointListCall), [*endpoints patch*](api::BidderEndpointPatchCall), [*get*](api::BidderGetCall), [*list*](api::BidderListCall), [*pretargeting configs activate*](api::BidderPretargetingConfigActivateCall), [*pretargeting configs add targeted apps*](api::BidderPretargetingConfigAddTargetedAppCall), [*pretargeting configs add targeted publishers*](api::BidderPretargetingConfigAddTargetedPublisherCall), [*pretargeting configs add targeted sites*](api::BidderPretargetingConfigAddTargetedSiteCall), [*pretargeting configs create*](api::BidderPretargetingConfigCreateCall), [*pretargeting configs delete*](api::BidderPretargetingConfigDeleteCall), [*pretargeting configs get*](api::BidderPretargetingConfigGetCall), [*pretargeting configs list*](api::BidderPretargetingConfigListCall), [*pretargeting configs patch*](api::BidderPretargetingConfigPatchCall), [*pretargeting configs remove targeted apps*](api::BidderPretargetingConfigRemoveTargetedAppCall), [*pretargeting configs remove targeted publishers*](api::BidderPretargetingConfigRemoveTargetedPublisherCall), [*pretargeting configs remove targeted sites*](api::BidderPretargetingConfigRemoveTargetedSiteCall), [*pretargeting configs suspend*](api::BidderPretargetingConfigSuspendCall), [*publisher connections batch approve*](api::BidderPublisherConnectionBatchApproveCall), [*publisher connections batch reject*](api::BidderPublisherConnectionBatchRejectCall), [*publisher connections get*](api::BidderPublisherConnectionGetCall) and [*publisher connections list*](api::BidderPublisherConnectionListCall) @@ -75,8 +75,8 @@ //! let r = hub.bidders().list(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -104,12 +104,12 @@ //! use std::default::Default; //! use realtimebidding1::{RealTimeBidding, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -149,10 +149,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -162,25 +162,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/recaptchaenterprise1/README.md b/gen/recaptchaenterprise1/README.md index 3f8ed5b260..1ba9ca4f72 100644 --- a/gen/recaptchaenterprise1/README.md +++ b/gen/recaptchaenterprise1/README.md @@ -11,7 +11,7 @@ Everything else about the *Recaptcha Enterprise* *v1* API can be found at the [official documentation site](https://cloud.google.com/recaptcha-enterprise/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-recaptchaenterprise1/5.0.3+20230115/google_recaptchaenterprise1/RecaptchaEnterprise) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-recaptchaenterprise1/5.0.3+20230115/google_recaptchaenterprise1/RecaptchaEnterprise) ... * projects * [*assessments annotate*](https://docs.rs/google-recaptchaenterprise1/5.0.3+20230115/google_recaptchaenterprise1/api::ProjectAssessmentAnnotateCall), [*assessments create*](https://docs.rs/google-recaptchaenterprise1/5.0.3+20230115/google_recaptchaenterprise1/api::ProjectAssessmentCreateCall), [*keys create*](https://docs.rs/google-recaptchaenterprise1/5.0.3+20230115/google_recaptchaenterprise1/api::ProjectKeyCreateCall), [*keys delete*](https://docs.rs/google-recaptchaenterprise1/5.0.3+20230115/google_recaptchaenterprise1/api::ProjectKeyDeleteCall), [*keys get*](https://docs.rs/google-recaptchaenterprise1/5.0.3+20230115/google_recaptchaenterprise1/api::ProjectKeyGetCall), [*keys get metrics*](https://docs.rs/google-recaptchaenterprise1/5.0.3+20230115/google_recaptchaenterprise1/api::ProjectKeyGetMetricCall), [*keys list*](https://docs.rs/google-recaptchaenterprise1/5.0.3+20230115/google_recaptchaenterprise1/api::ProjectKeyListCall), [*keys migrate*](https://docs.rs/google-recaptchaenterprise1/5.0.3+20230115/google_recaptchaenterprise1/api::ProjectKeyMigrateCall), [*keys patch*](https://docs.rs/google-recaptchaenterprise1/5.0.3+20230115/google_recaptchaenterprise1/api::ProjectKeyPatchCall), [*keys retrieve legacy secret key*](https://docs.rs/google-recaptchaenterprise1/5.0.3+20230115/google_recaptchaenterprise1/api::ProjectKeyRetrieveLegacySecretKeyCall), [*relatedaccountgroupmemberships search*](https://docs.rs/google-recaptchaenterprise1/5.0.3+20230115/google_recaptchaenterprise1/api::ProjectRelatedaccountgroupmembershipSearchCall), [*relatedaccountgroups list*](https://docs.rs/google-recaptchaenterprise1/5.0.3+20230115/google_recaptchaenterprise1/api::ProjectRelatedaccountgroupListCall) and [*relatedaccountgroups memberships list*](https://docs.rs/google-recaptchaenterprise1/5.0.3+20230115/google_recaptchaenterprise1/api::ProjectRelatedaccountgroupMembershipListCall) @@ -53,8 +53,8 @@ let r = hub.projects().keys_migrate(...).doit().await let r = hub.projects().keys_patch(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -82,12 +82,12 @@ use recaptchaenterprise1::{Result, Error}; use std::default::Default; use recaptchaenterprise1::{RecaptchaEnterprise, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -129,10 +129,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-recaptchaenterprise1/5.0.3+20230115/google_recaptchaenterprise1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-recaptchaenterprise1/5.0.3+20230115/google_recaptchaenterprise1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -142,25 +142,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-recapt You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-recaptchaenterprise1/5.0.3+20230115/google_recaptchaenterprise1/client::Delegate) to the -[Method Builder](https://docs.rs/google-recaptchaenterprise1/5.0.3+20230115/google_recaptchaenterprise1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-recaptchaenterprise1/5.0.3+20230115/google_recaptchaenterprise1/client::Delegate) to the +[Method Builder](https://docs.rs/google-recaptchaenterprise1/5.0.3+20230115/google_recaptchaenterprise1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-recaptchaenterprise1/5.0.3+20230115/google_recaptchaenterprise1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-recaptchaenterprise1/5.0.3+20230115/google_recaptchaenterprise1/client::RequestValue) and -[decodable](https://docs.rs/google-recaptchaenterprise1/5.0.3+20230115/google_recaptchaenterprise1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-recaptchaenterprise1/5.0.3+20230115/google_recaptchaenterprise1/client::RequestValue) and +[decodable](https://docs.rs/google-recaptchaenterprise1/5.0.3+20230115/google_recaptchaenterprise1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-recaptchaenterprise1/5.0.3+20230115/google_recaptchaenterprise1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-recaptchaenterprise1/5.0.3+20230115/google_recaptchaenterprise1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -179,7 +179,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **recaptchaenterprise1** library was generated by Sebastian Thiel, and is placed +The **recaptchaenterprise1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/recaptchaenterprise1/src/api.rs b/gen/recaptchaenterprise1/src/api.rs index a8207ac793..60a3253aa3 100644 --- a/gen/recaptchaenterprise1/src/api.rs +++ b/gen/recaptchaenterprise1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use recaptchaenterprise1::{RecaptchaEnterprise, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/recaptchaenterprise1/src/lib.rs b/gen/recaptchaenterprise1/src/lib.rs index e6f653abc5..da7ff1444c 100644 --- a/gen/recaptchaenterprise1/src/lib.rs +++ b/gen/recaptchaenterprise1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/recaptchaenterprise1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](RecaptchaEnterprise) ... +//! Handle the following *Resources* with ease from the central [hub](RecaptchaEnterprise) ... //! //! * projects //! * [*assessments annotate*](api::ProjectAssessmentAnnotateCall), [*assessments create*](api::ProjectAssessmentCreateCall), [*keys create*](api::ProjectKeyCreateCall), [*keys delete*](api::ProjectKeyDeleteCall), [*keys get*](api::ProjectKeyGetCall), [*keys get metrics*](api::ProjectKeyGetMetricCall), [*keys list*](api::ProjectKeyListCall), [*keys migrate*](api::ProjectKeyMigrateCall), [*keys patch*](api::ProjectKeyPatchCall), [*keys retrieve legacy secret key*](api::ProjectKeyRetrieveLegacySecretKeyCall), [*relatedaccountgroupmemberships search*](api::ProjectRelatedaccountgroupmembershipSearchCall), [*relatedaccountgroups list*](api::ProjectRelatedaccountgroupListCall) and [*relatedaccountgroups memberships list*](api::ProjectRelatedaccountgroupMembershipListCall) @@ -53,8 +53,8 @@ //! let r = hub.projects().keys_patch(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -83,12 +83,12 @@ //! use std::default::Default; //! use recaptchaenterprise1::{RecaptchaEnterprise, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -130,10 +130,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -143,25 +143,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/recommendationengine1_beta1/README.md b/gen/recommendationengine1_beta1/README.md index c2849e8f2b..7aa2239166 100644 --- a/gen/recommendationengine1_beta1/README.md +++ b/gen/recommendationengine1_beta1/README.md @@ -11,7 +11,7 @@ Everything else about the *Recommendations AI* *v1_beta1* API can be found at th [official documentation site](https://cloud.google.com/recommendations-ai/docs). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-recommendationengine1_beta1/5.0.3+20230105/google_recommendationengine1_beta1/RecommendationsAI) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-recommendationengine1_beta1/5.0.3+20230105/google_recommendationengine1_beta1/RecommendationsAI) ... * projects * [*locations catalogs catalog items create*](https://docs.rs/google-recommendationengine1_beta1/5.0.3+20230105/google_recommendationengine1_beta1/api::ProjectLocationCatalogCatalogItemCreateCall), [*locations catalogs catalog items delete*](https://docs.rs/google-recommendationengine1_beta1/5.0.3+20230105/google_recommendationengine1_beta1/api::ProjectLocationCatalogCatalogItemDeleteCall), [*locations catalogs catalog items get*](https://docs.rs/google-recommendationengine1_beta1/5.0.3+20230105/google_recommendationengine1_beta1/api::ProjectLocationCatalogCatalogItemGetCall), [*locations catalogs catalog items import*](https://docs.rs/google-recommendationengine1_beta1/5.0.3+20230105/google_recommendationengine1_beta1/api::ProjectLocationCatalogCatalogItemImportCall), [*locations catalogs catalog items list*](https://docs.rs/google-recommendationengine1_beta1/5.0.3+20230105/google_recommendationengine1_beta1/api::ProjectLocationCatalogCatalogItemListCall), [*locations catalogs catalog items patch*](https://docs.rs/google-recommendationengine1_beta1/5.0.3+20230105/google_recommendationengine1_beta1/api::ProjectLocationCatalogCatalogItemPatchCall), [*locations catalogs event stores operations get*](https://docs.rs/google-recommendationengine1_beta1/5.0.3+20230105/google_recommendationengine1_beta1/api::ProjectLocationCatalogEventStoreOperationGetCall), [*locations catalogs event stores operations list*](https://docs.rs/google-recommendationengine1_beta1/5.0.3+20230105/google_recommendationengine1_beta1/api::ProjectLocationCatalogEventStoreOperationListCall), [*locations catalogs event stores placements predict*](https://docs.rs/google-recommendationengine1_beta1/5.0.3+20230105/google_recommendationengine1_beta1/api::ProjectLocationCatalogEventStorePlacementPredictCall), [*locations catalogs event stores prediction api key registrations create*](https://docs.rs/google-recommendationengine1_beta1/5.0.3+20230105/google_recommendationengine1_beta1/api::ProjectLocationCatalogEventStorePredictionApiKeyRegistrationCreateCall), [*locations catalogs event stores prediction api key registrations delete*](https://docs.rs/google-recommendationengine1_beta1/5.0.3+20230105/google_recommendationengine1_beta1/api::ProjectLocationCatalogEventStorePredictionApiKeyRegistrationDeleteCall), [*locations catalogs event stores prediction api key registrations list*](https://docs.rs/google-recommendationengine1_beta1/5.0.3+20230105/google_recommendationengine1_beta1/api::ProjectLocationCatalogEventStorePredictionApiKeyRegistrationListCall), [*locations catalogs event stores user events collect*](https://docs.rs/google-recommendationengine1_beta1/5.0.3+20230105/google_recommendationengine1_beta1/api::ProjectLocationCatalogEventStoreUserEventCollectCall), [*locations catalogs event stores user events import*](https://docs.rs/google-recommendationengine1_beta1/5.0.3+20230105/google_recommendationengine1_beta1/api::ProjectLocationCatalogEventStoreUserEventImportCall), [*locations catalogs event stores user events list*](https://docs.rs/google-recommendationengine1_beta1/5.0.3+20230105/google_recommendationengine1_beta1/api::ProjectLocationCatalogEventStoreUserEventListCall), [*locations catalogs event stores user events purge*](https://docs.rs/google-recommendationengine1_beta1/5.0.3+20230105/google_recommendationengine1_beta1/api::ProjectLocationCatalogEventStoreUserEventPurgeCall), [*locations catalogs event stores user events rejoin*](https://docs.rs/google-recommendationengine1_beta1/5.0.3+20230105/google_recommendationengine1_beta1/api::ProjectLocationCatalogEventStoreUserEventRejoinCall), [*locations catalogs event stores user events write*](https://docs.rs/google-recommendationengine1_beta1/5.0.3+20230105/google_recommendationengine1_beta1/api::ProjectLocationCatalogEventStoreUserEventWriteCall), [*locations catalogs list*](https://docs.rs/google-recommendationengine1_beta1/5.0.3+20230105/google_recommendationengine1_beta1/api::ProjectLocationCatalogListCall), [*locations catalogs operations get*](https://docs.rs/google-recommendationengine1_beta1/5.0.3+20230105/google_recommendationengine1_beta1/api::ProjectLocationCatalogOperationGetCall), [*locations catalogs operations list*](https://docs.rs/google-recommendationengine1_beta1/5.0.3+20230105/google_recommendationengine1_beta1/api::ProjectLocationCatalogOperationListCall) and [*locations catalogs patch*](https://docs.rs/google-recommendationengine1_beta1/5.0.3+20230105/google_recommendationengine1_beta1/api::ProjectLocationCatalogPatchCall) @@ -55,8 +55,8 @@ let r = hub.projects().locations_catalogs_event_stores_user_events_rejoin(...).d let r = hub.projects().locations_catalogs_operations_get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -84,12 +84,12 @@ use recommendationengine1_beta1::{Result, Error}; use std::default::Default; use recommendationengine1_beta1::{RecommendationsAI, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -130,10 +130,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-recommendationengine1_beta1/5.0.3+20230105/google_recommendationengine1_beta1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-recommendationengine1_beta1/5.0.3+20230105/google_recommendationengine1_beta1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -143,25 +143,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-recomm You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-recommendationengine1_beta1/5.0.3+20230105/google_recommendationengine1_beta1/client::Delegate) to the -[Method Builder](https://docs.rs/google-recommendationengine1_beta1/5.0.3+20230105/google_recommendationengine1_beta1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-recommendationengine1_beta1/5.0.3+20230105/google_recommendationengine1_beta1/client::Delegate) to the +[Method Builder](https://docs.rs/google-recommendationengine1_beta1/5.0.3+20230105/google_recommendationengine1_beta1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-recommendationengine1_beta1/5.0.3+20230105/google_recommendationengine1_beta1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-recommendationengine1_beta1/5.0.3+20230105/google_recommendationengine1_beta1/client::RequestValue) and -[decodable](https://docs.rs/google-recommendationengine1_beta1/5.0.3+20230105/google_recommendationengine1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-recommendationengine1_beta1/5.0.3+20230105/google_recommendationengine1_beta1/client::RequestValue) and +[decodable](https://docs.rs/google-recommendationengine1_beta1/5.0.3+20230105/google_recommendationengine1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-recommendationengine1_beta1/5.0.3+20230105/google_recommendationengine1_beta1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-recommendationengine1_beta1/5.0.3+20230105/google_recommendationengine1_beta1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -180,7 +180,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **recommendationengine1_beta1** library was generated by Sebastian Thiel, and is placed +The **recommendationengine1_beta1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/recommendationengine1_beta1/src/api.rs b/gen/recommendationengine1_beta1/src/api.rs index 33c2e2523b..624ecd4115 100644 --- a/gen/recommendationengine1_beta1/src/api.rs +++ b/gen/recommendationengine1_beta1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use recommendationengine1_beta1::{RecommendationsAI, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/recommendationengine1_beta1/src/lib.rs b/gen/recommendationengine1_beta1/src/lib.rs index 94cba3ecc2..dfbaabd30f 100644 --- a/gen/recommendationengine1_beta1/src/lib.rs +++ b/gen/recommendationengine1_beta1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/recommendationengine1_beta1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](RecommendationsAI) ... +//! Handle the following *Resources* with ease from the central [hub](RecommendationsAI) ... //! //! * projects //! * [*locations catalogs catalog items create*](api::ProjectLocationCatalogCatalogItemCreateCall), [*locations catalogs catalog items delete*](api::ProjectLocationCatalogCatalogItemDeleteCall), [*locations catalogs catalog items get*](api::ProjectLocationCatalogCatalogItemGetCall), [*locations catalogs catalog items import*](api::ProjectLocationCatalogCatalogItemImportCall), [*locations catalogs catalog items list*](api::ProjectLocationCatalogCatalogItemListCall), [*locations catalogs catalog items patch*](api::ProjectLocationCatalogCatalogItemPatchCall), [*locations catalogs event stores operations get*](api::ProjectLocationCatalogEventStoreOperationGetCall), [*locations catalogs event stores operations list*](api::ProjectLocationCatalogEventStoreOperationListCall), [*locations catalogs event stores placements predict*](api::ProjectLocationCatalogEventStorePlacementPredictCall), [*locations catalogs event stores prediction api key registrations create*](api::ProjectLocationCatalogEventStorePredictionApiKeyRegistrationCreateCall), [*locations catalogs event stores prediction api key registrations delete*](api::ProjectLocationCatalogEventStorePredictionApiKeyRegistrationDeleteCall), [*locations catalogs event stores prediction api key registrations list*](api::ProjectLocationCatalogEventStorePredictionApiKeyRegistrationListCall), [*locations catalogs event stores user events collect*](api::ProjectLocationCatalogEventStoreUserEventCollectCall), [*locations catalogs event stores user events import*](api::ProjectLocationCatalogEventStoreUserEventImportCall), [*locations catalogs event stores user events list*](api::ProjectLocationCatalogEventStoreUserEventListCall), [*locations catalogs event stores user events purge*](api::ProjectLocationCatalogEventStoreUserEventPurgeCall), [*locations catalogs event stores user events rejoin*](api::ProjectLocationCatalogEventStoreUserEventRejoinCall), [*locations catalogs event stores user events write*](api::ProjectLocationCatalogEventStoreUserEventWriteCall), [*locations catalogs list*](api::ProjectLocationCatalogListCall), [*locations catalogs operations get*](api::ProjectLocationCatalogOperationGetCall), [*locations catalogs operations list*](api::ProjectLocationCatalogOperationListCall) and [*locations catalogs patch*](api::ProjectLocationCatalogPatchCall) @@ -55,8 +55,8 @@ //! let r = hub.projects().locations_catalogs_operations_get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -85,12 +85,12 @@ //! use std::default::Default; //! use recommendationengine1_beta1::{RecommendationsAI, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -131,10 +131,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -144,25 +144,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/recommender1/README.md b/gen/recommender1/README.md index 5bfa2c783b..9a16d24cfe 100644 --- a/gen/recommender1/README.md +++ b/gen/recommender1/README.md @@ -11,7 +11,7 @@ Everything else about the *Recommender* *v1* API can be found at the [official documentation site](https://cloud.google.com/recommender/docs/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-recommender1/5.0.3+20230108/google_recommender1/Recommender) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-recommender1/5.0.3+20230108/google_recommender1/Recommender) ... * billing accounts * [*locations insight types get config*](https://docs.rs/google-recommender1/5.0.3+20230108/google_recommender1/api::BillingAccountLocationInsightTypeGetConfigCall), [*locations insight types insights get*](https://docs.rs/google-recommender1/5.0.3+20230108/google_recommender1/api::BillingAccountLocationInsightTypeInsightGetCall), [*locations insight types insights list*](https://docs.rs/google-recommender1/5.0.3+20230108/google_recommender1/api::BillingAccountLocationInsightTypeInsightListCall), [*locations insight types insights mark accepted*](https://docs.rs/google-recommender1/5.0.3+20230108/google_recommender1/api::BillingAccountLocationInsightTypeInsightMarkAcceptedCall), [*locations insight types update config*](https://docs.rs/google-recommender1/5.0.3+20230108/google_recommender1/api::BillingAccountLocationInsightTypeUpdateConfigCall), [*locations recommenders get config*](https://docs.rs/google-recommender1/5.0.3+20230108/google_recommender1/api::BillingAccountLocationRecommenderGetConfigCall), [*locations recommenders recommendations get*](https://docs.rs/google-recommender1/5.0.3+20230108/google_recommender1/api::BillingAccountLocationRecommenderRecommendationGetCall), [*locations recommenders recommendations list*](https://docs.rs/google-recommender1/5.0.3+20230108/google_recommender1/api::BillingAccountLocationRecommenderRecommendationListCall), [*locations recommenders recommendations mark claimed*](https://docs.rs/google-recommender1/5.0.3+20230108/google_recommender1/api::BillingAccountLocationRecommenderRecommendationMarkClaimedCall), [*locations recommenders recommendations mark dismissed*](https://docs.rs/google-recommender1/5.0.3+20230108/google_recommender1/api::BillingAccountLocationRecommenderRecommendationMarkDismissedCall), [*locations recommenders recommendations mark failed*](https://docs.rs/google-recommender1/5.0.3+20230108/google_recommender1/api::BillingAccountLocationRecommenderRecommendationMarkFailedCall), [*locations recommenders recommendations mark succeeded*](https://docs.rs/google-recommender1/5.0.3+20230108/google_recommender1/api::BillingAccountLocationRecommenderRecommendationMarkSucceededCall) and [*locations recommenders update config*](https://docs.rs/google-recommender1/5.0.3+20230108/google_recommender1/api::BillingAccountLocationRecommenderUpdateConfigCall) @@ -75,8 +75,8 @@ let r = hub.projects().locations_recommenders_recommendations_mark_failed(...).d let r = hub.projects().locations_recommenders_recommendations_mark_succeeded(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -104,12 +104,12 @@ use recommender1::{Result, Error}; use std::default::Default; use recommender1::{Recommender, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -150,10 +150,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-recommender1/5.0.3+20230108/google_recommender1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-recommender1/5.0.3+20230108/google_recommender1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -163,25 +163,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-recomm You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-recommender1/5.0.3+20230108/google_recommender1/client::Delegate) to the -[Method Builder](https://docs.rs/google-recommender1/5.0.3+20230108/google_recommender1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-recommender1/5.0.3+20230108/google_recommender1/client::Delegate) to the +[Method Builder](https://docs.rs/google-recommender1/5.0.3+20230108/google_recommender1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-recommender1/5.0.3+20230108/google_recommender1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-recommender1/5.0.3+20230108/google_recommender1/client::RequestValue) and -[decodable](https://docs.rs/google-recommender1/5.0.3+20230108/google_recommender1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-recommender1/5.0.3+20230108/google_recommender1/client::RequestValue) and +[decodable](https://docs.rs/google-recommender1/5.0.3+20230108/google_recommender1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-recommender1/5.0.3+20230108/google_recommender1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-recommender1/5.0.3+20230108/google_recommender1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -200,7 +200,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **recommender1** library was generated by Sebastian Thiel, and is placed +The **recommender1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/recommender1/src/api.rs b/gen/recommender1/src/api.rs index 0adf3b3abc..edff29dbe1 100644 --- a/gen/recommender1/src/api.rs +++ b/gen/recommender1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use recommender1::{Recommender, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/recommender1/src/lib.rs b/gen/recommender1/src/lib.rs index dccdf69732..1ea5d0c83f 100644 --- a/gen/recommender1/src/lib.rs +++ b/gen/recommender1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/recommender1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Recommender) ... +//! Handle the following *Resources* with ease from the central [hub](Recommender) ... //! //! * billing accounts //! * [*locations insight types get config*](api::BillingAccountLocationInsightTypeGetConfigCall), [*locations insight types insights get*](api::BillingAccountLocationInsightTypeInsightGetCall), [*locations insight types insights list*](api::BillingAccountLocationInsightTypeInsightListCall), [*locations insight types insights mark accepted*](api::BillingAccountLocationInsightTypeInsightMarkAcceptedCall), [*locations insight types update config*](api::BillingAccountLocationInsightTypeUpdateConfigCall), [*locations recommenders get config*](api::BillingAccountLocationRecommenderGetConfigCall), [*locations recommenders recommendations get*](api::BillingAccountLocationRecommenderRecommendationGetCall), [*locations recommenders recommendations list*](api::BillingAccountLocationRecommenderRecommendationListCall), [*locations recommenders recommendations mark claimed*](api::BillingAccountLocationRecommenderRecommendationMarkClaimedCall), [*locations recommenders recommendations mark dismissed*](api::BillingAccountLocationRecommenderRecommendationMarkDismissedCall), [*locations recommenders recommendations mark failed*](api::BillingAccountLocationRecommenderRecommendationMarkFailedCall), [*locations recommenders recommendations mark succeeded*](api::BillingAccountLocationRecommenderRecommendationMarkSucceededCall) and [*locations recommenders update config*](api::BillingAccountLocationRecommenderUpdateConfigCall) @@ -75,8 +75,8 @@ //! let r = hub.projects().locations_recommenders_recommendations_mark_succeeded(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -105,12 +105,12 @@ //! use std::default::Default; //! use recommender1::{Recommender, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -151,10 +151,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -164,25 +164,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/recommender1_beta1/README.md b/gen/recommender1_beta1/README.md index cae49580df..77d03eaf46 100644 --- a/gen/recommender1_beta1/README.md +++ b/gen/recommender1_beta1/README.md @@ -11,7 +11,7 @@ Everything else about the *Recommender* *v1_beta1* API can be found at the [official documentation site](https://cloud.google.com/recommender/docs/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-recommender1_beta1/5.0.3+20230108/google_recommender1_beta1/Recommender) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-recommender1_beta1/5.0.3+20230108/google_recommender1_beta1/Recommender) ... * billing accounts * [*locations insight types get config*](https://docs.rs/google-recommender1_beta1/5.0.3+20230108/google_recommender1_beta1/api::BillingAccountLocationInsightTypeGetConfigCall), [*locations insight types insights get*](https://docs.rs/google-recommender1_beta1/5.0.3+20230108/google_recommender1_beta1/api::BillingAccountLocationInsightTypeInsightGetCall), [*locations insight types insights list*](https://docs.rs/google-recommender1_beta1/5.0.3+20230108/google_recommender1_beta1/api::BillingAccountLocationInsightTypeInsightListCall), [*locations insight types insights mark accepted*](https://docs.rs/google-recommender1_beta1/5.0.3+20230108/google_recommender1_beta1/api::BillingAccountLocationInsightTypeInsightMarkAcceptedCall), [*locations insight types update config*](https://docs.rs/google-recommender1_beta1/5.0.3+20230108/google_recommender1_beta1/api::BillingAccountLocationInsightTypeUpdateConfigCall), [*locations recommenders get config*](https://docs.rs/google-recommender1_beta1/5.0.3+20230108/google_recommender1_beta1/api::BillingAccountLocationRecommenderGetConfigCall), [*locations recommenders recommendations get*](https://docs.rs/google-recommender1_beta1/5.0.3+20230108/google_recommender1_beta1/api::BillingAccountLocationRecommenderRecommendationGetCall), [*locations recommenders recommendations list*](https://docs.rs/google-recommender1_beta1/5.0.3+20230108/google_recommender1_beta1/api::BillingAccountLocationRecommenderRecommendationListCall), [*locations recommenders recommendations mark claimed*](https://docs.rs/google-recommender1_beta1/5.0.3+20230108/google_recommender1_beta1/api::BillingAccountLocationRecommenderRecommendationMarkClaimedCall), [*locations recommenders recommendations mark dismissed*](https://docs.rs/google-recommender1_beta1/5.0.3+20230108/google_recommender1_beta1/api::BillingAccountLocationRecommenderRecommendationMarkDismissedCall), [*locations recommenders recommendations mark failed*](https://docs.rs/google-recommender1_beta1/5.0.3+20230108/google_recommender1_beta1/api::BillingAccountLocationRecommenderRecommendationMarkFailedCall), [*locations recommenders recommendations mark succeeded*](https://docs.rs/google-recommender1_beta1/5.0.3+20230108/google_recommender1_beta1/api::BillingAccountLocationRecommenderRecommendationMarkSucceededCall) and [*locations recommenders update config*](https://docs.rs/google-recommender1_beta1/5.0.3+20230108/google_recommender1_beta1/api::BillingAccountLocationRecommenderUpdateConfigCall) @@ -75,8 +75,8 @@ let r = hub.projects().locations_recommenders_recommendations_mark_failed(...).d let r = hub.projects().locations_recommenders_recommendations_mark_succeeded(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -104,12 +104,12 @@ use recommender1_beta1::{Result, Error}; use std::default::Default; use recommender1_beta1::{Recommender, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -150,10 +150,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-recommender1_beta1/5.0.3+20230108/google_recommender1_beta1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-recommender1_beta1/5.0.3+20230108/google_recommender1_beta1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -163,25 +163,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-recomm You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-recommender1_beta1/5.0.3+20230108/google_recommender1_beta1/client::Delegate) to the -[Method Builder](https://docs.rs/google-recommender1_beta1/5.0.3+20230108/google_recommender1_beta1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-recommender1_beta1/5.0.3+20230108/google_recommender1_beta1/client::Delegate) to the +[Method Builder](https://docs.rs/google-recommender1_beta1/5.0.3+20230108/google_recommender1_beta1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-recommender1_beta1/5.0.3+20230108/google_recommender1_beta1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-recommender1_beta1/5.0.3+20230108/google_recommender1_beta1/client::RequestValue) and -[decodable](https://docs.rs/google-recommender1_beta1/5.0.3+20230108/google_recommender1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-recommender1_beta1/5.0.3+20230108/google_recommender1_beta1/client::RequestValue) and +[decodable](https://docs.rs/google-recommender1_beta1/5.0.3+20230108/google_recommender1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-recommender1_beta1/5.0.3+20230108/google_recommender1_beta1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-recommender1_beta1/5.0.3+20230108/google_recommender1_beta1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -200,7 +200,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **recommender1_beta1** library was generated by Sebastian Thiel, and is placed +The **recommender1_beta1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/recommender1_beta1/src/api.rs b/gen/recommender1_beta1/src/api.rs index 9f64efe3dd..88474fe4c7 100644 --- a/gen/recommender1_beta1/src/api.rs +++ b/gen/recommender1_beta1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use recommender1_beta1::{Recommender, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/recommender1_beta1/src/lib.rs b/gen/recommender1_beta1/src/lib.rs index ae79debf22..0a2134c723 100644 --- a/gen/recommender1_beta1/src/lib.rs +++ b/gen/recommender1_beta1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/recommender1_beta1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Recommender) ... +//! Handle the following *Resources* with ease from the central [hub](Recommender) ... //! //! * billing accounts //! * [*locations insight types get config*](api::BillingAccountLocationInsightTypeGetConfigCall), [*locations insight types insights get*](api::BillingAccountLocationInsightTypeInsightGetCall), [*locations insight types insights list*](api::BillingAccountLocationInsightTypeInsightListCall), [*locations insight types insights mark accepted*](api::BillingAccountLocationInsightTypeInsightMarkAcceptedCall), [*locations insight types update config*](api::BillingAccountLocationInsightTypeUpdateConfigCall), [*locations recommenders get config*](api::BillingAccountLocationRecommenderGetConfigCall), [*locations recommenders recommendations get*](api::BillingAccountLocationRecommenderRecommendationGetCall), [*locations recommenders recommendations list*](api::BillingAccountLocationRecommenderRecommendationListCall), [*locations recommenders recommendations mark claimed*](api::BillingAccountLocationRecommenderRecommendationMarkClaimedCall), [*locations recommenders recommendations mark dismissed*](api::BillingAccountLocationRecommenderRecommendationMarkDismissedCall), [*locations recommenders recommendations mark failed*](api::BillingAccountLocationRecommenderRecommendationMarkFailedCall), [*locations recommenders recommendations mark succeeded*](api::BillingAccountLocationRecommenderRecommendationMarkSucceededCall) and [*locations recommenders update config*](api::BillingAccountLocationRecommenderUpdateConfigCall) @@ -75,8 +75,8 @@ //! let r = hub.projects().locations_recommenders_recommendations_mark_succeeded(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -105,12 +105,12 @@ //! use std::default::Default; //! use recommender1_beta1::{Recommender, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -151,10 +151,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -164,25 +164,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/redis1/README.md b/gen/redis1/README.md index 6f65f9b4ef..bf7f597b5e 100644 --- a/gen/redis1/README.md +++ b/gen/redis1/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Redis* *v1* API can be found at the [official documentation site](https://cloud.google.com/memorystore/docs/redis/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-redis1/5.0.3+20230111/google_redis1/CloudRedis) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-redis1/5.0.3+20230111/google_redis1/CloudRedis) ... * projects * [*locations get*](https://docs.rs/google-redis1/5.0.3+20230111/google_redis1/api::ProjectLocationGetCall), [*locations instances create*](https://docs.rs/google-redis1/5.0.3+20230111/google_redis1/api::ProjectLocationInstanceCreateCall), [*locations instances delete*](https://docs.rs/google-redis1/5.0.3+20230111/google_redis1/api::ProjectLocationInstanceDeleteCall), [*locations instances export*](https://docs.rs/google-redis1/5.0.3+20230111/google_redis1/api::ProjectLocationInstanceExportCall), [*locations instances failover*](https://docs.rs/google-redis1/5.0.3+20230111/google_redis1/api::ProjectLocationInstanceFailoverCall), [*locations instances get*](https://docs.rs/google-redis1/5.0.3+20230111/google_redis1/api::ProjectLocationInstanceGetCall), [*locations instances get auth string*](https://docs.rs/google-redis1/5.0.3+20230111/google_redis1/api::ProjectLocationInstanceGetAuthStringCall), [*locations instances import*](https://docs.rs/google-redis1/5.0.3+20230111/google_redis1/api::ProjectLocationInstanceImportCall), [*locations instances list*](https://docs.rs/google-redis1/5.0.3+20230111/google_redis1/api::ProjectLocationInstanceListCall), [*locations instances patch*](https://docs.rs/google-redis1/5.0.3+20230111/google_redis1/api::ProjectLocationInstancePatchCall), [*locations instances reschedule maintenance*](https://docs.rs/google-redis1/5.0.3+20230111/google_redis1/api::ProjectLocationInstanceRescheduleMaintenanceCall), [*locations instances upgrade*](https://docs.rs/google-redis1/5.0.3+20230111/google_redis1/api::ProjectLocationInstanceUpgradeCall), [*locations list*](https://docs.rs/google-redis1/5.0.3+20230111/google_redis1/api::ProjectLocationListCall), [*locations operations cancel*](https://docs.rs/google-redis1/5.0.3+20230111/google_redis1/api::ProjectLocationOperationCancelCall), [*locations operations delete*](https://docs.rs/google-redis1/5.0.3+20230111/google_redis1/api::ProjectLocationOperationDeleteCall), [*locations operations get*](https://docs.rs/google-redis1/5.0.3+20230111/google_redis1/api::ProjectLocationOperationGetCall) and [*locations operations list*](https://docs.rs/google-redis1/5.0.3+20230111/google_redis1/api::ProjectLocationOperationListCall) @@ -58,8 +58,8 @@ let r = hub.projects().locations_instances_upgrade(...).doit().await let r = hub.projects().locations_operations_get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -87,12 +87,12 @@ use redis1::{Result, Error}; use std::default::Default; use redis1::{CloudRedis, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -134,10 +134,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-redis1/5.0.3+20230111/google_redis1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-redis1/5.0.3+20230111/google_redis1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -147,25 +147,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-redis1 You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-redis1/5.0.3+20230111/google_redis1/client::Delegate) to the -[Method Builder](https://docs.rs/google-redis1/5.0.3+20230111/google_redis1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-redis1/5.0.3+20230111/google_redis1/client::Delegate) to the +[Method Builder](https://docs.rs/google-redis1/5.0.3+20230111/google_redis1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-redis1/5.0.3+20230111/google_redis1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-redis1/5.0.3+20230111/google_redis1/client::RequestValue) and -[decodable](https://docs.rs/google-redis1/5.0.3+20230111/google_redis1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-redis1/5.0.3+20230111/google_redis1/client::RequestValue) and +[decodable](https://docs.rs/google-redis1/5.0.3+20230111/google_redis1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-redis1/5.0.3+20230111/google_redis1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-redis1/5.0.3+20230111/google_redis1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -184,7 +184,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **redis1** library was generated by Sebastian Thiel, and is placed +The **redis1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/redis1/src/api.rs b/gen/redis1/src/api.rs index 3fbea35ffe..ce8996c325 100644 --- a/gen/redis1/src/api.rs +++ b/gen/redis1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use redis1::{CloudRedis, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/redis1/src/lib.rs b/gen/redis1/src/lib.rs index 360afac48e..0388e6691f 100644 --- a/gen/redis1/src/lib.rs +++ b/gen/redis1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/redis1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudRedis) ... +//! Handle the following *Resources* with ease from the central [hub](CloudRedis) ... //! //! * projects //! * [*locations get*](api::ProjectLocationGetCall), [*locations instances create*](api::ProjectLocationInstanceCreateCall), [*locations instances delete*](api::ProjectLocationInstanceDeleteCall), [*locations instances export*](api::ProjectLocationInstanceExportCall), [*locations instances failover*](api::ProjectLocationInstanceFailoverCall), [*locations instances get*](api::ProjectLocationInstanceGetCall), [*locations instances get auth string*](api::ProjectLocationInstanceGetAuthStringCall), [*locations instances import*](api::ProjectLocationInstanceImportCall), [*locations instances list*](api::ProjectLocationInstanceListCall), [*locations instances patch*](api::ProjectLocationInstancePatchCall), [*locations instances reschedule maintenance*](api::ProjectLocationInstanceRescheduleMaintenanceCall), [*locations instances upgrade*](api::ProjectLocationInstanceUpgradeCall), [*locations list*](api::ProjectLocationListCall), [*locations operations cancel*](api::ProjectLocationOperationCancelCall), [*locations operations delete*](api::ProjectLocationOperationDeleteCall), [*locations operations get*](api::ProjectLocationOperationGetCall) and [*locations operations list*](api::ProjectLocationOperationListCall) @@ -58,8 +58,8 @@ //! let r = hub.projects().locations_operations_get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -88,12 +88,12 @@ //! use std::default::Default; //! use redis1::{CloudRedis, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -135,10 +135,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -148,25 +148,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/remotebuildexecution2/README.md b/gen/remotebuildexecution2/README.md index be54de25d9..a9c7adeacb 100644 --- a/gen/remotebuildexecution2/README.md +++ b/gen/remotebuildexecution2/README.md @@ -11,7 +11,7 @@ Everything else about the *Remote Build Execution* *v2* API can be found at the [official documentation site](https://cloud.google.com/remote-build-execution/docs/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-remotebuildexecution2/5.0.3+20210329/google_remotebuildexecution2/RemoteBuildExecution) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-remotebuildexecution2/5.0.3+20210329/google_remotebuildexecution2/RemoteBuildExecution) ... * action results * [*get*](https://docs.rs/google-remotebuildexecution2/5.0.3+20210329/google_remotebuildexecution2/api::ActionResultGetCall) and [*update*](https://docs.rs/google-remotebuildexecution2/5.0.3+20210329/google_remotebuildexecution2/api::ActionResultUpdateCall) @@ -60,8 +60,8 @@ let r = hub.action_results().get(...).doit().await let r = hub.action_results().update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -88,12 +88,12 @@ use remotebuildexecution2::{Result, Error}; use std::default::Default; use remotebuildexecution2::{RemoteBuildExecution, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -132,10 +132,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-remotebuildexecution2/5.0.3+20210329/google_remotebuildexecution2/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-remotebuildexecution2/5.0.3+20210329/google_remotebuildexecution2/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -145,25 +145,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-remote You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-remotebuildexecution2/5.0.3+20210329/google_remotebuildexecution2/client::Delegate) to the -[Method Builder](https://docs.rs/google-remotebuildexecution2/5.0.3+20210329/google_remotebuildexecution2/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-remotebuildexecution2/5.0.3+20210329/google_remotebuildexecution2/client::Delegate) to the +[Method Builder](https://docs.rs/google-remotebuildexecution2/5.0.3+20210329/google_remotebuildexecution2/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-remotebuildexecution2/5.0.3+20210329/google_remotebuildexecution2/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-remotebuildexecution2/5.0.3+20210329/google_remotebuildexecution2/client::RequestValue) and -[decodable](https://docs.rs/google-remotebuildexecution2/5.0.3+20210329/google_remotebuildexecution2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-remotebuildexecution2/5.0.3+20210329/google_remotebuildexecution2/client::RequestValue) and +[decodable](https://docs.rs/google-remotebuildexecution2/5.0.3+20210329/google_remotebuildexecution2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-remotebuildexecution2/5.0.3+20210329/google_remotebuildexecution2/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-remotebuildexecution2/5.0.3+20210329/google_remotebuildexecution2/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -182,7 +182,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **remotebuildexecution2** library was generated by Sebastian Thiel, and is placed +The **remotebuildexecution2** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/remotebuildexecution2/src/api.rs b/gen/remotebuildexecution2/src/api.rs index 41eaf732f6..5cdbc29993 100644 --- a/gen/remotebuildexecution2/src/api.rs +++ b/gen/remotebuildexecution2/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud Platform data CloudPlatform, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use remotebuildexecution2::{RemoteBuildExecution, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/remotebuildexecution2/src/lib.rs b/gen/remotebuildexecution2/src/lib.rs index 1922af5da1..7bc96a633c 100644 --- a/gen/remotebuildexecution2/src/lib.rs +++ b/gen/remotebuildexecution2/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/remotebuildexecution2). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](RemoteBuildExecution) ... +//! Handle the following *Resources* with ease from the central [hub](RemoteBuildExecution) ... //! //! * action results //! * [*get*](api::ActionResultGetCall) and [*update*](api::ActionResultUpdateCall) @@ -60,8 +60,8 @@ //! let r = hub.action_results().update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -89,12 +89,12 @@ //! use std::default::Default; //! use remotebuildexecution2::{RemoteBuildExecution, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -133,10 +133,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -146,25 +146,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/replicapool1_beta2/README.md b/gen/replicapool1_beta2/README.md index c4e8b3c0ee..bab18f6c6c 100644 --- a/gen/replicapool1_beta2/README.md +++ b/gen/replicapool1_beta2/README.md @@ -11,7 +11,7 @@ Everything else about the *replicapool* *v1_beta2* API can be found at the [official documentation site](https://developers.google.com/compute/docs/instance-groups/manager/v1beta2). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-replicapool1_beta2/5.0.3+20160512/google_replicapool1_beta2/Replicapool) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-replicapool1_beta2/5.0.3+20160512/google_replicapool1_beta2/Replicapool) ... * [instance group managers](https://docs.rs/google-replicapool1_beta2/5.0.3+20160512/google_replicapool1_beta2/api::InstanceGroupManager) * [*abandon instances*](https://docs.rs/google-replicapool1_beta2/5.0.3+20160512/google_replicapool1_beta2/api::InstanceGroupManagerAbandonInstanceCall), [*delete*](https://docs.rs/google-replicapool1_beta2/5.0.3+20160512/google_replicapool1_beta2/api::InstanceGroupManagerDeleteCall), [*delete instances*](https://docs.rs/google-replicapool1_beta2/5.0.3+20160512/google_replicapool1_beta2/api::InstanceGroupManagerDeleteInstanceCall), [*get*](https://docs.rs/google-replicapool1_beta2/5.0.3+20160512/google_replicapool1_beta2/api::InstanceGroupManagerGetCall), [*insert*](https://docs.rs/google-replicapool1_beta2/5.0.3+20160512/google_replicapool1_beta2/api::InstanceGroupManagerInsertCall), [*list*](https://docs.rs/google-replicapool1_beta2/5.0.3+20160512/google_replicapool1_beta2/api::InstanceGroupManagerListCall), [*recreate instances*](https://docs.rs/google-replicapool1_beta2/5.0.3+20160512/google_replicapool1_beta2/api::InstanceGroupManagerRecreateInstanceCall), [*resize*](https://docs.rs/google-replicapool1_beta2/5.0.3+20160512/google_replicapool1_beta2/api::InstanceGroupManagerResizeCall), [*set instance template*](https://docs.rs/google-replicapool1_beta2/5.0.3+20160512/google_replicapool1_beta2/api::InstanceGroupManagerSetInstanceTemplateCall) and [*set target pools*](https://docs.rs/google-replicapool1_beta2/5.0.3+20160512/google_replicapool1_beta2/api::InstanceGroupManagerSetTargetPoolCall) @@ -61,8 +61,8 @@ let r = hub.instance_group_managers().set_instance_template(...).doit().await let r = hub.instance_group_managers().set_target_pools(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -89,12 +89,12 @@ use replicapool1_beta2::{Result, Error}; use std::default::Default; use replicapool1_beta2::{Replicapool, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -133,10 +133,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-replicapool1_beta2/5.0.3+20160512/google_replicapool1_beta2/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-replicapool1_beta2/5.0.3+20160512/google_replicapool1_beta2/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -146,25 +146,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-replic You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-replicapool1_beta2/5.0.3+20160512/google_replicapool1_beta2/client::Delegate) to the -[Method Builder](https://docs.rs/google-replicapool1_beta2/5.0.3+20160512/google_replicapool1_beta2/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-replicapool1_beta2/5.0.3+20160512/google_replicapool1_beta2/client::Delegate) to the +[Method Builder](https://docs.rs/google-replicapool1_beta2/5.0.3+20160512/google_replicapool1_beta2/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-replicapool1_beta2/5.0.3+20160512/google_replicapool1_beta2/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-replicapool1_beta2/5.0.3+20160512/google_replicapool1_beta2/client::RequestValue) and -[decodable](https://docs.rs/google-replicapool1_beta2/5.0.3+20160512/google_replicapool1_beta2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-replicapool1_beta2/5.0.3+20160512/google_replicapool1_beta2/client::RequestValue) and +[decodable](https://docs.rs/google-replicapool1_beta2/5.0.3+20160512/google_replicapool1_beta2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-replicapool1_beta2/5.0.3+20160512/google_replicapool1_beta2/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-replicapool1_beta2/5.0.3+20160512/google_replicapool1_beta2/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -183,7 +183,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **replicapool1_beta2** library was generated by Sebastian Thiel, and is placed +The **replicapool1_beta2** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/replicapool1_beta2/src/api.rs b/gen/replicapool1_beta2/src/api.rs index 1e2b1f1424..f234d03347 100644 --- a/gen/replicapool1_beta2/src/api.rs +++ b/gen/replicapool1_beta2/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your data across Google Cloud Platform services CloudPlatform, @@ -76,12 +76,12 @@ impl Default for Scope { /// use std::default::Default; /// use replicapool1_beta2::{Replicapool, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/replicapool1_beta2/src/lib.rs b/gen/replicapool1_beta2/src/lib.rs index baaddafd91..c45e0f90c2 100644 --- a/gen/replicapool1_beta2/src/lib.rs +++ b/gen/replicapool1_beta2/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/replicapool1_beta2). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Replicapool) ... +//! Handle the following *Resources* with ease from the central [hub](Replicapool) ... //! //! * [instance group managers](api::InstanceGroupManager) //! * [*abandon instances*](api::InstanceGroupManagerAbandonInstanceCall), [*delete*](api::InstanceGroupManagerDeleteCall), [*delete instances*](api::InstanceGroupManagerDeleteInstanceCall), [*get*](api::InstanceGroupManagerGetCall), [*insert*](api::InstanceGroupManagerInsertCall), [*list*](api::InstanceGroupManagerListCall), [*recreate instances*](api::InstanceGroupManagerRecreateInstanceCall), [*resize*](api::InstanceGroupManagerResizeCall), [*set instance template*](api::InstanceGroupManagerSetInstanceTemplateCall) and [*set target pools*](api::InstanceGroupManagerSetTargetPoolCall) @@ -61,8 +61,8 @@ //! let r = hub.instance_group_managers().set_target_pools(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -90,12 +90,12 @@ //! use std::default::Default; //! use replicapool1_beta2::{Replicapool, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -134,10 +134,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -147,25 +147,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/replicapoolupdater1_beta1/README.md b/gen/replicapoolupdater1_beta1/README.md index 880093929a..74dbc5fd2d 100644 --- a/gen/replicapoolupdater1_beta1/README.md +++ b/gen/replicapoolupdater1_beta1/README.md @@ -11,7 +11,7 @@ Everything else about the *replicapoolupdater* *v1_beta1* API can be found at th [official documentation site](https://cloud.google.com/compute/docs/instance-groups/manager/#applying_rolling_updates_using_the_updater_service). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-replicapoolupdater1_beta1/5.0.3+20161003/google_replicapoolupdater1_beta1/Replicapoolupdater) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-replicapoolupdater1_beta1/5.0.3+20161003/google_replicapoolupdater1_beta1/Replicapoolupdater) ... * [rolling updates](https://docs.rs/google-replicapoolupdater1_beta1/5.0.3+20161003/google_replicapoolupdater1_beta1/api::RollingUpdate) * [*cancel*](https://docs.rs/google-replicapoolupdater1_beta1/5.0.3+20161003/google_replicapoolupdater1_beta1/api::RollingUpdateCancelCall), [*get*](https://docs.rs/google-replicapoolupdater1_beta1/5.0.3+20161003/google_replicapoolupdater1_beta1/api::RollingUpdateGetCall), [*insert*](https://docs.rs/google-replicapoolupdater1_beta1/5.0.3+20161003/google_replicapoolupdater1_beta1/api::RollingUpdateInsertCall), [*list*](https://docs.rs/google-replicapoolupdater1_beta1/5.0.3+20161003/google_replicapoolupdater1_beta1/api::RollingUpdateListCall), [*list instance updates*](https://docs.rs/google-replicapoolupdater1_beta1/5.0.3+20161003/google_replicapoolupdater1_beta1/api::RollingUpdateListInstanceUpdateCall), [*pause*](https://docs.rs/google-replicapoolupdater1_beta1/5.0.3+20161003/google_replicapoolupdater1_beta1/api::RollingUpdatePauseCall), [*resume*](https://docs.rs/google-replicapoolupdater1_beta1/5.0.3+20161003/google_replicapoolupdater1_beta1/api::RollingUpdateResumeCall) and [*rollback*](https://docs.rs/google-replicapoolupdater1_beta1/5.0.3+20161003/google_replicapoolupdater1_beta1/api::RollingUpdateRollbackCall) @@ -59,8 +59,8 @@ let r = hub.rolling_updates().resume(...).doit().await let r = hub.rolling_updates().rollback(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -87,12 +87,12 @@ use replicapoolupdater1_beta1::{Result, Error}; use std::default::Default; use replicapoolupdater1_beta1::{Replicapoolupdater, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -131,10 +131,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-replicapoolupdater1_beta1/5.0.3+20161003/google_replicapoolupdater1_beta1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-replicapoolupdater1_beta1/5.0.3+20161003/google_replicapoolupdater1_beta1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -144,25 +144,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-replic You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-replicapoolupdater1_beta1/5.0.3+20161003/google_replicapoolupdater1_beta1/client::Delegate) to the -[Method Builder](https://docs.rs/google-replicapoolupdater1_beta1/5.0.3+20161003/google_replicapoolupdater1_beta1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-replicapoolupdater1_beta1/5.0.3+20161003/google_replicapoolupdater1_beta1/client::Delegate) to the +[Method Builder](https://docs.rs/google-replicapoolupdater1_beta1/5.0.3+20161003/google_replicapoolupdater1_beta1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-replicapoolupdater1_beta1/5.0.3+20161003/google_replicapoolupdater1_beta1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-replicapoolupdater1_beta1/5.0.3+20161003/google_replicapoolupdater1_beta1/client::RequestValue) and -[decodable](https://docs.rs/google-replicapoolupdater1_beta1/5.0.3+20161003/google_replicapoolupdater1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-replicapoolupdater1_beta1/5.0.3+20161003/google_replicapoolupdater1_beta1/client::RequestValue) and +[decodable](https://docs.rs/google-replicapoolupdater1_beta1/5.0.3+20161003/google_replicapoolupdater1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-replicapoolupdater1_beta1/5.0.3+20161003/google_replicapoolupdater1_beta1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-replicapoolupdater1_beta1/5.0.3+20161003/google_replicapoolupdater1_beta1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -181,7 +181,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **replicapoolupdater1_beta1** library was generated by Sebastian Thiel, and is placed +The **replicapoolupdater1_beta1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/replicapoolupdater1_beta1/src/api.rs b/gen/replicapoolupdater1_beta1/src/api.rs index 034571f142..ac61360906 100644 --- a/gen/replicapoolupdater1_beta1/src/api.rs +++ b/gen/replicapoolupdater1_beta1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your data across Google Cloud Platform services CloudPlatform, @@ -76,12 +76,12 @@ impl Default for Scope { /// use std::default::Default; /// use replicapoolupdater1_beta1::{Replicapoolupdater, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/replicapoolupdater1_beta1/src/lib.rs b/gen/replicapoolupdater1_beta1/src/lib.rs index eaa12b9987..7bf03ef49f 100644 --- a/gen/replicapoolupdater1_beta1/src/lib.rs +++ b/gen/replicapoolupdater1_beta1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/replicapoolupdater1_beta1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Replicapoolupdater) ... +//! Handle the following *Resources* with ease from the central [hub](Replicapoolupdater) ... //! //! * [rolling updates](api::RollingUpdate) //! * [*cancel*](api::RollingUpdateCancelCall), [*get*](api::RollingUpdateGetCall), [*insert*](api::RollingUpdateInsertCall), [*list*](api::RollingUpdateListCall), [*list instance updates*](api::RollingUpdateListInstanceUpdateCall), [*pause*](api::RollingUpdatePauseCall), [*resume*](api::RollingUpdateResumeCall) and [*rollback*](api::RollingUpdateRollbackCall) @@ -59,8 +59,8 @@ //! let r = hub.rolling_updates().rollback(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -88,12 +88,12 @@ //! use std::default::Default; //! use replicapoolupdater1_beta1::{Replicapoolupdater, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -132,10 +132,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -145,25 +145,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/reseller1_sandbox/README.md b/gen/reseller1_sandbox/README.md index 7ec1575434..e9ccb6b1ae 100644 --- a/gen/reseller1_sandbox/README.md +++ b/gen/reseller1_sandbox/README.md @@ -11,7 +11,7 @@ Everything else about the *reseller* *v1_sandbox* API can be found at the [official documentation site](https://developers.google.com/google-apps/reseller/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-reseller1_sandbox/5.0.3+20160329/google_reseller1_sandbox/Reseller) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-reseller1_sandbox/5.0.3+20160329/google_reseller1_sandbox/Reseller) ... * [customers](https://docs.rs/google-reseller1_sandbox/5.0.3+20160329/google_reseller1_sandbox/api::Customer) * [*get*](https://docs.rs/google-reseller1_sandbox/5.0.3+20160329/google_reseller1_sandbox/api::CustomerGetCall), [*insert*](https://docs.rs/google-reseller1_sandbox/5.0.3+20160329/google_reseller1_sandbox/api::CustomerInsertCall), [*patch*](https://docs.rs/google-reseller1_sandbox/5.0.3+20160329/google_reseller1_sandbox/api::CustomerPatchCall) and [*update*](https://docs.rs/google-reseller1_sandbox/5.0.3+20160329/google_reseller1_sandbox/api::CustomerUpdateCall) @@ -61,8 +61,8 @@ let r = hub.subscriptions().start_paid_service(...).doit().await let r = hub.subscriptions().suspend(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -89,12 +89,12 @@ use reseller1_sandbox::{Result, Error}; use std::default::Default; use reseller1_sandbox::{Reseller, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -135,10 +135,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-reseller1_sandbox/5.0.3+20160329/google_reseller1_sandbox/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-reseller1_sandbox/5.0.3+20160329/google_reseller1_sandbox/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -148,25 +148,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-resell You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-reseller1_sandbox/5.0.3+20160329/google_reseller1_sandbox/client::Delegate) to the -[Method Builder](https://docs.rs/google-reseller1_sandbox/5.0.3+20160329/google_reseller1_sandbox/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-reseller1_sandbox/5.0.3+20160329/google_reseller1_sandbox/client::Delegate) to the +[Method Builder](https://docs.rs/google-reseller1_sandbox/5.0.3+20160329/google_reseller1_sandbox/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-reseller1_sandbox/5.0.3+20160329/google_reseller1_sandbox/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-reseller1_sandbox/5.0.3+20160329/google_reseller1_sandbox/client::RequestValue) and -[decodable](https://docs.rs/google-reseller1_sandbox/5.0.3+20160329/google_reseller1_sandbox/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-reseller1_sandbox/5.0.3+20160329/google_reseller1_sandbox/client::RequestValue) and +[decodable](https://docs.rs/google-reseller1_sandbox/5.0.3+20160329/google_reseller1_sandbox/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-reseller1_sandbox/5.0.3+20160329/google_reseller1_sandbox/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-reseller1_sandbox/5.0.3+20160329/google_reseller1_sandbox/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -185,7 +185,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **reseller1_sandbox** library was generated by Sebastian Thiel, and is placed +The **reseller1_sandbox** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/reseller1_sandbox/src/api.rs b/gen/reseller1_sandbox/src/api.rs index b587e0f41f..0b5bea79f2 100644 --- a/gen/reseller1_sandbox/src/api.rs +++ b/gen/reseller1_sandbox/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// Manage users on your domain AppOrder, @@ -68,12 +68,12 @@ impl Default for Scope { /// use std::default::Default; /// use reseller1_sandbox::{Reseller, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/reseller1_sandbox/src/lib.rs b/gen/reseller1_sandbox/src/lib.rs index 1c17863963..232cd34416 100644 --- a/gen/reseller1_sandbox/src/lib.rs +++ b/gen/reseller1_sandbox/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/reseller1_sandbox). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Reseller) ... +//! Handle the following *Resources* with ease from the central [hub](Reseller) ... //! //! * [customers](api::Customer) //! * [*get*](api::CustomerGetCall), [*insert*](api::CustomerInsertCall), [*patch*](api::CustomerPatchCall) and [*update*](api::CustomerUpdateCall) @@ -61,8 +61,8 @@ //! let r = hub.subscriptions().suspend(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -90,12 +90,12 @@ //! use std::default::Default; //! use reseller1_sandbox::{Reseller, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -136,10 +136,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -149,25 +149,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/resourcesettings1/README.md b/gen/resourcesettings1/README.md index 2ec73bc84d..f50e14334c 100644 --- a/gen/resourcesettings1/README.md +++ b/gen/resourcesettings1/README.md @@ -11,7 +11,7 @@ Everything else about the *Resource Settings* *v1* API can be found at the [official documentation site](https://cloud.google.com/resource-manager/docs/resource-settings/overview). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-resourcesettings1/5.0.3+20230123/google_resourcesettings1/ResourceSettings) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-resourcesettings1/5.0.3+20230123/google_resourcesettings1/ResourceSettings) ... * folders * [*settings get*](https://docs.rs/google-resourcesettings1/5.0.3+20230123/google_resourcesettings1/api::FolderSettingGetCall), [*settings list*](https://docs.rs/google-resourcesettings1/5.0.3+20230123/google_resourcesettings1/api::FolderSettingListCall) and [*settings patch*](https://docs.rs/google-resourcesettings1/5.0.3+20230123/google_resourcesettings1/api::FolderSettingPatchCall) @@ -59,8 +59,8 @@ let r = hub.projects().settings_get(...).doit().await let r = hub.projects().settings_patch(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -87,12 +87,12 @@ use resourcesettings1::{Result, Error}; use std::default::Default; use resourcesettings1::{ResourceSettings, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -129,10 +129,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-resourcesettings1/5.0.3+20230123/google_resourcesettings1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-resourcesettings1/5.0.3+20230123/google_resourcesettings1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -142,25 +142,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-resour You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-resourcesettings1/5.0.3+20230123/google_resourcesettings1/client::Delegate) to the -[Method Builder](https://docs.rs/google-resourcesettings1/5.0.3+20230123/google_resourcesettings1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-resourcesettings1/5.0.3+20230123/google_resourcesettings1/client::Delegate) to the +[Method Builder](https://docs.rs/google-resourcesettings1/5.0.3+20230123/google_resourcesettings1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-resourcesettings1/5.0.3+20230123/google_resourcesettings1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-resourcesettings1/5.0.3+20230123/google_resourcesettings1/client::RequestValue) and -[decodable](https://docs.rs/google-resourcesettings1/5.0.3+20230123/google_resourcesettings1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-resourcesettings1/5.0.3+20230123/google_resourcesettings1/client::RequestValue) and +[decodable](https://docs.rs/google-resourcesettings1/5.0.3+20230123/google_resourcesettings1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-resourcesettings1/5.0.3+20230123/google_resourcesettings1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-resourcesettings1/5.0.3+20230123/google_resourcesettings1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -179,7 +179,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **resourcesettings1** library was generated by Sebastian Thiel, and is placed +The **resourcesettings1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/resourcesettings1/src/api.rs b/gen/resourcesettings1/src/api.rs index fa286012eb..5e276e98c4 100644 --- a/gen/resourcesettings1/src/api.rs +++ b/gen/resourcesettings1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use resourcesettings1::{ResourceSettings, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/resourcesettings1/src/lib.rs b/gen/resourcesettings1/src/lib.rs index a3ab583f83..bf05ad09bd 100644 --- a/gen/resourcesettings1/src/lib.rs +++ b/gen/resourcesettings1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/resourcesettings1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](ResourceSettings) ... +//! Handle the following *Resources* with ease from the central [hub](ResourceSettings) ... //! //! * folders //! * [*settings get*](api::FolderSettingGetCall), [*settings list*](api::FolderSettingListCall) and [*settings patch*](api::FolderSettingPatchCall) @@ -59,8 +59,8 @@ //! let r = hub.projects().settings_patch(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -88,12 +88,12 @@ //! use std::default::Default; //! use resourcesettings1::{ResourceSettings, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -130,10 +130,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -143,25 +143,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/resourceviews1_beta2/README.md b/gen/resourceviews1_beta2/README.md index 3d476cd90f..d734a8b599 100644 --- a/gen/resourceviews1_beta2/README.md +++ b/gen/resourceviews1_beta2/README.md @@ -11,7 +11,7 @@ Everything else about the *resourceviews* *v1_beta2* API can be found at the [official documentation site](https://developers.google.com/compute/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-resourceviews1_beta2/5.0.3+20160512/google_resourceviews1_beta2/Resourceviews) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-resourceviews1_beta2/5.0.3+20160512/google_resourceviews1_beta2/Resourceviews) ... * zone operations * [*get*](https://docs.rs/google-resourceviews1_beta2/5.0.3+20160512/google_resourceviews1_beta2/api::ZoneOperationGetCall) and [*list*](https://docs.rs/google-resourceviews1_beta2/5.0.3+20160512/google_resourceviews1_beta2/api::ZoneOperationListCall) @@ -57,8 +57,8 @@ let r = hub.zone_views().remove_resources(...).doit().await let r = hub.zone_views().set_service(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -86,12 +86,12 @@ use resourceviews1_beta2::{Result, Error}; use std::default::Default; use resourceviews1_beta2::{Resourceviews, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -132,10 +132,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-resourceviews1_beta2/5.0.3+20160512/google_resourceviews1_beta2/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-resourceviews1_beta2/5.0.3+20160512/google_resourceviews1_beta2/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -145,25 +145,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-resour You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-resourceviews1_beta2/5.0.3+20160512/google_resourceviews1_beta2/client::Delegate) to the -[Method Builder](https://docs.rs/google-resourceviews1_beta2/5.0.3+20160512/google_resourceviews1_beta2/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-resourceviews1_beta2/5.0.3+20160512/google_resourceviews1_beta2/client::Delegate) to the +[Method Builder](https://docs.rs/google-resourceviews1_beta2/5.0.3+20160512/google_resourceviews1_beta2/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-resourceviews1_beta2/5.0.3+20160512/google_resourceviews1_beta2/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-resourceviews1_beta2/5.0.3+20160512/google_resourceviews1_beta2/client::RequestValue) and -[decodable](https://docs.rs/google-resourceviews1_beta2/5.0.3+20160512/google_resourceviews1_beta2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-resourceviews1_beta2/5.0.3+20160512/google_resourceviews1_beta2/client::RequestValue) and +[decodable](https://docs.rs/google-resourceviews1_beta2/5.0.3+20160512/google_resourceviews1_beta2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-resourceviews1_beta2/5.0.3+20160512/google_resourceviews1_beta2/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-resourceviews1_beta2/5.0.3+20160512/google_resourceviews1_beta2/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -182,7 +182,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **resourceviews1_beta2** library was generated by Sebastian Thiel, and is placed +The **resourceviews1_beta2** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/resourceviews1_beta2/src/api.rs b/gen/resourceviews1_beta2/src/api.rs index d247b2b987..aa0cfadb1f 100644 --- a/gen/resourceviews1_beta2/src/api.rs +++ b/gen/resourceviews1_beta2/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your data across Google Cloud Platform services CloudPlatform, @@ -85,12 +85,12 @@ impl Default for Scope { /// use std::default::Default; /// use resourceviews1_beta2::{Resourceviews, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/resourceviews1_beta2/src/lib.rs b/gen/resourceviews1_beta2/src/lib.rs index ac4366f662..195938f99a 100644 --- a/gen/resourceviews1_beta2/src/lib.rs +++ b/gen/resourceviews1_beta2/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/resourceviews1_beta2). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Resourceviews) ... +//! Handle the following *Resources* with ease from the central [hub](Resourceviews) ... //! //! * zone operations //! * [*get*](api::ZoneOperationGetCall) and [*list*](api::ZoneOperationListCall) @@ -57,8 +57,8 @@ //! let r = hub.zone_views().set_service(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -87,12 +87,12 @@ //! use std::default::Default; //! use resourceviews1_beta2::{Resourceviews, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -133,10 +133,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -146,25 +146,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/retail2/README.md b/gen/retail2/README.md index 14f1f5ebf8..7060dd0b36 100644 --- a/gen/retail2/README.md +++ b/gen/retail2/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Retail* *v2* API can be found at the [official documentation site](https://cloud.google.com/recommendations). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/CloudRetail) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/CloudRetail) ... * projects * [*locations catalogs attributes config add catalog attribute*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogAttributesConfigAddCatalogAttributeCall), [*locations catalogs attributes config remove catalog attribute*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogAttributesConfigRemoveCatalogAttributeCall), [*locations catalogs attributes config replace catalog attribute*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogAttributesConfigReplaceCatalogAttributeCall), [*locations catalogs branches operations get*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogBranchOperationGetCall), [*locations catalogs branches products add fulfillment places*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogBranchProductAddFulfillmentPlaceCall), [*locations catalogs branches products add local inventories*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogBranchProductAddLocalInventoryCall), [*locations catalogs branches products create*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogBranchProductCreateCall), [*locations catalogs branches products delete*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogBranchProductDeleteCall), [*locations catalogs branches products get*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogBranchProductGetCall), [*locations catalogs branches products import*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogBranchProductImportCall), [*locations catalogs branches products list*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogBranchProductListCall), [*locations catalogs branches products patch*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogBranchProductPatchCall), [*locations catalogs branches products remove fulfillment places*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogBranchProductRemoveFulfillmentPlaceCall), [*locations catalogs branches products remove local inventories*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogBranchProductRemoveLocalInventoryCall), [*locations catalogs branches products set inventory*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogBranchProductSetInventoryCall), [*locations catalogs complete query*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogCompleteQueryCall), [*locations catalogs completion data import*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogCompletionDataImportCall), [*locations catalogs controls create*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogControlCreateCall), [*locations catalogs controls delete*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogControlDeleteCall), [*locations catalogs controls get*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogControlGetCall), [*locations catalogs controls list*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogControlListCall), [*locations catalogs controls patch*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogControlPatchCall), [*locations catalogs get attributes config*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogGetAttributesConfigCall), [*locations catalogs get completion config*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogGetCompletionConfigCall), [*locations catalogs get default branch*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogGetDefaultBranchCall), [*locations catalogs list*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogListCall), [*locations catalogs operations get*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogOperationGetCall), [*locations catalogs operations list*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogOperationListCall), [*locations catalogs patch*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogPatchCall), [*locations catalogs placements predict*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogPlacementPredictCall), [*locations catalogs placements search*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogPlacementSearchCall), [*locations catalogs serving configs add control*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogServingConfigAddControlCall), [*locations catalogs serving configs create*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogServingConfigCreateCall), [*locations catalogs serving configs delete*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogServingConfigDeleteCall), [*locations catalogs serving configs get*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogServingConfigGetCall), [*locations catalogs serving configs list*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogServingConfigListCall), [*locations catalogs serving configs patch*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogServingConfigPatchCall), [*locations catalogs serving configs predict*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogServingConfigPredictCall), [*locations catalogs serving configs remove control*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogServingConfigRemoveControlCall), [*locations catalogs serving configs search*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogServingConfigSearchCall), [*locations catalogs set default branch*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogSetDefaultBranchCall), [*locations catalogs update attributes config*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogUpdateAttributesConfigCall), [*locations catalogs update completion config*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogUpdateCompletionConfigCall), [*locations catalogs user events collect*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogUserEventCollectCall), [*locations catalogs user events import*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogUserEventImportCall), [*locations catalogs user events purge*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogUserEventPurgeCall), [*locations catalogs user events rejoin*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogUserEventRejoinCall), [*locations catalogs user events write*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationCatalogUserEventWriteCall), [*locations operations get*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationOperationGetCall), [*locations operations list*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectLocationOperationListCall), [*operations get*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectOperationGetCall) and [*operations list*](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/api::ProjectOperationListCall) @@ -63,8 +63,8 @@ let r = hub.projects().locations_operations_get(...).doit().await let r = hub.projects().operations_get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -92,12 +92,12 @@ use retail2::{Result, Error}; use std::default::Default; use retail2::{CloudRetail, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -138,10 +138,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -151,25 +151,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-retail You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/client::Delegate) to the -[Method Builder](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/client::Delegate) to the +[Method Builder](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/client::RequestValue) and -[decodable](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/client::RequestValue) and +[decodable](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-retail2/5.0.3+20230117/google_retail2/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -188,7 +188,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **retail2** library was generated by Sebastian Thiel, and is placed +The **retail2** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/retail2/src/api.rs b/gen/retail2/src/api.rs index ec4df37806..c7b4179ec0 100644 --- a/gen/retail2/src/api.rs +++ b/gen/retail2/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use retail2::{CloudRetail, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/retail2/src/lib.rs b/gen/retail2/src/lib.rs index 538b2888e0..a6b4596c0e 100644 --- a/gen/retail2/src/lib.rs +++ b/gen/retail2/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/retail2). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudRetail) ... +//! Handle the following *Resources* with ease from the central [hub](CloudRetail) ... //! //! * projects //! * [*locations catalogs attributes config add catalog attribute*](api::ProjectLocationCatalogAttributesConfigAddCatalogAttributeCall), [*locations catalogs attributes config remove catalog attribute*](api::ProjectLocationCatalogAttributesConfigRemoveCatalogAttributeCall), [*locations catalogs attributes config replace catalog attribute*](api::ProjectLocationCatalogAttributesConfigReplaceCatalogAttributeCall), [*locations catalogs branches operations get*](api::ProjectLocationCatalogBranchOperationGetCall), [*locations catalogs branches products add fulfillment places*](api::ProjectLocationCatalogBranchProductAddFulfillmentPlaceCall), [*locations catalogs branches products add local inventories*](api::ProjectLocationCatalogBranchProductAddLocalInventoryCall), [*locations catalogs branches products create*](api::ProjectLocationCatalogBranchProductCreateCall), [*locations catalogs branches products delete*](api::ProjectLocationCatalogBranchProductDeleteCall), [*locations catalogs branches products get*](api::ProjectLocationCatalogBranchProductGetCall), [*locations catalogs branches products import*](api::ProjectLocationCatalogBranchProductImportCall), [*locations catalogs branches products list*](api::ProjectLocationCatalogBranchProductListCall), [*locations catalogs branches products patch*](api::ProjectLocationCatalogBranchProductPatchCall), [*locations catalogs branches products remove fulfillment places*](api::ProjectLocationCatalogBranchProductRemoveFulfillmentPlaceCall), [*locations catalogs branches products remove local inventories*](api::ProjectLocationCatalogBranchProductRemoveLocalInventoryCall), [*locations catalogs branches products set inventory*](api::ProjectLocationCatalogBranchProductSetInventoryCall), [*locations catalogs complete query*](api::ProjectLocationCatalogCompleteQueryCall), [*locations catalogs completion data import*](api::ProjectLocationCatalogCompletionDataImportCall), [*locations catalogs controls create*](api::ProjectLocationCatalogControlCreateCall), [*locations catalogs controls delete*](api::ProjectLocationCatalogControlDeleteCall), [*locations catalogs controls get*](api::ProjectLocationCatalogControlGetCall), [*locations catalogs controls list*](api::ProjectLocationCatalogControlListCall), [*locations catalogs controls patch*](api::ProjectLocationCatalogControlPatchCall), [*locations catalogs get attributes config*](api::ProjectLocationCatalogGetAttributesConfigCall), [*locations catalogs get completion config*](api::ProjectLocationCatalogGetCompletionConfigCall), [*locations catalogs get default branch*](api::ProjectLocationCatalogGetDefaultBranchCall), [*locations catalogs list*](api::ProjectLocationCatalogListCall), [*locations catalogs operations get*](api::ProjectLocationCatalogOperationGetCall), [*locations catalogs operations list*](api::ProjectLocationCatalogOperationListCall), [*locations catalogs patch*](api::ProjectLocationCatalogPatchCall), [*locations catalogs placements predict*](api::ProjectLocationCatalogPlacementPredictCall), [*locations catalogs placements search*](api::ProjectLocationCatalogPlacementSearchCall), [*locations catalogs serving configs add control*](api::ProjectLocationCatalogServingConfigAddControlCall), [*locations catalogs serving configs create*](api::ProjectLocationCatalogServingConfigCreateCall), [*locations catalogs serving configs delete*](api::ProjectLocationCatalogServingConfigDeleteCall), [*locations catalogs serving configs get*](api::ProjectLocationCatalogServingConfigGetCall), [*locations catalogs serving configs list*](api::ProjectLocationCatalogServingConfigListCall), [*locations catalogs serving configs patch*](api::ProjectLocationCatalogServingConfigPatchCall), [*locations catalogs serving configs predict*](api::ProjectLocationCatalogServingConfigPredictCall), [*locations catalogs serving configs remove control*](api::ProjectLocationCatalogServingConfigRemoveControlCall), [*locations catalogs serving configs search*](api::ProjectLocationCatalogServingConfigSearchCall), [*locations catalogs set default branch*](api::ProjectLocationCatalogSetDefaultBranchCall), [*locations catalogs update attributes config*](api::ProjectLocationCatalogUpdateAttributesConfigCall), [*locations catalogs update completion config*](api::ProjectLocationCatalogUpdateCompletionConfigCall), [*locations catalogs user events collect*](api::ProjectLocationCatalogUserEventCollectCall), [*locations catalogs user events import*](api::ProjectLocationCatalogUserEventImportCall), [*locations catalogs user events purge*](api::ProjectLocationCatalogUserEventPurgeCall), [*locations catalogs user events rejoin*](api::ProjectLocationCatalogUserEventRejoinCall), [*locations catalogs user events write*](api::ProjectLocationCatalogUserEventWriteCall), [*locations operations get*](api::ProjectLocationOperationGetCall), [*locations operations list*](api::ProjectLocationOperationListCall), [*operations get*](api::ProjectOperationGetCall) and [*operations list*](api::ProjectOperationListCall) @@ -63,8 +63,8 @@ //! let r = hub.projects().operations_get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -93,12 +93,12 @@ //! use std::default::Default; //! use retail2::{CloudRetail, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -139,10 +139,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -152,25 +152,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/run1/README.md b/gen/run1/README.md index b74d7019c2..ca176203ba 100644 --- a/gen/run1/README.md +++ b/gen/run1/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Run* *v1* API can be found at the [official documentation site](https://cloud.google.com/run/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-run1/5.0.3+20230113/google_run1/CloudRun) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-run1/5.0.3+20230113/google_run1/CloudRun) ... * namespaces * [*authorizeddomains list*](https://docs.rs/google-run1/5.0.3+20230113/google_run1/api::NamespaceAuthorizeddomainListCall), [*configurations get*](https://docs.rs/google-run1/5.0.3+20230113/google_run1/api::NamespaceConfigurationGetCall), [*configurations list*](https://docs.rs/google-run1/5.0.3+20230113/google_run1/api::NamespaceConfigurationListCall), [*domainmappings create*](https://docs.rs/google-run1/5.0.3+20230113/google_run1/api::NamespaceDomainmappingCreateCall), [*domainmappings delete*](https://docs.rs/google-run1/5.0.3+20230113/google_run1/api::NamespaceDomainmappingDeleteCall), [*domainmappings get*](https://docs.rs/google-run1/5.0.3+20230113/google_run1/api::NamespaceDomainmappingGetCall), [*domainmappings list*](https://docs.rs/google-run1/5.0.3+20230113/google_run1/api::NamespaceDomainmappingListCall), [*executions cancel*](https://docs.rs/google-run1/5.0.3+20230113/google_run1/api::NamespaceExecutionCancelCall), [*executions delete*](https://docs.rs/google-run1/5.0.3+20230113/google_run1/api::NamespaceExecutionDeleteCall), [*executions get*](https://docs.rs/google-run1/5.0.3+20230113/google_run1/api::NamespaceExecutionGetCall), [*executions list*](https://docs.rs/google-run1/5.0.3+20230113/google_run1/api::NamespaceExecutionListCall), [*jobs create*](https://docs.rs/google-run1/5.0.3+20230113/google_run1/api::NamespaceJobCreateCall), [*jobs delete*](https://docs.rs/google-run1/5.0.3+20230113/google_run1/api::NamespaceJobDeleteCall), [*jobs get*](https://docs.rs/google-run1/5.0.3+20230113/google_run1/api::NamespaceJobGetCall), [*jobs list*](https://docs.rs/google-run1/5.0.3+20230113/google_run1/api::NamespaceJobListCall), [*jobs replace job*](https://docs.rs/google-run1/5.0.3+20230113/google_run1/api::NamespaceJobReplaceJobCall), [*jobs run*](https://docs.rs/google-run1/5.0.3+20230113/google_run1/api::NamespaceJobRunCall), [*revisions delete*](https://docs.rs/google-run1/5.0.3+20230113/google_run1/api::NamespaceRevisionDeleteCall), [*revisions get*](https://docs.rs/google-run1/5.0.3+20230113/google_run1/api::NamespaceRevisionGetCall), [*revisions list*](https://docs.rs/google-run1/5.0.3+20230113/google_run1/api::NamespaceRevisionListCall), [*routes get*](https://docs.rs/google-run1/5.0.3+20230113/google_run1/api::NamespaceRouteGetCall), [*routes list*](https://docs.rs/google-run1/5.0.3+20230113/google_run1/api::NamespaceRouteListCall), [*services create*](https://docs.rs/google-run1/5.0.3+20230113/google_run1/api::NamespaceServiceCreateCall), [*services delete*](https://docs.rs/google-run1/5.0.3+20230113/google_run1/api::NamespaceServiceDeleteCall), [*services get*](https://docs.rs/google-run1/5.0.3+20230113/google_run1/api::NamespaceServiceGetCall), [*services list*](https://docs.rs/google-run1/5.0.3+20230113/google_run1/api::NamespaceServiceListCall), [*services replace service*](https://docs.rs/google-run1/5.0.3+20230113/google_run1/api::NamespaceServiceReplaceServiceCall), [*tasks get*](https://docs.rs/google-run1/5.0.3+20230113/google_run1/api::NamespaceTaskGetCall) and [*tasks list*](https://docs.rs/google-run1/5.0.3+20230113/google_run1/api::NamespaceTaskListCall) @@ -59,8 +59,8 @@ let r = hub.projects().locations_revisions_delete(...).doit().await let r = hub.projects().locations_services_delete(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -87,12 +87,12 @@ use run1::{Result, Error}; use std::default::Default; use run1::{CloudRun, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -132,10 +132,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-run1/5.0.3+20230113/google_run1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-run1/5.0.3+20230113/google_run1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -145,25 +145,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-run1/5 You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-run1/5.0.3+20230113/google_run1/client::Delegate) to the -[Method Builder](https://docs.rs/google-run1/5.0.3+20230113/google_run1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-run1/5.0.3+20230113/google_run1/client::Delegate) to the +[Method Builder](https://docs.rs/google-run1/5.0.3+20230113/google_run1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-run1/5.0.3+20230113/google_run1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-run1/5.0.3+20230113/google_run1/client::RequestValue) and -[decodable](https://docs.rs/google-run1/5.0.3+20230113/google_run1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-run1/5.0.3+20230113/google_run1/client::RequestValue) and +[decodable](https://docs.rs/google-run1/5.0.3+20230113/google_run1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-run1/5.0.3+20230113/google_run1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-run1/5.0.3+20230113/google_run1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -182,7 +182,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **run1** library was generated by Sebastian Thiel, and is placed +The **run1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/run1/src/api.rs b/gen/run1/src/api.rs index 050ae15111..a6a1078c51 100644 --- a/gen/run1/src/api.rs +++ b/gen/run1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use run1::{CloudRun, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/run1/src/lib.rs b/gen/run1/src/lib.rs index 26642f78a7..b242ff200a 100644 --- a/gen/run1/src/lib.rs +++ b/gen/run1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/run1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudRun) ... +//! Handle the following *Resources* with ease from the central [hub](CloudRun) ... //! //! * namespaces //! * [*authorizeddomains list*](api::NamespaceAuthorizeddomainListCall), [*configurations get*](api::NamespaceConfigurationGetCall), [*configurations list*](api::NamespaceConfigurationListCall), [*domainmappings create*](api::NamespaceDomainmappingCreateCall), [*domainmappings delete*](api::NamespaceDomainmappingDeleteCall), [*domainmappings get*](api::NamespaceDomainmappingGetCall), [*domainmappings list*](api::NamespaceDomainmappingListCall), [*executions cancel*](api::NamespaceExecutionCancelCall), [*executions delete*](api::NamespaceExecutionDeleteCall), [*executions get*](api::NamespaceExecutionGetCall), [*executions list*](api::NamespaceExecutionListCall), [*jobs create*](api::NamespaceJobCreateCall), [*jobs delete*](api::NamespaceJobDeleteCall), [*jobs get*](api::NamespaceJobGetCall), [*jobs list*](api::NamespaceJobListCall), [*jobs replace job*](api::NamespaceJobReplaceJobCall), [*jobs run*](api::NamespaceJobRunCall), [*revisions delete*](api::NamespaceRevisionDeleteCall), [*revisions get*](api::NamespaceRevisionGetCall), [*revisions list*](api::NamespaceRevisionListCall), [*routes get*](api::NamespaceRouteGetCall), [*routes list*](api::NamespaceRouteListCall), [*services create*](api::NamespaceServiceCreateCall), [*services delete*](api::NamespaceServiceDeleteCall), [*services get*](api::NamespaceServiceGetCall), [*services list*](api::NamespaceServiceListCall), [*services replace service*](api::NamespaceServiceReplaceServiceCall), [*tasks get*](api::NamespaceTaskGetCall) and [*tasks list*](api::NamespaceTaskListCall) @@ -59,8 +59,8 @@ //! let r = hub.projects().locations_services_delete(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -88,12 +88,12 @@ //! use std::default::Default; //! use run1::{CloudRun, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -133,10 +133,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -146,25 +146,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/run2/README.md b/gen/run2/README.md index 4342dae10e..5dd4651c6e 100644 --- a/gen/run2/README.md +++ b/gen/run2/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Run* *v2* API can be found at the [official documentation site](https://cloud.google.com/run/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-run2/5.0.3+20230113/google_run2/CloudRun) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-run2/5.0.3+20230113/google_run2/CloudRun) ... * projects * [*locations jobs create*](https://docs.rs/google-run2/5.0.3+20230113/google_run2/api::ProjectLocationJobCreateCall), [*locations jobs delete*](https://docs.rs/google-run2/5.0.3+20230113/google_run2/api::ProjectLocationJobDeleteCall), [*locations jobs executions delete*](https://docs.rs/google-run2/5.0.3+20230113/google_run2/api::ProjectLocationJobExecutionDeleteCall), [*locations jobs executions get*](https://docs.rs/google-run2/5.0.3+20230113/google_run2/api::ProjectLocationJobExecutionGetCall), [*locations jobs executions list*](https://docs.rs/google-run2/5.0.3+20230113/google_run2/api::ProjectLocationJobExecutionListCall), [*locations jobs executions tasks get*](https://docs.rs/google-run2/5.0.3+20230113/google_run2/api::ProjectLocationJobExecutionTaskGetCall), [*locations jobs executions tasks list*](https://docs.rs/google-run2/5.0.3+20230113/google_run2/api::ProjectLocationJobExecutionTaskListCall), [*locations jobs get*](https://docs.rs/google-run2/5.0.3+20230113/google_run2/api::ProjectLocationJobGetCall), [*locations jobs get iam policy*](https://docs.rs/google-run2/5.0.3+20230113/google_run2/api::ProjectLocationJobGetIamPolicyCall), [*locations jobs list*](https://docs.rs/google-run2/5.0.3+20230113/google_run2/api::ProjectLocationJobListCall), [*locations jobs patch*](https://docs.rs/google-run2/5.0.3+20230113/google_run2/api::ProjectLocationJobPatchCall), [*locations jobs run*](https://docs.rs/google-run2/5.0.3+20230113/google_run2/api::ProjectLocationJobRunCall), [*locations jobs set iam policy*](https://docs.rs/google-run2/5.0.3+20230113/google_run2/api::ProjectLocationJobSetIamPolicyCall), [*locations jobs test iam permissions*](https://docs.rs/google-run2/5.0.3+20230113/google_run2/api::ProjectLocationJobTestIamPermissionCall), [*locations operations delete*](https://docs.rs/google-run2/5.0.3+20230113/google_run2/api::ProjectLocationOperationDeleteCall), [*locations operations get*](https://docs.rs/google-run2/5.0.3+20230113/google_run2/api::ProjectLocationOperationGetCall), [*locations operations list*](https://docs.rs/google-run2/5.0.3+20230113/google_run2/api::ProjectLocationOperationListCall), [*locations operations wait*](https://docs.rs/google-run2/5.0.3+20230113/google_run2/api::ProjectLocationOperationWaitCall), [*locations services create*](https://docs.rs/google-run2/5.0.3+20230113/google_run2/api::ProjectLocationServiceCreateCall), [*locations services delete*](https://docs.rs/google-run2/5.0.3+20230113/google_run2/api::ProjectLocationServiceDeleteCall), [*locations services get*](https://docs.rs/google-run2/5.0.3+20230113/google_run2/api::ProjectLocationServiceGetCall), [*locations services get iam policy*](https://docs.rs/google-run2/5.0.3+20230113/google_run2/api::ProjectLocationServiceGetIamPolicyCall), [*locations services list*](https://docs.rs/google-run2/5.0.3+20230113/google_run2/api::ProjectLocationServiceListCall), [*locations services patch*](https://docs.rs/google-run2/5.0.3+20230113/google_run2/api::ProjectLocationServicePatchCall), [*locations services revisions delete*](https://docs.rs/google-run2/5.0.3+20230113/google_run2/api::ProjectLocationServiceRevisionDeleteCall), [*locations services revisions get*](https://docs.rs/google-run2/5.0.3+20230113/google_run2/api::ProjectLocationServiceRevisionGetCall), [*locations services revisions list*](https://docs.rs/google-run2/5.0.3+20230113/google_run2/api::ProjectLocationServiceRevisionListCall), [*locations services set iam policy*](https://docs.rs/google-run2/5.0.3+20230113/google_run2/api::ProjectLocationServiceSetIamPolicyCall) and [*locations services test iam permissions*](https://docs.rs/google-run2/5.0.3+20230113/google_run2/api::ProjectLocationServiceTestIamPermissionCall) @@ -60,8 +60,8 @@ let r = hub.projects().locations_services_delete(...).doit().await let r = hub.projects().locations_services_patch(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -89,12 +89,12 @@ use run2::{Result, Error}; use std::default::Default; use run2::{CloudRun, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -137,10 +137,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-run2/5.0.3+20230113/google_run2/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-run2/5.0.3+20230113/google_run2/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -150,25 +150,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-run2/5 You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-run2/5.0.3+20230113/google_run2/client::Delegate) to the -[Method Builder](https://docs.rs/google-run2/5.0.3+20230113/google_run2/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-run2/5.0.3+20230113/google_run2/client::Delegate) to the +[Method Builder](https://docs.rs/google-run2/5.0.3+20230113/google_run2/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-run2/5.0.3+20230113/google_run2/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-run2/5.0.3+20230113/google_run2/client::RequestValue) and -[decodable](https://docs.rs/google-run2/5.0.3+20230113/google_run2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-run2/5.0.3+20230113/google_run2/client::RequestValue) and +[decodable](https://docs.rs/google-run2/5.0.3+20230113/google_run2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-run2/5.0.3+20230113/google_run2/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-run2/5.0.3+20230113/google_run2/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -187,7 +187,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **run2** library was generated by Sebastian Thiel, and is placed +The **run2** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/run2/src/api.rs b/gen/run2/src/api.rs index 62f5cfc364..de13025bd5 100644 --- a/gen/run2/src/api.rs +++ b/gen/run2/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use run2::{CloudRun, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/run2/src/lib.rs b/gen/run2/src/lib.rs index 57bc6ca78d..c7389f915d 100644 --- a/gen/run2/src/lib.rs +++ b/gen/run2/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/run2). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudRun) ... +//! Handle the following *Resources* with ease from the central [hub](CloudRun) ... //! //! * projects //! * [*locations jobs create*](api::ProjectLocationJobCreateCall), [*locations jobs delete*](api::ProjectLocationJobDeleteCall), [*locations jobs executions delete*](api::ProjectLocationJobExecutionDeleteCall), [*locations jobs executions get*](api::ProjectLocationJobExecutionGetCall), [*locations jobs executions list*](api::ProjectLocationJobExecutionListCall), [*locations jobs executions tasks get*](api::ProjectLocationJobExecutionTaskGetCall), [*locations jobs executions tasks list*](api::ProjectLocationJobExecutionTaskListCall), [*locations jobs get*](api::ProjectLocationJobGetCall), [*locations jobs get iam policy*](api::ProjectLocationJobGetIamPolicyCall), [*locations jobs list*](api::ProjectLocationJobListCall), [*locations jobs patch*](api::ProjectLocationJobPatchCall), [*locations jobs run*](api::ProjectLocationJobRunCall), [*locations jobs set iam policy*](api::ProjectLocationJobSetIamPolicyCall), [*locations jobs test iam permissions*](api::ProjectLocationJobTestIamPermissionCall), [*locations operations delete*](api::ProjectLocationOperationDeleteCall), [*locations operations get*](api::ProjectLocationOperationGetCall), [*locations operations list*](api::ProjectLocationOperationListCall), [*locations operations wait*](api::ProjectLocationOperationWaitCall), [*locations services create*](api::ProjectLocationServiceCreateCall), [*locations services delete*](api::ProjectLocationServiceDeleteCall), [*locations services get*](api::ProjectLocationServiceGetCall), [*locations services get iam policy*](api::ProjectLocationServiceGetIamPolicyCall), [*locations services list*](api::ProjectLocationServiceListCall), [*locations services patch*](api::ProjectLocationServicePatchCall), [*locations services revisions delete*](api::ProjectLocationServiceRevisionDeleteCall), [*locations services revisions get*](api::ProjectLocationServiceRevisionGetCall), [*locations services revisions list*](api::ProjectLocationServiceRevisionListCall), [*locations services set iam policy*](api::ProjectLocationServiceSetIamPolicyCall) and [*locations services test iam permissions*](api::ProjectLocationServiceTestIamPermissionCall) @@ -60,8 +60,8 @@ //! let r = hub.projects().locations_services_patch(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -90,12 +90,12 @@ //! use std::default::Default; //! use run2::{CloudRun, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -138,10 +138,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -151,25 +151,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/runtimeconfig1/README.md b/gen/runtimeconfig1/README.md index 1a63396280..6e30251fe5 100644 --- a/gen/runtimeconfig1/README.md +++ b/gen/runtimeconfig1/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud RuntimeConfig* *v1* API can be found at the [official documentation site](https://cloud.google.com/deployment-manager/runtime-configurator/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-runtimeconfig1/5.0.3+20230109/google_runtimeconfig1/CloudRuntimeConfig) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-runtimeconfig1/5.0.3+20230109/google_runtimeconfig1/CloudRuntimeConfig) ... * [operations](https://docs.rs/google-runtimeconfig1/5.0.3+20230109/google_runtimeconfig1/api::Operation) * [*cancel*](https://docs.rs/google-runtimeconfig1/5.0.3+20230109/google_runtimeconfig1/api::OperationCancelCall), [*delete*](https://docs.rs/google-runtimeconfig1/5.0.3+20230109/google_runtimeconfig1/api::OperationDeleteCall) and [*list*](https://docs.rs/google-runtimeconfig1/5.0.3+20230109/google_runtimeconfig1/api::OperationListCall) @@ -52,8 +52,8 @@ let r = hub.operations().delete(...).doit().await let r = hub.operations().list(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -80,12 +80,12 @@ use runtimeconfig1::{Result, Error}; use std::default::Default; use runtimeconfig1::{CloudRuntimeConfig, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -124,10 +124,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-runtimeconfig1/5.0.3+20230109/google_runtimeconfig1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-runtimeconfig1/5.0.3+20230109/google_runtimeconfig1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -137,25 +137,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-runtim You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-runtimeconfig1/5.0.3+20230109/google_runtimeconfig1/client::Delegate) to the -[Method Builder](https://docs.rs/google-runtimeconfig1/5.0.3+20230109/google_runtimeconfig1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-runtimeconfig1/5.0.3+20230109/google_runtimeconfig1/client::Delegate) to the +[Method Builder](https://docs.rs/google-runtimeconfig1/5.0.3+20230109/google_runtimeconfig1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-runtimeconfig1/5.0.3+20230109/google_runtimeconfig1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-runtimeconfig1/5.0.3+20230109/google_runtimeconfig1/client::RequestValue) and -[decodable](https://docs.rs/google-runtimeconfig1/5.0.3+20230109/google_runtimeconfig1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-runtimeconfig1/5.0.3+20230109/google_runtimeconfig1/client::RequestValue) and +[decodable](https://docs.rs/google-runtimeconfig1/5.0.3+20230109/google_runtimeconfig1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-runtimeconfig1/5.0.3+20230109/google_runtimeconfig1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-runtimeconfig1/5.0.3+20230109/google_runtimeconfig1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -174,7 +174,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **runtimeconfig1** library was generated by Sebastian Thiel, and is placed +The **runtimeconfig1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/runtimeconfig1/src/api.rs b/gen/runtimeconfig1/src/api.rs index dd2a5e6b23..3b75910861 100644 --- a/gen/runtimeconfig1/src/api.rs +++ b/gen/runtimeconfig1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -68,12 +68,12 @@ impl Default for Scope { /// use std::default::Default; /// use runtimeconfig1::{CloudRuntimeConfig, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/runtimeconfig1/src/lib.rs b/gen/runtimeconfig1/src/lib.rs index d3d9b82934..3dc5a8cb9d 100644 --- a/gen/runtimeconfig1/src/lib.rs +++ b/gen/runtimeconfig1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/runtimeconfig1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudRuntimeConfig) ... +//! Handle the following *Resources* with ease from the central [hub](CloudRuntimeConfig) ... //! //! * [operations](api::Operation) //! * [*cancel*](api::OperationCancelCall), [*delete*](api::OperationDeleteCall) and [*list*](api::OperationListCall) @@ -52,8 +52,8 @@ //! let r = hub.operations().list(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -81,12 +81,12 @@ //! use std::default::Default; //! use runtimeconfig1::{CloudRuntimeConfig, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -125,10 +125,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -138,25 +138,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/runtimeconfig1_beta1/README.md b/gen/runtimeconfig1_beta1/README.md index f70c65e8bf..607d3f2d8c 100644 --- a/gen/runtimeconfig1_beta1/README.md +++ b/gen/runtimeconfig1_beta1/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud RuntimeConfig* *v1_beta1* API can be found at t [official documentation site](https://cloud.google.com/deployment-manager/runtime-configurator/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-runtimeconfig1_beta1/5.0.3+20230123/google_runtimeconfig1_beta1/CloudRuntimeConfig) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-runtimeconfig1_beta1/5.0.3+20230123/google_runtimeconfig1_beta1/CloudRuntimeConfig) ... * projects * [*configs create*](https://docs.rs/google-runtimeconfig1_beta1/5.0.3+20230123/google_runtimeconfig1_beta1/api::ProjectConfigCreateCall), [*configs delete*](https://docs.rs/google-runtimeconfig1_beta1/5.0.3+20230123/google_runtimeconfig1_beta1/api::ProjectConfigDeleteCall), [*configs get*](https://docs.rs/google-runtimeconfig1_beta1/5.0.3+20230123/google_runtimeconfig1_beta1/api::ProjectConfigGetCall), [*configs get iam policy*](https://docs.rs/google-runtimeconfig1_beta1/5.0.3+20230123/google_runtimeconfig1_beta1/api::ProjectConfigGetIamPolicyCall), [*configs list*](https://docs.rs/google-runtimeconfig1_beta1/5.0.3+20230123/google_runtimeconfig1_beta1/api::ProjectConfigListCall), [*configs operations get*](https://docs.rs/google-runtimeconfig1_beta1/5.0.3+20230123/google_runtimeconfig1_beta1/api::ProjectConfigOperationGetCall), [*configs operations test iam permissions*](https://docs.rs/google-runtimeconfig1_beta1/5.0.3+20230123/google_runtimeconfig1_beta1/api::ProjectConfigOperationTestIamPermissionCall), [*configs set iam policy*](https://docs.rs/google-runtimeconfig1_beta1/5.0.3+20230123/google_runtimeconfig1_beta1/api::ProjectConfigSetIamPolicyCall), [*configs test iam permissions*](https://docs.rs/google-runtimeconfig1_beta1/5.0.3+20230123/google_runtimeconfig1_beta1/api::ProjectConfigTestIamPermissionCall), [*configs update*](https://docs.rs/google-runtimeconfig1_beta1/5.0.3+20230123/google_runtimeconfig1_beta1/api::ProjectConfigUpdateCall), [*configs variables create*](https://docs.rs/google-runtimeconfig1_beta1/5.0.3+20230123/google_runtimeconfig1_beta1/api::ProjectConfigVariableCreateCall), [*configs variables delete*](https://docs.rs/google-runtimeconfig1_beta1/5.0.3+20230123/google_runtimeconfig1_beta1/api::ProjectConfigVariableDeleteCall), [*configs variables get*](https://docs.rs/google-runtimeconfig1_beta1/5.0.3+20230123/google_runtimeconfig1_beta1/api::ProjectConfigVariableGetCall), [*configs variables list*](https://docs.rs/google-runtimeconfig1_beta1/5.0.3+20230123/google_runtimeconfig1_beta1/api::ProjectConfigVariableListCall), [*configs variables test iam permissions*](https://docs.rs/google-runtimeconfig1_beta1/5.0.3+20230123/google_runtimeconfig1_beta1/api::ProjectConfigVariableTestIamPermissionCall), [*configs variables update*](https://docs.rs/google-runtimeconfig1_beta1/5.0.3+20230123/google_runtimeconfig1_beta1/api::ProjectConfigVariableUpdateCall), [*configs variables watch*](https://docs.rs/google-runtimeconfig1_beta1/5.0.3+20230123/google_runtimeconfig1_beta1/api::ProjectConfigVariableWatchCall), [*configs waiters create*](https://docs.rs/google-runtimeconfig1_beta1/5.0.3+20230123/google_runtimeconfig1_beta1/api::ProjectConfigWaiterCreateCall), [*configs waiters delete*](https://docs.rs/google-runtimeconfig1_beta1/5.0.3+20230123/google_runtimeconfig1_beta1/api::ProjectConfigWaiterDeleteCall), [*configs waiters get*](https://docs.rs/google-runtimeconfig1_beta1/5.0.3+20230123/google_runtimeconfig1_beta1/api::ProjectConfigWaiterGetCall), [*configs waiters list*](https://docs.rs/google-runtimeconfig1_beta1/5.0.3+20230123/google_runtimeconfig1_beta1/api::ProjectConfigWaiterListCall) and [*configs waiters test iam permissions*](https://docs.rs/google-runtimeconfig1_beta1/5.0.3+20230123/google_runtimeconfig1_beta1/api::ProjectConfigWaiterTestIamPermissionCall) @@ -53,8 +53,8 @@ let r = hub.projects().configs_variables_update(...).doit().await let r = hub.projects().configs_variables_watch(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -82,12 +82,12 @@ use runtimeconfig1_beta1::{Result, Error}; use std::default::Default; use runtimeconfig1_beta1::{CloudRuntimeConfig, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -129,10 +129,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-runtimeconfig1_beta1/5.0.3+20230123/google_runtimeconfig1_beta1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-runtimeconfig1_beta1/5.0.3+20230123/google_runtimeconfig1_beta1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -142,25 +142,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-runtim You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-runtimeconfig1_beta1/5.0.3+20230123/google_runtimeconfig1_beta1/client::Delegate) to the -[Method Builder](https://docs.rs/google-runtimeconfig1_beta1/5.0.3+20230123/google_runtimeconfig1_beta1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-runtimeconfig1_beta1/5.0.3+20230123/google_runtimeconfig1_beta1/client::Delegate) to the +[Method Builder](https://docs.rs/google-runtimeconfig1_beta1/5.0.3+20230123/google_runtimeconfig1_beta1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-runtimeconfig1_beta1/5.0.3+20230123/google_runtimeconfig1_beta1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-runtimeconfig1_beta1/5.0.3+20230123/google_runtimeconfig1_beta1/client::RequestValue) and -[decodable](https://docs.rs/google-runtimeconfig1_beta1/5.0.3+20230123/google_runtimeconfig1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-runtimeconfig1_beta1/5.0.3+20230123/google_runtimeconfig1_beta1/client::RequestValue) and +[decodable](https://docs.rs/google-runtimeconfig1_beta1/5.0.3+20230123/google_runtimeconfig1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-runtimeconfig1_beta1/5.0.3+20230123/google_runtimeconfig1_beta1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-runtimeconfig1_beta1/5.0.3+20230123/google_runtimeconfig1_beta1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -179,7 +179,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **runtimeconfig1_beta1** library was generated by Sebastian Thiel, and is placed +The **runtimeconfig1_beta1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/runtimeconfig1_beta1/src/api.rs b/gen/runtimeconfig1_beta1/src/api.rs index f23b0baa8b..e1e1c3f24f 100644 --- a/gen/runtimeconfig1_beta1/src/api.rs +++ b/gen/runtimeconfig1_beta1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use runtimeconfig1_beta1::{CloudRuntimeConfig, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/runtimeconfig1_beta1/src/lib.rs b/gen/runtimeconfig1_beta1/src/lib.rs index 0f58c5efc4..6b93592f5b 100644 --- a/gen/runtimeconfig1_beta1/src/lib.rs +++ b/gen/runtimeconfig1_beta1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/runtimeconfig1_beta1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudRuntimeConfig) ... +//! Handle the following *Resources* with ease from the central [hub](CloudRuntimeConfig) ... //! //! * projects //! * [*configs create*](api::ProjectConfigCreateCall), [*configs delete*](api::ProjectConfigDeleteCall), [*configs get*](api::ProjectConfigGetCall), [*configs get iam policy*](api::ProjectConfigGetIamPolicyCall), [*configs list*](api::ProjectConfigListCall), [*configs operations get*](api::ProjectConfigOperationGetCall), [*configs operations test iam permissions*](api::ProjectConfigOperationTestIamPermissionCall), [*configs set iam policy*](api::ProjectConfigSetIamPolicyCall), [*configs test iam permissions*](api::ProjectConfigTestIamPermissionCall), [*configs update*](api::ProjectConfigUpdateCall), [*configs variables create*](api::ProjectConfigVariableCreateCall), [*configs variables delete*](api::ProjectConfigVariableDeleteCall), [*configs variables get*](api::ProjectConfigVariableGetCall), [*configs variables list*](api::ProjectConfigVariableListCall), [*configs variables test iam permissions*](api::ProjectConfigVariableTestIamPermissionCall), [*configs variables update*](api::ProjectConfigVariableUpdateCall), [*configs variables watch*](api::ProjectConfigVariableWatchCall), [*configs waiters create*](api::ProjectConfigWaiterCreateCall), [*configs waiters delete*](api::ProjectConfigWaiterDeleteCall), [*configs waiters get*](api::ProjectConfigWaiterGetCall), [*configs waiters list*](api::ProjectConfigWaiterListCall) and [*configs waiters test iam permissions*](api::ProjectConfigWaiterTestIamPermissionCall) @@ -53,8 +53,8 @@ //! let r = hub.projects().configs_variables_watch(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -83,12 +83,12 @@ //! use std::default::Default; //! use runtimeconfig1_beta1::{CloudRuntimeConfig, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -130,10 +130,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -143,25 +143,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/safebrowsing4/README.md b/gen/safebrowsing4/README.md index 52a7152c95..eb59e5771c 100644 --- a/gen/safebrowsing4/README.md +++ b/gen/safebrowsing4/README.md @@ -11,7 +11,7 @@ Everything else about the *Safebrowsing* *v4* API can be found at the [official documentation site](https://developers.google.com/safe-browsing/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-safebrowsing4/5.0.3+20230108/google_safebrowsing4/Safebrowsing) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-safebrowsing4/5.0.3+20230108/google_safebrowsing4/Safebrowsing) ... * encoded full hashes * [*get*](https://docs.rs/google-safebrowsing4/5.0.3+20230108/google_safebrowsing4/api::EncodedFullHashGetCall) @@ -63,8 +63,8 @@ let r = hub.encoded_full_hashes().get(...).doit().await let r = hub.full_hashes().find(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -91,12 +91,12 @@ use safebrowsing4::{Result, Error}; use std::default::Default; use safebrowsing4::{Safebrowsing, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -134,10 +134,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-safebrowsing4/5.0.3+20230108/google_safebrowsing4/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-safebrowsing4/5.0.3+20230108/google_safebrowsing4/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -147,25 +147,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-safebr You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-safebrowsing4/5.0.3+20230108/google_safebrowsing4/client::Delegate) to the -[Method Builder](https://docs.rs/google-safebrowsing4/5.0.3+20230108/google_safebrowsing4/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-safebrowsing4/5.0.3+20230108/google_safebrowsing4/client::Delegate) to the +[Method Builder](https://docs.rs/google-safebrowsing4/5.0.3+20230108/google_safebrowsing4/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-safebrowsing4/5.0.3+20230108/google_safebrowsing4/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-safebrowsing4/5.0.3+20230108/google_safebrowsing4/client::RequestValue) and -[decodable](https://docs.rs/google-safebrowsing4/5.0.3+20230108/google_safebrowsing4/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-safebrowsing4/5.0.3+20230108/google_safebrowsing4/client::RequestValue) and +[decodable](https://docs.rs/google-safebrowsing4/5.0.3+20230108/google_safebrowsing4/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-safebrowsing4/5.0.3+20230108/google_safebrowsing4/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-safebrowsing4/5.0.3+20230108/google_safebrowsing4/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -184,7 +184,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **safebrowsing4** library was generated by Sebastian Thiel, and is placed +The **safebrowsing4** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/safebrowsing4/src/api.rs b/gen/safebrowsing4/src/api.rs index 7f3487f182..8574c6df5b 100644 --- a/gen/safebrowsing4/src/api.rs +++ b/gen/safebrowsing4/src/api.rs @@ -42,12 +42,12 @@ use crate::{client, client::GetToken, client::serde_with}; /// use std::default::Default; /// use safebrowsing4::{Safebrowsing, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/safebrowsing4/src/lib.rs b/gen/safebrowsing4/src/lib.rs index 03f28a34ba..8487d8fcf5 100644 --- a/gen/safebrowsing4/src/lib.rs +++ b/gen/safebrowsing4/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/safebrowsing4). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Safebrowsing) ... +//! Handle the following *Resources* with ease from the central [hub](Safebrowsing) ... //! //! * encoded full hashes //! * [*get*](api::EncodedFullHashGetCall) @@ -63,8 +63,8 @@ //! let r = hub.full_hashes().find(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -92,12 +92,12 @@ //! use std::default::Default; //! use safebrowsing4::{Safebrowsing, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -135,10 +135,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -148,25 +148,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/sasportal1_alpha1/README.md b/gen/sasportal1_alpha1/README.md index 4ea4d549f6..613584e040 100644 --- a/gen/sasportal1_alpha1/README.md +++ b/gen/sasportal1_alpha1/README.md @@ -11,7 +11,7 @@ Everything else about the *sasportal* *v1_alpha1* API can be found at the [official documentation site](https://developers.google.com/spectrum-access-system/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/Sasportal) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/Sasportal) ... * customers * [*deployments create*](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/api::CustomerDeploymentCreateCall), [*deployments delete*](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/api::CustomerDeploymentDeleteCall), [*deployments devices create*](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/api::CustomerDeploymentDeviceCreateCall), [*deployments devices create signed*](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/api::CustomerDeploymentDeviceCreateSignedCall), [*deployments devices list*](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/api::CustomerDeploymentDeviceListCall), [*deployments get*](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/api::CustomerDeploymentGetCall), [*deployments list*](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/api::CustomerDeploymentListCall), [*deployments move*](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/api::CustomerDeploymentMoveCall), [*deployments patch*](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/api::CustomerDeploymentPatchCall), [*devices create*](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/api::CustomerDeviceCreateCall), [*devices create signed*](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/api::CustomerDeviceCreateSignedCall), [*devices delete*](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/api::CustomerDeviceDeleteCall), [*devices get*](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/api::CustomerDeviceGetCall), [*devices list*](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/api::CustomerDeviceListCall), [*devices move*](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/api::CustomerDeviceMoveCall), [*devices patch*](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/api::CustomerDevicePatchCall), [*devices sign device*](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/api::CustomerDeviceSignDeviceCall), [*devices update signed*](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/api::CustomerDeviceUpdateSignedCall), [*get*](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/api::CustomerGetCall), [*list*](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/api::CustomerListCall), [*nodes create*](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/api::CustomerNodeCreateCall), [*nodes delete*](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/api::CustomerNodeDeleteCall), [*nodes deployments create*](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/api::CustomerNodeDeploymentCreateCall), [*nodes deployments list*](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/api::CustomerNodeDeploymentListCall), [*nodes devices create*](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/api::CustomerNodeDeviceCreateCall), [*nodes devices create signed*](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/api::CustomerNodeDeviceCreateSignedCall), [*nodes devices list*](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/api::CustomerNodeDeviceListCall), [*nodes get*](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/api::CustomerNodeGetCall), [*nodes list*](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/api::CustomerNodeListCall), [*nodes move*](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/api::CustomerNodeMoveCall), [*nodes nodes create*](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/api::CustomerNodeNodeCreateCall), [*nodes nodes list*](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/api::CustomerNodeNodeListCall), [*nodes patch*](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/api::CustomerNodePatchCall) and [*patch*](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/api::CustomerPatchCall) @@ -78,8 +78,8 @@ let r = hub.nodes().nodes_devices_create(...).doit().await let r = hub.nodes().nodes_devices_create_signed(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -107,12 +107,12 @@ use sasportal1_alpha1::{Result, Error}; use std::default::Default; use sasportal1_alpha1::{Sasportal, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -154,10 +154,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -167,25 +167,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-saspor You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/client::Delegate) to the -[Method Builder](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/client::Delegate) to the +[Method Builder](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/client::RequestValue) and -[decodable](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/client::RequestValue) and +[decodable](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-sasportal1_alpha1/5.0.3+20230121/google_sasportal1_alpha1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -204,7 +204,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **sasportal1_alpha1** library was generated by Sebastian Thiel, and is placed +The **sasportal1_alpha1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/sasportal1_alpha1/src/api.rs b/gen/sasportal1_alpha1/src/api.rs index c25c3a5615..391e823436 100644 --- a/gen/sasportal1_alpha1/src/api.rs +++ b/gen/sasportal1_alpha1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// Read, create, update, and delete your SAS Portal data. Full, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use sasportal1_alpha1::{Sasportal, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/sasportal1_alpha1/src/lib.rs b/gen/sasportal1_alpha1/src/lib.rs index 103baf35cb..cd28c11af2 100644 --- a/gen/sasportal1_alpha1/src/lib.rs +++ b/gen/sasportal1_alpha1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/sasportal1_alpha1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Sasportal) ... +//! Handle the following *Resources* with ease from the central [hub](Sasportal) ... //! //! * customers //! * [*deployments create*](api::CustomerDeploymentCreateCall), [*deployments delete*](api::CustomerDeploymentDeleteCall), [*deployments devices create*](api::CustomerDeploymentDeviceCreateCall), [*deployments devices create signed*](api::CustomerDeploymentDeviceCreateSignedCall), [*deployments devices list*](api::CustomerDeploymentDeviceListCall), [*deployments get*](api::CustomerDeploymentGetCall), [*deployments list*](api::CustomerDeploymentListCall), [*deployments move*](api::CustomerDeploymentMoveCall), [*deployments patch*](api::CustomerDeploymentPatchCall), [*devices create*](api::CustomerDeviceCreateCall), [*devices create signed*](api::CustomerDeviceCreateSignedCall), [*devices delete*](api::CustomerDeviceDeleteCall), [*devices get*](api::CustomerDeviceGetCall), [*devices list*](api::CustomerDeviceListCall), [*devices move*](api::CustomerDeviceMoveCall), [*devices patch*](api::CustomerDevicePatchCall), [*devices sign device*](api::CustomerDeviceSignDeviceCall), [*devices update signed*](api::CustomerDeviceUpdateSignedCall), [*get*](api::CustomerGetCall), [*list*](api::CustomerListCall), [*nodes create*](api::CustomerNodeCreateCall), [*nodes delete*](api::CustomerNodeDeleteCall), [*nodes deployments create*](api::CustomerNodeDeploymentCreateCall), [*nodes deployments list*](api::CustomerNodeDeploymentListCall), [*nodes devices create*](api::CustomerNodeDeviceCreateCall), [*nodes devices create signed*](api::CustomerNodeDeviceCreateSignedCall), [*nodes devices list*](api::CustomerNodeDeviceListCall), [*nodes get*](api::CustomerNodeGetCall), [*nodes list*](api::CustomerNodeListCall), [*nodes move*](api::CustomerNodeMoveCall), [*nodes nodes create*](api::CustomerNodeNodeCreateCall), [*nodes nodes list*](api::CustomerNodeNodeListCall), [*nodes patch*](api::CustomerNodePatchCall) and [*patch*](api::CustomerPatchCall) @@ -78,8 +78,8 @@ //! let r = hub.nodes().nodes_devices_create_signed(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -108,12 +108,12 @@ //! use std::default::Default; //! use sasportal1_alpha1::{Sasportal, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -155,10 +155,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -168,25 +168,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/searchconsole1/README.md b/gen/searchconsole1/README.md index bba17676d0..114c4b04b3 100644 --- a/gen/searchconsole1/README.md +++ b/gen/searchconsole1/README.md @@ -11,7 +11,7 @@ Everything else about the *Search Console* *v1* API can be found at the [official documentation site](https://developers.google.com/webmaster-tools/search-console-api/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-searchconsole1/5.0.3+20230123/google_searchconsole1/SearchConsole) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-searchconsole1/5.0.3+20230123/google_searchconsole1/SearchConsole) ... * searchanalytics * [*query*](https://docs.rs/google-searchconsole1/5.0.3+20230123/google_searchconsole1/api::SearchanalyticQueryCall) @@ -58,8 +58,8 @@ Or specifically ... let r = hub.searchanalytics().query(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -87,12 +87,12 @@ use searchconsole1::{Result, Error}; use std::default::Default; use searchconsole1::{SearchConsole, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -133,10 +133,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-searchconsole1/5.0.3+20230123/google_searchconsole1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-searchconsole1/5.0.3+20230123/google_searchconsole1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -146,25 +146,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-search You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-searchconsole1/5.0.3+20230123/google_searchconsole1/client::Delegate) to the -[Method Builder](https://docs.rs/google-searchconsole1/5.0.3+20230123/google_searchconsole1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-searchconsole1/5.0.3+20230123/google_searchconsole1/client::Delegate) to the +[Method Builder](https://docs.rs/google-searchconsole1/5.0.3+20230123/google_searchconsole1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-searchconsole1/5.0.3+20230123/google_searchconsole1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-searchconsole1/5.0.3+20230123/google_searchconsole1/client::RequestValue) and -[decodable](https://docs.rs/google-searchconsole1/5.0.3+20230123/google_searchconsole1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-searchconsole1/5.0.3+20230123/google_searchconsole1/client::RequestValue) and +[decodable](https://docs.rs/google-searchconsole1/5.0.3+20230123/google_searchconsole1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-searchconsole1/5.0.3+20230123/google_searchconsole1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-searchconsole1/5.0.3+20230123/google_searchconsole1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -183,7 +183,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **searchconsole1** library was generated by Sebastian Thiel, and is placed +The **searchconsole1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/searchconsole1/src/api.rs b/gen/searchconsole1/src/api.rs index 7957782820..f7e3eca0e1 100644 --- a/gen/searchconsole1/src/api.rs +++ b/gen/searchconsole1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage Search Console data for your verified sites Webmaster, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use searchconsole1::{SearchConsole, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/searchconsole1/src/lib.rs b/gen/searchconsole1/src/lib.rs index c4bd8030be..ca9f4ff70a 100644 --- a/gen/searchconsole1/src/lib.rs +++ b/gen/searchconsole1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/searchconsole1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](SearchConsole) ... +//! Handle the following *Resources* with ease from the central [hub](SearchConsole) ... //! //! * searchanalytics //! * [*query*](api::SearchanalyticQueryCall) @@ -58,8 +58,8 @@ //! let r = hub.searchanalytics().query(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -88,12 +88,12 @@ //! use std::default::Default; //! use searchconsole1::{SearchConsole, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -134,10 +134,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -147,25 +147,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/secretmanager1/README.md b/gen/secretmanager1/README.md index e705542ea9..2e7e329238 100644 --- a/gen/secretmanager1/README.md +++ b/gen/secretmanager1/README.md @@ -11,7 +11,7 @@ Everything else about the *Secret Manager* *v1* API can be found at the [official documentation site](https://cloud.google.com/secret-manager/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-secretmanager1/5.0.3+20230114/google_secretmanager1/SecretManager) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-secretmanager1/5.0.3+20230114/google_secretmanager1/SecretManager) ... * projects * [*locations get*](https://docs.rs/google-secretmanager1/5.0.3+20230114/google_secretmanager1/api::ProjectLocationGetCall), [*locations list*](https://docs.rs/google-secretmanager1/5.0.3+20230114/google_secretmanager1/api::ProjectLocationListCall), [*secrets add version*](https://docs.rs/google-secretmanager1/5.0.3+20230114/google_secretmanager1/api::ProjectSecretAddVersionCall), [*secrets create*](https://docs.rs/google-secretmanager1/5.0.3+20230114/google_secretmanager1/api::ProjectSecretCreateCall), [*secrets delete*](https://docs.rs/google-secretmanager1/5.0.3+20230114/google_secretmanager1/api::ProjectSecretDeleteCall), [*secrets get*](https://docs.rs/google-secretmanager1/5.0.3+20230114/google_secretmanager1/api::ProjectSecretGetCall), [*secrets get iam policy*](https://docs.rs/google-secretmanager1/5.0.3+20230114/google_secretmanager1/api::ProjectSecretGetIamPolicyCall), [*secrets list*](https://docs.rs/google-secretmanager1/5.0.3+20230114/google_secretmanager1/api::ProjectSecretListCall), [*secrets patch*](https://docs.rs/google-secretmanager1/5.0.3+20230114/google_secretmanager1/api::ProjectSecretPatchCall), [*secrets set iam policy*](https://docs.rs/google-secretmanager1/5.0.3+20230114/google_secretmanager1/api::ProjectSecretSetIamPolicyCall), [*secrets test iam permissions*](https://docs.rs/google-secretmanager1/5.0.3+20230114/google_secretmanager1/api::ProjectSecretTestIamPermissionCall), [*secrets versions access*](https://docs.rs/google-secretmanager1/5.0.3+20230114/google_secretmanager1/api::ProjectSecretVersionAccesCall), [*secrets versions destroy*](https://docs.rs/google-secretmanager1/5.0.3+20230114/google_secretmanager1/api::ProjectSecretVersionDestroyCall), [*secrets versions disable*](https://docs.rs/google-secretmanager1/5.0.3+20230114/google_secretmanager1/api::ProjectSecretVersionDisableCall), [*secrets versions enable*](https://docs.rs/google-secretmanager1/5.0.3+20230114/google_secretmanager1/api::ProjectSecretVersionEnableCall), [*secrets versions get*](https://docs.rs/google-secretmanager1/5.0.3+20230114/google_secretmanager1/api::ProjectSecretVersionGetCall) and [*secrets versions list*](https://docs.rs/google-secretmanager1/5.0.3+20230114/google_secretmanager1/api::ProjectSecretVersionListCall) @@ -54,8 +54,8 @@ let r = hub.projects().secrets_versions_get(...).doit().await let r = hub.projects().secrets_add_version(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -83,12 +83,12 @@ use secretmanager1::{Result, Error}; use std::default::Default; use secretmanager1::{SecretManager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -129,10 +129,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-secretmanager1/5.0.3+20230114/google_secretmanager1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-secretmanager1/5.0.3+20230114/google_secretmanager1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -142,25 +142,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-secret You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-secretmanager1/5.0.3+20230114/google_secretmanager1/client::Delegate) to the -[Method Builder](https://docs.rs/google-secretmanager1/5.0.3+20230114/google_secretmanager1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-secretmanager1/5.0.3+20230114/google_secretmanager1/client::Delegate) to the +[Method Builder](https://docs.rs/google-secretmanager1/5.0.3+20230114/google_secretmanager1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-secretmanager1/5.0.3+20230114/google_secretmanager1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-secretmanager1/5.0.3+20230114/google_secretmanager1/client::RequestValue) and -[decodable](https://docs.rs/google-secretmanager1/5.0.3+20230114/google_secretmanager1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-secretmanager1/5.0.3+20230114/google_secretmanager1/client::RequestValue) and +[decodable](https://docs.rs/google-secretmanager1/5.0.3+20230114/google_secretmanager1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-secretmanager1/5.0.3+20230114/google_secretmanager1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-secretmanager1/5.0.3+20230114/google_secretmanager1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -179,7 +179,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **secretmanager1** library was generated by Sebastian Thiel, and is placed +The **secretmanager1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/secretmanager1/src/api.rs b/gen/secretmanager1/src/api.rs index 8fbbffb719..74260aa8de 100644 --- a/gen/secretmanager1/src/api.rs +++ b/gen/secretmanager1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use secretmanager1::{SecretManager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/secretmanager1/src/lib.rs b/gen/secretmanager1/src/lib.rs index e0f45f55c9..11e76c69d4 100644 --- a/gen/secretmanager1/src/lib.rs +++ b/gen/secretmanager1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/secretmanager1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](SecretManager) ... +//! Handle the following *Resources* with ease from the central [hub](SecretManager) ... //! //! * projects //! * [*locations get*](api::ProjectLocationGetCall), [*locations list*](api::ProjectLocationListCall), [*secrets add version*](api::ProjectSecretAddVersionCall), [*secrets create*](api::ProjectSecretCreateCall), [*secrets delete*](api::ProjectSecretDeleteCall), [*secrets get*](api::ProjectSecretGetCall), [*secrets get iam policy*](api::ProjectSecretGetIamPolicyCall), [*secrets list*](api::ProjectSecretListCall), [*secrets patch*](api::ProjectSecretPatchCall), [*secrets set iam policy*](api::ProjectSecretSetIamPolicyCall), [*secrets test iam permissions*](api::ProjectSecretTestIamPermissionCall), [*secrets versions access*](api::ProjectSecretVersionAccesCall), [*secrets versions destroy*](api::ProjectSecretVersionDestroyCall), [*secrets versions disable*](api::ProjectSecretVersionDisableCall), [*secrets versions enable*](api::ProjectSecretVersionEnableCall), [*secrets versions get*](api::ProjectSecretVersionGetCall) and [*secrets versions list*](api::ProjectSecretVersionListCall) @@ -54,8 +54,8 @@ //! let r = hub.projects().secrets_add_version(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -84,12 +84,12 @@ //! use std::default::Default; //! use secretmanager1::{SecretManager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -130,10 +130,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -143,25 +143,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/secretmanager1_beta1/README.md b/gen/secretmanager1_beta1/README.md index 0e9b421295..dd27036ef0 100644 --- a/gen/secretmanager1_beta1/README.md +++ b/gen/secretmanager1_beta1/README.md @@ -11,7 +11,7 @@ Everything else about the *Secret Manager* *v1_beta1* API can be found at the [official documentation site](https://cloud.google.com/secret-manager/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-secretmanager1_beta1/5.0.3+20230114/google_secretmanager1_beta1/SecretManager) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-secretmanager1_beta1/5.0.3+20230114/google_secretmanager1_beta1/SecretManager) ... * projects * [*locations get*](https://docs.rs/google-secretmanager1_beta1/5.0.3+20230114/google_secretmanager1_beta1/api::ProjectLocationGetCall), [*locations list*](https://docs.rs/google-secretmanager1_beta1/5.0.3+20230114/google_secretmanager1_beta1/api::ProjectLocationListCall), [*secrets add version*](https://docs.rs/google-secretmanager1_beta1/5.0.3+20230114/google_secretmanager1_beta1/api::ProjectSecretAddVersionCall), [*secrets create*](https://docs.rs/google-secretmanager1_beta1/5.0.3+20230114/google_secretmanager1_beta1/api::ProjectSecretCreateCall), [*secrets delete*](https://docs.rs/google-secretmanager1_beta1/5.0.3+20230114/google_secretmanager1_beta1/api::ProjectSecretDeleteCall), [*secrets get*](https://docs.rs/google-secretmanager1_beta1/5.0.3+20230114/google_secretmanager1_beta1/api::ProjectSecretGetCall), [*secrets get iam policy*](https://docs.rs/google-secretmanager1_beta1/5.0.3+20230114/google_secretmanager1_beta1/api::ProjectSecretGetIamPolicyCall), [*secrets list*](https://docs.rs/google-secretmanager1_beta1/5.0.3+20230114/google_secretmanager1_beta1/api::ProjectSecretListCall), [*secrets patch*](https://docs.rs/google-secretmanager1_beta1/5.0.3+20230114/google_secretmanager1_beta1/api::ProjectSecretPatchCall), [*secrets set iam policy*](https://docs.rs/google-secretmanager1_beta1/5.0.3+20230114/google_secretmanager1_beta1/api::ProjectSecretSetIamPolicyCall), [*secrets test iam permissions*](https://docs.rs/google-secretmanager1_beta1/5.0.3+20230114/google_secretmanager1_beta1/api::ProjectSecretTestIamPermissionCall), [*secrets versions access*](https://docs.rs/google-secretmanager1_beta1/5.0.3+20230114/google_secretmanager1_beta1/api::ProjectSecretVersionAccesCall), [*secrets versions destroy*](https://docs.rs/google-secretmanager1_beta1/5.0.3+20230114/google_secretmanager1_beta1/api::ProjectSecretVersionDestroyCall), [*secrets versions disable*](https://docs.rs/google-secretmanager1_beta1/5.0.3+20230114/google_secretmanager1_beta1/api::ProjectSecretVersionDisableCall), [*secrets versions enable*](https://docs.rs/google-secretmanager1_beta1/5.0.3+20230114/google_secretmanager1_beta1/api::ProjectSecretVersionEnableCall), [*secrets versions get*](https://docs.rs/google-secretmanager1_beta1/5.0.3+20230114/google_secretmanager1_beta1/api::ProjectSecretVersionGetCall) and [*secrets versions list*](https://docs.rs/google-secretmanager1_beta1/5.0.3+20230114/google_secretmanager1_beta1/api::ProjectSecretVersionListCall) @@ -54,8 +54,8 @@ let r = hub.projects().secrets_versions_get(...).doit().await let r = hub.projects().secrets_add_version(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -83,12 +83,12 @@ use secretmanager1_beta1::{Result, Error}; use std::default::Default; use secretmanager1_beta1::{SecretManager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -129,10 +129,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-secretmanager1_beta1/5.0.3+20230114/google_secretmanager1_beta1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-secretmanager1_beta1/5.0.3+20230114/google_secretmanager1_beta1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -142,25 +142,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-secret You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-secretmanager1_beta1/5.0.3+20230114/google_secretmanager1_beta1/client::Delegate) to the -[Method Builder](https://docs.rs/google-secretmanager1_beta1/5.0.3+20230114/google_secretmanager1_beta1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-secretmanager1_beta1/5.0.3+20230114/google_secretmanager1_beta1/client::Delegate) to the +[Method Builder](https://docs.rs/google-secretmanager1_beta1/5.0.3+20230114/google_secretmanager1_beta1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-secretmanager1_beta1/5.0.3+20230114/google_secretmanager1_beta1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-secretmanager1_beta1/5.0.3+20230114/google_secretmanager1_beta1/client::RequestValue) and -[decodable](https://docs.rs/google-secretmanager1_beta1/5.0.3+20230114/google_secretmanager1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-secretmanager1_beta1/5.0.3+20230114/google_secretmanager1_beta1/client::RequestValue) and +[decodable](https://docs.rs/google-secretmanager1_beta1/5.0.3+20230114/google_secretmanager1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-secretmanager1_beta1/5.0.3+20230114/google_secretmanager1_beta1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-secretmanager1_beta1/5.0.3+20230114/google_secretmanager1_beta1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -179,7 +179,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **secretmanager1_beta1** library was generated by Sebastian Thiel, and is placed +The **secretmanager1_beta1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/secretmanager1_beta1/src/api.rs b/gen/secretmanager1_beta1/src/api.rs index 5780da9aca..d3f2dcce05 100644 --- a/gen/secretmanager1_beta1/src/api.rs +++ b/gen/secretmanager1_beta1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use secretmanager1_beta1::{SecretManager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/secretmanager1_beta1/src/lib.rs b/gen/secretmanager1_beta1/src/lib.rs index 1e6314c81b..c497330c5a 100644 --- a/gen/secretmanager1_beta1/src/lib.rs +++ b/gen/secretmanager1_beta1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/secretmanager1_beta1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](SecretManager) ... +//! Handle the following *Resources* with ease from the central [hub](SecretManager) ... //! //! * projects //! * [*locations get*](api::ProjectLocationGetCall), [*locations list*](api::ProjectLocationListCall), [*secrets add version*](api::ProjectSecretAddVersionCall), [*secrets create*](api::ProjectSecretCreateCall), [*secrets delete*](api::ProjectSecretDeleteCall), [*secrets get*](api::ProjectSecretGetCall), [*secrets get iam policy*](api::ProjectSecretGetIamPolicyCall), [*secrets list*](api::ProjectSecretListCall), [*secrets patch*](api::ProjectSecretPatchCall), [*secrets set iam policy*](api::ProjectSecretSetIamPolicyCall), [*secrets test iam permissions*](api::ProjectSecretTestIamPermissionCall), [*secrets versions access*](api::ProjectSecretVersionAccesCall), [*secrets versions destroy*](api::ProjectSecretVersionDestroyCall), [*secrets versions disable*](api::ProjectSecretVersionDisableCall), [*secrets versions enable*](api::ProjectSecretVersionEnableCall), [*secrets versions get*](api::ProjectSecretVersionGetCall) and [*secrets versions list*](api::ProjectSecretVersionListCall) @@ -54,8 +54,8 @@ //! let r = hub.projects().secrets_add_version(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -84,12 +84,12 @@ //! use std::default::Default; //! use secretmanager1_beta1::{SecretManager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -130,10 +130,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -143,25 +143,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/securitycenter1/README.md b/gen/securitycenter1/README.md index 8a39a4cec5..f8fd77b836 100644 --- a/gen/securitycenter1/README.md +++ b/gen/securitycenter1/README.md @@ -11,7 +11,7 @@ Everything else about the *Security Command Center* *v1* API can be found at the [official documentation site](https://cloud.google.com/security-command-center). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-securitycenter1/5.0.3+20230123/google_securitycenter1/SecurityCommandCenter) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-securitycenter1/5.0.3+20230123/google_securitycenter1/SecurityCommandCenter) ... * [folders](https://docs.rs/google-securitycenter1/5.0.3+20230123/google_securitycenter1/api::Folder) * [*assets group*](https://docs.rs/google-securitycenter1/5.0.3+20230123/google_securitycenter1/api::FolderAssetGroupCall), [*assets list*](https://docs.rs/google-securitycenter1/5.0.3+20230123/google_securitycenter1/api::FolderAssetListCall), [*assets update security marks*](https://docs.rs/google-securitycenter1/5.0.3+20230123/google_securitycenter1/api::FolderAssetUpdateSecurityMarkCall), [*big query exports create*](https://docs.rs/google-securitycenter1/5.0.3+20230123/google_securitycenter1/api::FolderBigQueryExportCreateCall), [*big query exports delete*](https://docs.rs/google-securitycenter1/5.0.3+20230123/google_securitycenter1/api::FolderBigQueryExportDeleteCall), [*big query exports get*](https://docs.rs/google-securitycenter1/5.0.3+20230123/google_securitycenter1/api::FolderBigQueryExportGetCall), [*big query exports list*](https://docs.rs/google-securitycenter1/5.0.3+20230123/google_securitycenter1/api::FolderBigQueryExportListCall), [*big query exports patch*](https://docs.rs/google-securitycenter1/5.0.3+20230123/google_securitycenter1/api::FolderBigQueryExportPatchCall), [*findings bulk mute*](https://docs.rs/google-securitycenter1/5.0.3+20230123/google_securitycenter1/api::FolderFindingBulkMuteCall), [*mute configs create*](https://docs.rs/google-securitycenter1/5.0.3+20230123/google_securitycenter1/api::FolderMuteConfigCreateCall), [*mute configs delete*](https://docs.rs/google-securitycenter1/5.0.3+20230123/google_securitycenter1/api::FolderMuteConfigDeleteCall), [*mute configs get*](https://docs.rs/google-securitycenter1/5.0.3+20230123/google_securitycenter1/api::FolderMuteConfigGetCall), [*mute configs list*](https://docs.rs/google-securitycenter1/5.0.3+20230123/google_securitycenter1/api::FolderMuteConfigListCall), [*mute configs patch*](https://docs.rs/google-securitycenter1/5.0.3+20230123/google_securitycenter1/api::FolderMuteConfigPatchCall), [*notification configs create*](https://docs.rs/google-securitycenter1/5.0.3+20230123/google_securitycenter1/api::FolderNotificationConfigCreateCall), [*notification configs delete*](https://docs.rs/google-securitycenter1/5.0.3+20230123/google_securitycenter1/api::FolderNotificationConfigDeleteCall), [*notification configs get*](https://docs.rs/google-securitycenter1/5.0.3+20230123/google_securitycenter1/api::FolderNotificationConfigGetCall), [*notification configs list*](https://docs.rs/google-securitycenter1/5.0.3+20230123/google_securitycenter1/api::FolderNotificationConfigListCall), [*notification configs patch*](https://docs.rs/google-securitycenter1/5.0.3+20230123/google_securitycenter1/api::FolderNotificationConfigPatchCall), [*sources findings external systems patch*](https://docs.rs/google-securitycenter1/5.0.3+20230123/google_securitycenter1/api::FolderSourceFindingExternalSystemPatchCall), [*sources findings group*](https://docs.rs/google-securitycenter1/5.0.3+20230123/google_securitycenter1/api::FolderSourceFindingGroupCall), [*sources findings list*](https://docs.rs/google-securitycenter1/5.0.3+20230123/google_securitycenter1/api::FolderSourceFindingListCall), [*sources findings patch*](https://docs.rs/google-securitycenter1/5.0.3+20230123/google_securitycenter1/api::FolderSourceFindingPatchCall), [*sources findings set mute*](https://docs.rs/google-securitycenter1/5.0.3+20230123/google_securitycenter1/api::FolderSourceFindingSetMuteCall), [*sources findings set state*](https://docs.rs/google-securitycenter1/5.0.3+20230123/google_securitycenter1/api::FolderSourceFindingSetStateCall), [*sources findings update security marks*](https://docs.rs/google-securitycenter1/5.0.3+20230123/google_securitycenter1/api::FolderSourceFindingUpdateSecurityMarkCall) and [*sources list*](https://docs.rs/google-securitycenter1/5.0.3+20230123/google_securitycenter1/api::FolderSourceListCall) @@ -80,8 +80,8 @@ let r = hub.folders().sources_findings_update_security_marks(...).doit().await let r = hub.folders().sources_list(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -108,12 +108,12 @@ use securitycenter1::{Result, Error}; use std::default::Default; use securitycenter1::{SecurityCommandCenter, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -156,10 +156,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-securitycenter1/5.0.3+20230123/google_securitycenter1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-securitycenter1/5.0.3+20230123/google_securitycenter1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -169,25 +169,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-securi You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-securitycenter1/5.0.3+20230123/google_securitycenter1/client::Delegate) to the -[Method Builder](https://docs.rs/google-securitycenter1/5.0.3+20230123/google_securitycenter1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-securitycenter1/5.0.3+20230123/google_securitycenter1/client::Delegate) to the +[Method Builder](https://docs.rs/google-securitycenter1/5.0.3+20230123/google_securitycenter1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-securitycenter1/5.0.3+20230123/google_securitycenter1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-securitycenter1/5.0.3+20230123/google_securitycenter1/client::RequestValue) and -[decodable](https://docs.rs/google-securitycenter1/5.0.3+20230123/google_securitycenter1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-securitycenter1/5.0.3+20230123/google_securitycenter1/client::RequestValue) and +[decodable](https://docs.rs/google-securitycenter1/5.0.3+20230123/google_securitycenter1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-securitycenter1/5.0.3+20230123/google_securitycenter1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-securitycenter1/5.0.3+20230123/google_securitycenter1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -206,7 +206,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **securitycenter1** library was generated by Sebastian Thiel, and is placed +The **securitycenter1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/securitycenter1/src/api.rs b/gen/securitycenter1/src/api.rs index 619f9131f8..3ad97947d7 100644 --- a/gen/securitycenter1/src/api.rs +++ b/gen/securitycenter1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use securitycenter1::{SecurityCommandCenter, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/securitycenter1/src/lib.rs b/gen/securitycenter1/src/lib.rs index cefd43b7a0..a97477b6a4 100644 --- a/gen/securitycenter1/src/lib.rs +++ b/gen/securitycenter1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/securitycenter1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](SecurityCommandCenter) ... +//! Handle the following *Resources* with ease from the central [hub](SecurityCommandCenter) ... //! //! * [folders](api::Folder) //! * [*assets group*](api::FolderAssetGroupCall), [*assets list*](api::FolderAssetListCall), [*assets update security marks*](api::FolderAssetUpdateSecurityMarkCall), [*big query exports create*](api::FolderBigQueryExportCreateCall), [*big query exports delete*](api::FolderBigQueryExportDeleteCall), [*big query exports get*](api::FolderBigQueryExportGetCall), [*big query exports list*](api::FolderBigQueryExportListCall), [*big query exports patch*](api::FolderBigQueryExportPatchCall), [*findings bulk mute*](api::FolderFindingBulkMuteCall), [*mute configs create*](api::FolderMuteConfigCreateCall), [*mute configs delete*](api::FolderMuteConfigDeleteCall), [*mute configs get*](api::FolderMuteConfigGetCall), [*mute configs list*](api::FolderMuteConfigListCall), [*mute configs patch*](api::FolderMuteConfigPatchCall), [*notification configs create*](api::FolderNotificationConfigCreateCall), [*notification configs delete*](api::FolderNotificationConfigDeleteCall), [*notification configs get*](api::FolderNotificationConfigGetCall), [*notification configs list*](api::FolderNotificationConfigListCall), [*notification configs patch*](api::FolderNotificationConfigPatchCall), [*sources findings external systems patch*](api::FolderSourceFindingExternalSystemPatchCall), [*sources findings group*](api::FolderSourceFindingGroupCall), [*sources findings list*](api::FolderSourceFindingListCall), [*sources findings patch*](api::FolderSourceFindingPatchCall), [*sources findings set mute*](api::FolderSourceFindingSetMuteCall), [*sources findings set state*](api::FolderSourceFindingSetStateCall), [*sources findings update security marks*](api::FolderSourceFindingUpdateSecurityMarkCall) and [*sources list*](api::FolderSourceListCall) @@ -80,8 +80,8 @@ //! let r = hub.folders().sources_list(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -109,12 +109,12 @@ //! use std::default::Default; //! use securitycenter1::{SecurityCommandCenter, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -157,10 +157,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -170,25 +170,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/servicebroker1/README.md b/gen/servicebroker1/README.md index b19c94f664..f5f1090098 100644 --- a/gen/servicebroker1/README.md +++ b/gen/servicebroker1/README.md @@ -11,7 +11,7 @@ Everything else about the *Service Broker* *v1* API can be found at the [official documentation site](https://cloud.google.com/kubernetes-engine/docs/concepts/add-on/service-broker). # Features -Use the following functionality with ease from the central [hub](https://docs.rs/google-servicebroker1/5.0.3+20190624/google_servicebroker1/ServiceBroker) ... +Use the following functionality with ease from the central [hub](https://docs.rs/google-servicebroker1/5.0.3+20190624/google_servicebroker1/ServiceBroker) ... * [get iam policy](https://docs.rs/google-servicebroker1/5.0.3+20190624/google_servicebroker1/api::MethodGetIamPolicyCall) @@ -52,8 +52,8 @@ let r = hub.methods().get_iam_policy(...).doit().await let r = hub.methods().set_iam_policy(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -81,12 +81,12 @@ use servicebroker1::{Result, Error}; use std::default::Default; use servicebroker1::{ServiceBroker, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -127,10 +127,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-servicebroker1/5.0.3+20190624/google_servicebroker1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-servicebroker1/5.0.3+20190624/google_servicebroker1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -140,25 +140,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-servic You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-servicebroker1/5.0.3+20190624/google_servicebroker1/client::Delegate) to the -[Method Builder](https://docs.rs/google-servicebroker1/5.0.3+20190624/google_servicebroker1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-servicebroker1/5.0.3+20190624/google_servicebroker1/client::Delegate) to the +[Method Builder](https://docs.rs/google-servicebroker1/5.0.3+20190624/google_servicebroker1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-servicebroker1/5.0.3+20190624/google_servicebroker1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-servicebroker1/5.0.3+20190624/google_servicebroker1/client::RequestValue) and -[decodable](https://docs.rs/google-servicebroker1/5.0.3+20190624/google_servicebroker1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-servicebroker1/5.0.3+20190624/google_servicebroker1/client::RequestValue) and +[decodable](https://docs.rs/google-servicebroker1/5.0.3+20190624/google_servicebroker1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-servicebroker1/5.0.3+20190624/google_servicebroker1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-servicebroker1/5.0.3+20190624/google_servicebroker1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -177,7 +177,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **servicebroker1** library was generated by Sebastian Thiel, and is placed +The **servicebroker1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/servicebroker1/src/api.rs b/gen/servicebroker1/src/api.rs index 5e37ff4599..4452ace7fa 100644 --- a/gen/servicebroker1/src/api.rs +++ b/gen/servicebroker1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your data across Google Cloud Platform services CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use servicebroker1::{ServiceBroker, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/servicebroker1/src/lib.rs b/gen/servicebroker1/src/lib.rs index 400a8a94c5..035a44d341 100644 --- a/gen/servicebroker1/src/lib.rs +++ b/gen/servicebroker1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/servicebroker1). //! # Features //! -//! Use the following functionality with ease from the central [hub](ServiceBroker) ... +//! Use the following functionality with ease from the central [hub](ServiceBroker) ... //! //! //! * [get iam policy](api::MethodGetIamPolicyCall) @@ -52,8 +52,8 @@ //! let r = hub.methods().set_iam_policy(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -82,12 +82,12 @@ //! use std::default::Default; //! use servicebroker1::{ServiceBroker, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -128,10 +128,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -141,25 +141,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/servicecontrol1/README.md b/gen/servicecontrol1/README.md index bf538226b4..ea32d4892a 100644 --- a/gen/servicecontrol1/README.md +++ b/gen/servicecontrol1/README.md @@ -11,7 +11,7 @@ Everything else about the *Service Control* *v1* API can be found at the [official documentation site](https://cloud.google.com/service-control/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-servicecontrol1/5.0.3+20230106/google_servicecontrol1/ServiceControl) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-servicecontrol1/5.0.3+20230106/google_servicecontrol1/ServiceControl) ... * services * [*allocate quota*](https://docs.rs/google-servicecontrol1/5.0.3+20230106/google_servicecontrol1/api::ServiceAllocateQuotaCall), [*check*](https://docs.rs/google-servicecontrol1/5.0.3+20230106/google_servicecontrol1/api::ServiceCheckCall) and [*report*](https://docs.rs/google-servicecontrol1/5.0.3+20230106/google_servicecontrol1/api::ServiceReportCall) @@ -50,8 +50,8 @@ Or specifically ... let r = hub.services().check(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -79,12 +79,12 @@ use servicecontrol1::{Result, Error}; use std::default::Default; use servicecontrol1::{ServiceControl, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -125,10 +125,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-servicecontrol1/5.0.3+20230106/google_servicecontrol1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-servicecontrol1/5.0.3+20230106/google_servicecontrol1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -138,25 +138,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-servic You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-servicecontrol1/5.0.3+20230106/google_servicecontrol1/client::Delegate) to the -[Method Builder](https://docs.rs/google-servicecontrol1/5.0.3+20230106/google_servicecontrol1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-servicecontrol1/5.0.3+20230106/google_servicecontrol1/client::Delegate) to the +[Method Builder](https://docs.rs/google-servicecontrol1/5.0.3+20230106/google_servicecontrol1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-servicecontrol1/5.0.3+20230106/google_servicecontrol1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-servicecontrol1/5.0.3+20230106/google_servicecontrol1/client::RequestValue) and -[decodable](https://docs.rs/google-servicecontrol1/5.0.3+20230106/google_servicecontrol1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-servicecontrol1/5.0.3+20230106/google_servicecontrol1/client::RequestValue) and +[decodable](https://docs.rs/google-servicecontrol1/5.0.3+20230106/google_servicecontrol1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-servicecontrol1/5.0.3+20230106/google_servicecontrol1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-servicecontrol1/5.0.3+20230106/google_servicecontrol1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -175,7 +175,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **servicecontrol1** library was generated by Sebastian Thiel, and is placed +The **servicecontrol1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/servicecontrol1/src/api.rs b/gen/servicecontrol1/src/api.rs index dbc6ec1964..6c65adbc2e 100644 --- a/gen/servicecontrol1/src/api.rs +++ b/gen/servicecontrol1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use servicecontrol1::{ServiceControl, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/servicecontrol1/src/lib.rs b/gen/servicecontrol1/src/lib.rs index 60535ba77a..064540b5cc 100644 --- a/gen/servicecontrol1/src/lib.rs +++ b/gen/servicecontrol1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/servicecontrol1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](ServiceControl) ... +//! Handle the following *Resources* with ease from the central [hub](ServiceControl) ... //! //! * services //! * [*allocate quota*](api::ServiceAllocateQuotaCall), [*check*](api::ServiceCheckCall) and [*report*](api::ServiceReportCall) @@ -50,8 +50,8 @@ //! let r = hub.services().check(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -80,12 +80,12 @@ //! use std::default::Default; //! use servicecontrol1::{ServiceControl, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -126,10 +126,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -139,25 +139,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/servicecontrol2/README.md b/gen/servicecontrol2/README.md index 450609db63..03c6962406 100644 --- a/gen/servicecontrol2/README.md +++ b/gen/servicecontrol2/README.md @@ -11,7 +11,7 @@ Everything else about the *Service Control* *v2* API can be found at the [official documentation site](https://cloud.google.com/service-control/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-servicecontrol2/5.0.3+20230106/google_servicecontrol2/ServiceControl) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-servicecontrol2/5.0.3+20230106/google_servicecontrol2/ServiceControl) ... * services * [*check*](https://docs.rs/google-servicecontrol2/5.0.3+20230106/google_servicecontrol2/api::ServiceCheckCall) and [*report*](https://docs.rs/google-servicecontrol2/5.0.3+20230106/google_servicecontrol2/api::ServiceReportCall) @@ -50,8 +50,8 @@ Or specifically ... let r = hub.services().check(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -79,12 +79,12 @@ use servicecontrol2::{Result, Error}; use std::default::Default; use servicecontrol2::{ServiceControl, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -125,10 +125,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-servicecontrol2/5.0.3+20230106/google_servicecontrol2/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-servicecontrol2/5.0.3+20230106/google_servicecontrol2/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -138,25 +138,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-servic You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-servicecontrol2/5.0.3+20230106/google_servicecontrol2/client::Delegate) to the -[Method Builder](https://docs.rs/google-servicecontrol2/5.0.3+20230106/google_servicecontrol2/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-servicecontrol2/5.0.3+20230106/google_servicecontrol2/client::Delegate) to the +[Method Builder](https://docs.rs/google-servicecontrol2/5.0.3+20230106/google_servicecontrol2/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-servicecontrol2/5.0.3+20230106/google_servicecontrol2/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-servicecontrol2/5.0.3+20230106/google_servicecontrol2/client::RequestValue) and -[decodable](https://docs.rs/google-servicecontrol2/5.0.3+20230106/google_servicecontrol2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-servicecontrol2/5.0.3+20230106/google_servicecontrol2/client::RequestValue) and +[decodable](https://docs.rs/google-servicecontrol2/5.0.3+20230106/google_servicecontrol2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-servicecontrol2/5.0.3+20230106/google_servicecontrol2/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-servicecontrol2/5.0.3+20230106/google_servicecontrol2/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -175,7 +175,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **servicecontrol2** library was generated by Sebastian Thiel, and is placed +The **servicecontrol2** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/servicecontrol2/src/api.rs b/gen/servicecontrol2/src/api.rs index aecdc1d25e..0644ab799e 100644 --- a/gen/servicecontrol2/src/api.rs +++ b/gen/servicecontrol2/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use servicecontrol2::{ServiceControl, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/servicecontrol2/src/lib.rs b/gen/servicecontrol2/src/lib.rs index bbeb9dae85..39409f03fe 100644 --- a/gen/servicecontrol2/src/lib.rs +++ b/gen/servicecontrol2/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/servicecontrol2). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](ServiceControl) ... +//! Handle the following *Resources* with ease from the central [hub](ServiceControl) ... //! //! * services //! * [*check*](api::ServiceCheckCall) and [*report*](api::ServiceReportCall) @@ -50,8 +50,8 @@ //! let r = hub.services().check(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -80,12 +80,12 @@ //! use std::default::Default; //! use servicecontrol2::{ServiceControl, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -126,10 +126,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -139,25 +139,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/servicedirectory1/README.md b/gen/servicedirectory1/README.md index 5e0d1793dc..c048ee0bae 100644 --- a/gen/servicedirectory1/README.md +++ b/gen/servicedirectory1/README.md @@ -11,7 +11,7 @@ Everything else about the *Service Directory* *v1* API can be found at the [official documentation site](https://cloud.google.com/service-directory). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-servicedirectory1/5.0.3+20230105/google_servicedirectory1/ServiceDirectory) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-servicedirectory1/5.0.3+20230105/google_servicedirectory1/ServiceDirectory) ... * projects * [*locations get*](https://docs.rs/google-servicedirectory1/5.0.3+20230105/google_servicedirectory1/api::ProjectLocationGetCall), [*locations list*](https://docs.rs/google-servicedirectory1/5.0.3+20230105/google_servicedirectory1/api::ProjectLocationListCall), [*locations namespaces create*](https://docs.rs/google-servicedirectory1/5.0.3+20230105/google_servicedirectory1/api::ProjectLocationNamespaceCreateCall), [*locations namespaces delete*](https://docs.rs/google-servicedirectory1/5.0.3+20230105/google_servicedirectory1/api::ProjectLocationNamespaceDeleteCall), [*locations namespaces get*](https://docs.rs/google-servicedirectory1/5.0.3+20230105/google_servicedirectory1/api::ProjectLocationNamespaceGetCall), [*locations namespaces get iam policy*](https://docs.rs/google-servicedirectory1/5.0.3+20230105/google_servicedirectory1/api::ProjectLocationNamespaceGetIamPolicyCall), [*locations namespaces list*](https://docs.rs/google-servicedirectory1/5.0.3+20230105/google_servicedirectory1/api::ProjectLocationNamespaceListCall), [*locations namespaces patch*](https://docs.rs/google-servicedirectory1/5.0.3+20230105/google_servicedirectory1/api::ProjectLocationNamespacePatchCall), [*locations namespaces services create*](https://docs.rs/google-servicedirectory1/5.0.3+20230105/google_servicedirectory1/api::ProjectLocationNamespaceServiceCreateCall), [*locations namespaces services delete*](https://docs.rs/google-servicedirectory1/5.0.3+20230105/google_servicedirectory1/api::ProjectLocationNamespaceServiceDeleteCall), [*locations namespaces services endpoints create*](https://docs.rs/google-servicedirectory1/5.0.3+20230105/google_servicedirectory1/api::ProjectLocationNamespaceServiceEndpointCreateCall), [*locations namespaces services endpoints delete*](https://docs.rs/google-servicedirectory1/5.0.3+20230105/google_servicedirectory1/api::ProjectLocationNamespaceServiceEndpointDeleteCall), [*locations namespaces services endpoints get*](https://docs.rs/google-servicedirectory1/5.0.3+20230105/google_servicedirectory1/api::ProjectLocationNamespaceServiceEndpointGetCall), [*locations namespaces services endpoints list*](https://docs.rs/google-servicedirectory1/5.0.3+20230105/google_servicedirectory1/api::ProjectLocationNamespaceServiceEndpointListCall), [*locations namespaces services endpoints patch*](https://docs.rs/google-servicedirectory1/5.0.3+20230105/google_servicedirectory1/api::ProjectLocationNamespaceServiceEndpointPatchCall), [*locations namespaces services get*](https://docs.rs/google-servicedirectory1/5.0.3+20230105/google_servicedirectory1/api::ProjectLocationNamespaceServiceGetCall), [*locations namespaces services get iam policy*](https://docs.rs/google-servicedirectory1/5.0.3+20230105/google_servicedirectory1/api::ProjectLocationNamespaceServiceGetIamPolicyCall), [*locations namespaces services list*](https://docs.rs/google-servicedirectory1/5.0.3+20230105/google_servicedirectory1/api::ProjectLocationNamespaceServiceListCall), [*locations namespaces services patch*](https://docs.rs/google-servicedirectory1/5.0.3+20230105/google_servicedirectory1/api::ProjectLocationNamespaceServicePatchCall), [*locations namespaces services resolve*](https://docs.rs/google-servicedirectory1/5.0.3+20230105/google_servicedirectory1/api::ProjectLocationNamespaceServiceResolveCall), [*locations namespaces services set iam policy*](https://docs.rs/google-servicedirectory1/5.0.3+20230105/google_servicedirectory1/api::ProjectLocationNamespaceServiceSetIamPolicyCall), [*locations namespaces services test iam permissions*](https://docs.rs/google-servicedirectory1/5.0.3+20230105/google_servicedirectory1/api::ProjectLocationNamespaceServiceTestIamPermissionCall), [*locations namespaces set iam policy*](https://docs.rs/google-servicedirectory1/5.0.3+20230105/google_servicedirectory1/api::ProjectLocationNamespaceSetIamPolicyCall) and [*locations namespaces test iam permissions*](https://docs.rs/google-servicedirectory1/5.0.3+20230105/google_servicedirectory1/api::ProjectLocationNamespaceTestIamPermissionCall) @@ -53,8 +53,8 @@ let r = hub.projects().locations_namespaces_get_iam_policy(...).doit().await let r = hub.projects().locations_namespaces_set_iam_policy(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -82,12 +82,12 @@ use servicedirectory1::{Result, Error}; use std::default::Default; use servicedirectory1::{ServiceDirectory, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -128,10 +128,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-servicedirectory1/5.0.3+20230105/google_servicedirectory1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-servicedirectory1/5.0.3+20230105/google_servicedirectory1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -141,25 +141,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-servic You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-servicedirectory1/5.0.3+20230105/google_servicedirectory1/client::Delegate) to the -[Method Builder](https://docs.rs/google-servicedirectory1/5.0.3+20230105/google_servicedirectory1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-servicedirectory1/5.0.3+20230105/google_servicedirectory1/client::Delegate) to the +[Method Builder](https://docs.rs/google-servicedirectory1/5.0.3+20230105/google_servicedirectory1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-servicedirectory1/5.0.3+20230105/google_servicedirectory1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-servicedirectory1/5.0.3+20230105/google_servicedirectory1/client::RequestValue) and -[decodable](https://docs.rs/google-servicedirectory1/5.0.3+20230105/google_servicedirectory1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-servicedirectory1/5.0.3+20230105/google_servicedirectory1/client::RequestValue) and +[decodable](https://docs.rs/google-servicedirectory1/5.0.3+20230105/google_servicedirectory1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-servicedirectory1/5.0.3+20230105/google_servicedirectory1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-servicedirectory1/5.0.3+20230105/google_servicedirectory1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -178,7 +178,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **servicedirectory1** library was generated by Sebastian Thiel, and is placed +The **servicedirectory1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/servicedirectory1/src/api.rs b/gen/servicedirectory1/src/api.rs index 6ea84facdb..e5ff7e5d6d 100644 --- a/gen/servicedirectory1/src/api.rs +++ b/gen/servicedirectory1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use servicedirectory1::{ServiceDirectory, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/servicedirectory1/src/lib.rs b/gen/servicedirectory1/src/lib.rs index 0d64156174..1760abb98e 100644 --- a/gen/servicedirectory1/src/lib.rs +++ b/gen/servicedirectory1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/servicedirectory1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](ServiceDirectory) ... +//! Handle the following *Resources* with ease from the central [hub](ServiceDirectory) ... //! //! * projects //! * [*locations get*](api::ProjectLocationGetCall), [*locations list*](api::ProjectLocationListCall), [*locations namespaces create*](api::ProjectLocationNamespaceCreateCall), [*locations namespaces delete*](api::ProjectLocationNamespaceDeleteCall), [*locations namespaces get*](api::ProjectLocationNamespaceGetCall), [*locations namespaces get iam policy*](api::ProjectLocationNamespaceGetIamPolicyCall), [*locations namespaces list*](api::ProjectLocationNamespaceListCall), [*locations namespaces patch*](api::ProjectLocationNamespacePatchCall), [*locations namespaces services create*](api::ProjectLocationNamespaceServiceCreateCall), [*locations namespaces services delete*](api::ProjectLocationNamespaceServiceDeleteCall), [*locations namespaces services endpoints create*](api::ProjectLocationNamespaceServiceEndpointCreateCall), [*locations namespaces services endpoints delete*](api::ProjectLocationNamespaceServiceEndpointDeleteCall), [*locations namespaces services endpoints get*](api::ProjectLocationNamespaceServiceEndpointGetCall), [*locations namespaces services endpoints list*](api::ProjectLocationNamespaceServiceEndpointListCall), [*locations namespaces services endpoints patch*](api::ProjectLocationNamespaceServiceEndpointPatchCall), [*locations namespaces services get*](api::ProjectLocationNamespaceServiceGetCall), [*locations namespaces services get iam policy*](api::ProjectLocationNamespaceServiceGetIamPolicyCall), [*locations namespaces services list*](api::ProjectLocationNamespaceServiceListCall), [*locations namespaces services patch*](api::ProjectLocationNamespaceServicePatchCall), [*locations namespaces services resolve*](api::ProjectLocationNamespaceServiceResolveCall), [*locations namespaces services set iam policy*](api::ProjectLocationNamespaceServiceSetIamPolicyCall), [*locations namespaces services test iam permissions*](api::ProjectLocationNamespaceServiceTestIamPermissionCall), [*locations namespaces set iam policy*](api::ProjectLocationNamespaceSetIamPolicyCall) and [*locations namespaces test iam permissions*](api::ProjectLocationNamespaceTestIamPermissionCall) @@ -53,8 +53,8 @@ //! let r = hub.projects().locations_namespaces_set_iam_policy(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -83,12 +83,12 @@ //! use std::default::Default; //! use servicedirectory1::{ServiceDirectory, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -129,10 +129,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -142,25 +142,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/servicedirectory1_beta1/README.md b/gen/servicedirectory1_beta1/README.md index 9f64e103e2..b308a4642c 100644 --- a/gen/servicedirectory1_beta1/README.md +++ b/gen/servicedirectory1_beta1/README.md @@ -11,7 +11,7 @@ Everything else about the *Service Directory* *v1_beta1* API can be found at the [official documentation site](https://cloud.google.com/service-directory). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-servicedirectory1_beta1/5.0.3+20230105/google_servicedirectory1_beta1/ServiceDirectory) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-servicedirectory1_beta1/5.0.3+20230105/google_servicedirectory1_beta1/ServiceDirectory) ... * projects * [*locations get*](https://docs.rs/google-servicedirectory1_beta1/5.0.3+20230105/google_servicedirectory1_beta1/api::ProjectLocationGetCall), [*locations list*](https://docs.rs/google-servicedirectory1_beta1/5.0.3+20230105/google_servicedirectory1_beta1/api::ProjectLocationListCall), [*locations namespaces create*](https://docs.rs/google-servicedirectory1_beta1/5.0.3+20230105/google_servicedirectory1_beta1/api::ProjectLocationNamespaceCreateCall), [*locations namespaces delete*](https://docs.rs/google-servicedirectory1_beta1/5.0.3+20230105/google_servicedirectory1_beta1/api::ProjectLocationNamespaceDeleteCall), [*locations namespaces get*](https://docs.rs/google-servicedirectory1_beta1/5.0.3+20230105/google_servicedirectory1_beta1/api::ProjectLocationNamespaceGetCall), [*locations namespaces get iam policy*](https://docs.rs/google-servicedirectory1_beta1/5.0.3+20230105/google_servicedirectory1_beta1/api::ProjectLocationNamespaceGetIamPolicyCall), [*locations namespaces list*](https://docs.rs/google-servicedirectory1_beta1/5.0.3+20230105/google_servicedirectory1_beta1/api::ProjectLocationNamespaceListCall), [*locations namespaces patch*](https://docs.rs/google-servicedirectory1_beta1/5.0.3+20230105/google_servicedirectory1_beta1/api::ProjectLocationNamespacePatchCall), [*locations namespaces service workloads get iam policy*](https://docs.rs/google-servicedirectory1_beta1/5.0.3+20230105/google_servicedirectory1_beta1/api::ProjectLocationNamespaceServiceWorkloadGetIamPolicyCall), [*locations namespaces service workloads set iam policy*](https://docs.rs/google-servicedirectory1_beta1/5.0.3+20230105/google_servicedirectory1_beta1/api::ProjectLocationNamespaceServiceWorkloadSetIamPolicyCall), [*locations namespaces service workloads test iam permissions*](https://docs.rs/google-servicedirectory1_beta1/5.0.3+20230105/google_servicedirectory1_beta1/api::ProjectLocationNamespaceServiceWorkloadTestIamPermissionCall), [*locations namespaces services create*](https://docs.rs/google-servicedirectory1_beta1/5.0.3+20230105/google_servicedirectory1_beta1/api::ProjectLocationNamespaceServiceCreateCall), [*locations namespaces services delete*](https://docs.rs/google-servicedirectory1_beta1/5.0.3+20230105/google_servicedirectory1_beta1/api::ProjectLocationNamespaceServiceDeleteCall), [*locations namespaces services endpoints create*](https://docs.rs/google-servicedirectory1_beta1/5.0.3+20230105/google_servicedirectory1_beta1/api::ProjectLocationNamespaceServiceEndpointCreateCall), [*locations namespaces services endpoints delete*](https://docs.rs/google-servicedirectory1_beta1/5.0.3+20230105/google_servicedirectory1_beta1/api::ProjectLocationNamespaceServiceEndpointDeleteCall), [*locations namespaces services endpoints get*](https://docs.rs/google-servicedirectory1_beta1/5.0.3+20230105/google_servicedirectory1_beta1/api::ProjectLocationNamespaceServiceEndpointGetCall), [*locations namespaces services endpoints list*](https://docs.rs/google-servicedirectory1_beta1/5.0.3+20230105/google_servicedirectory1_beta1/api::ProjectLocationNamespaceServiceEndpointListCall), [*locations namespaces services endpoints patch*](https://docs.rs/google-servicedirectory1_beta1/5.0.3+20230105/google_servicedirectory1_beta1/api::ProjectLocationNamespaceServiceEndpointPatchCall), [*locations namespaces services get*](https://docs.rs/google-servicedirectory1_beta1/5.0.3+20230105/google_servicedirectory1_beta1/api::ProjectLocationNamespaceServiceGetCall), [*locations namespaces services get iam policy*](https://docs.rs/google-servicedirectory1_beta1/5.0.3+20230105/google_servicedirectory1_beta1/api::ProjectLocationNamespaceServiceGetIamPolicyCall), [*locations namespaces services list*](https://docs.rs/google-servicedirectory1_beta1/5.0.3+20230105/google_servicedirectory1_beta1/api::ProjectLocationNamespaceServiceListCall), [*locations namespaces services patch*](https://docs.rs/google-servicedirectory1_beta1/5.0.3+20230105/google_servicedirectory1_beta1/api::ProjectLocationNamespaceServicePatchCall), [*locations namespaces services resolve*](https://docs.rs/google-servicedirectory1_beta1/5.0.3+20230105/google_servicedirectory1_beta1/api::ProjectLocationNamespaceServiceResolveCall), [*locations namespaces services set iam policy*](https://docs.rs/google-servicedirectory1_beta1/5.0.3+20230105/google_servicedirectory1_beta1/api::ProjectLocationNamespaceServiceSetIamPolicyCall), [*locations namespaces services test iam permissions*](https://docs.rs/google-servicedirectory1_beta1/5.0.3+20230105/google_servicedirectory1_beta1/api::ProjectLocationNamespaceServiceTestIamPermissionCall), [*locations namespaces set iam policy*](https://docs.rs/google-servicedirectory1_beta1/5.0.3+20230105/google_servicedirectory1_beta1/api::ProjectLocationNamespaceSetIamPolicyCall), [*locations namespaces test iam permissions*](https://docs.rs/google-servicedirectory1_beta1/5.0.3+20230105/google_servicedirectory1_beta1/api::ProjectLocationNamespaceTestIamPermissionCall), [*locations registration policies get iam policy*](https://docs.rs/google-servicedirectory1_beta1/5.0.3+20230105/google_servicedirectory1_beta1/api::ProjectLocationRegistrationPolicyGetIamPolicyCall), [*locations registration policies set iam policy*](https://docs.rs/google-servicedirectory1_beta1/5.0.3+20230105/google_servicedirectory1_beta1/api::ProjectLocationRegistrationPolicySetIamPolicyCall) and [*locations registration policies test iam permissions*](https://docs.rs/google-servicedirectory1_beta1/5.0.3+20230105/google_servicedirectory1_beta1/api::ProjectLocationRegistrationPolicyTestIamPermissionCall) @@ -57,8 +57,8 @@ let r = hub.projects().locations_registration_policies_get_iam_policy(...).doit( let r = hub.projects().locations_registration_policies_set_iam_policy(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -86,12 +86,12 @@ use servicedirectory1_beta1::{Result, Error}; use std::default::Default; use servicedirectory1_beta1::{ServiceDirectory, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -132,10 +132,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-servicedirectory1_beta1/5.0.3+20230105/google_servicedirectory1_beta1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-servicedirectory1_beta1/5.0.3+20230105/google_servicedirectory1_beta1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -145,25 +145,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-servic You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-servicedirectory1_beta1/5.0.3+20230105/google_servicedirectory1_beta1/client::Delegate) to the -[Method Builder](https://docs.rs/google-servicedirectory1_beta1/5.0.3+20230105/google_servicedirectory1_beta1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-servicedirectory1_beta1/5.0.3+20230105/google_servicedirectory1_beta1/client::Delegate) to the +[Method Builder](https://docs.rs/google-servicedirectory1_beta1/5.0.3+20230105/google_servicedirectory1_beta1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-servicedirectory1_beta1/5.0.3+20230105/google_servicedirectory1_beta1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-servicedirectory1_beta1/5.0.3+20230105/google_servicedirectory1_beta1/client::RequestValue) and -[decodable](https://docs.rs/google-servicedirectory1_beta1/5.0.3+20230105/google_servicedirectory1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-servicedirectory1_beta1/5.0.3+20230105/google_servicedirectory1_beta1/client::RequestValue) and +[decodable](https://docs.rs/google-servicedirectory1_beta1/5.0.3+20230105/google_servicedirectory1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-servicedirectory1_beta1/5.0.3+20230105/google_servicedirectory1_beta1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-servicedirectory1_beta1/5.0.3+20230105/google_servicedirectory1_beta1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -182,7 +182,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **servicedirectory1_beta1** library was generated by Sebastian Thiel, and is placed +The **servicedirectory1_beta1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/servicedirectory1_beta1/src/api.rs b/gen/servicedirectory1_beta1/src/api.rs index 69bac98308..8f06aaeeb1 100644 --- a/gen/servicedirectory1_beta1/src/api.rs +++ b/gen/servicedirectory1_beta1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use servicedirectory1_beta1::{ServiceDirectory, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/servicedirectory1_beta1/src/lib.rs b/gen/servicedirectory1_beta1/src/lib.rs index 136a93b19e..9257ccb2ec 100644 --- a/gen/servicedirectory1_beta1/src/lib.rs +++ b/gen/servicedirectory1_beta1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/servicedirectory1_beta1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](ServiceDirectory) ... +//! Handle the following *Resources* with ease from the central [hub](ServiceDirectory) ... //! //! * projects //! * [*locations get*](api::ProjectLocationGetCall), [*locations list*](api::ProjectLocationListCall), [*locations namespaces create*](api::ProjectLocationNamespaceCreateCall), [*locations namespaces delete*](api::ProjectLocationNamespaceDeleteCall), [*locations namespaces get*](api::ProjectLocationNamespaceGetCall), [*locations namespaces get iam policy*](api::ProjectLocationNamespaceGetIamPolicyCall), [*locations namespaces list*](api::ProjectLocationNamespaceListCall), [*locations namespaces patch*](api::ProjectLocationNamespacePatchCall), [*locations namespaces service workloads get iam policy*](api::ProjectLocationNamespaceServiceWorkloadGetIamPolicyCall), [*locations namespaces service workloads set iam policy*](api::ProjectLocationNamespaceServiceWorkloadSetIamPolicyCall), [*locations namespaces service workloads test iam permissions*](api::ProjectLocationNamespaceServiceWorkloadTestIamPermissionCall), [*locations namespaces services create*](api::ProjectLocationNamespaceServiceCreateCall), [*locations namespaces services delete*](api::ProjectLocationNamespaceServiceDeleteCall), [*locations namespaces services endpoints create*](api::ProjectLocationNamespaceServiceEndpointCreateCall), [*locations namespaces services endpoints delete*](api::ProjectLocationNamespaceServiceEndpointDeleteCall), [*locations namespaces services endpoints get*](api::ProjectLocationNamespaceServiceEndpointGetCall), [*locations namespaces services endpoints list*](api::ProjectLocationNamespaceServiceEndpointListCall), [*locations namespaces services endpoints patch*](api::ProjectLocationNamespaceServiceEndpointPatchCall), [*locations namespaces services get*](api::ProjectLocationNamespaceServiceGetCall), [*locations namespaces services get iam policy*](api::ProjectLocationNamespaceServiceGetIamPolicyCall), [*locations namespaces services list*](api::ProjectLocationNamespaceServiceListCall), [*locations namespaces services patch*](api::ProjectLocationNamespaceServicePatchCall), [*locations namespaces services resolve*](api::ProjectLocationNamespaceServiceResolveCall), [*locations namespaces services set iam policy*](api::ProjectLocationNamespaceServiceSetIamPolicyCall), [*locations namespaces services test iam permissions*](api::ProjectLocationNamespaceServiceTestIamPermissionCall), [*locations namespaces set iam policy*](api::ProjectLocationNamespaceSetIamPolicyCall), [*locations namespaces test iam permissions*](api::ProjectLocationNamespaceTestIamPermissionCall), [*locations registration policies get iam policy*](api::ProjectLocationRegistrationPolicyGetIamPolicyCall), [*locations registration policies set iam policy*](api::ProjectLocationRegistrationPolicySetIamPolicyCall) and [*locations registration policies test iam permissions*](api::ProjectLocationRegistrationPolicyTestIamPermissionCall) @@ -57,8 +57,8 @@ //! let r = hub.projects().locations_registration_policies_set_iam_policy(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -87,12 +87,12 @@ //! use std::default::Default; //! use servicedirectory1_beta1::{ServiceDirectory, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -133,10 +133,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -146,25 +146,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/serviceregistryalpha/README.md b/gen/serviceregistryalpha/README.md index 60265e31aa..5bbd8cf4e6 100644 --- a/gen/serviceregistryalpha/README.md +++ b/gen/serviceregistryalpha/README.md @@ -11,7 +11,7 @@ Everything else about the *Service Registry* *alpha* API can be found at the [official documentation site](https://developers.google.com/cloud-serviceregistry/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-serviceregistryalpha/5.0.3+20160401/google_serviceregistryalpha/ServiceRegistry) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-serviceregistryalpha/5.0.3+20160401/google_serviceregistryalpha/ServiceRegistry) ... * [endpoints](https://docs.rs/google-serviceregistryalpha/5.0.3+20160401/google_serviceregistryalpha/api::Endpoint) * [*delete*](https://docs.rs/google-serviceregistryalpha/5.0.3+20160401/google_serviceregistryalpha/api::EndpointDeleteCall), [*get*](https://docs.rs/google-serviceregistryalpha/5.0.3+20160401/google_serviceregistryalpha/api::EndpointGetCall), [*insert*](https://docs.rs/google-serviceregistryalpha/5.0.3+20160401/google_serviceregistryalpha/api::EndpointInsertCall), [*list*](https://docs.rs/google-serviceregistryalpha/5.0.3+20160401/google_serviceregistryalpha/api::EndpointListCall), [*patch*](https://docs.rs/google-serviceregistryalpha/5.0.3+20160401/google_serviceregistryalpha/api::EndpointPatchCall) and [*update*](https://docs.rs/google-serviceregistryalpha/5.0.3+20160401/google_serviceregistryalpha/api::EndpointUpdateCall) @@ -57,8 +57,8 @@ let r = hub.operations().get(...).doit().await let r = hub.operations().list(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -85,12 +85,12 @@ use serviceregistryalpha::{Result, Error}; use std::default::Default; use serviceregistryalpha::{ServiceRegistry, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -130,10 +130,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-serviceregistryalpha/5.0.3+20160401/google_serviceregistryalpha/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-serviceregistryalpha/5.0.3+20160401/google_serviceregistryalpha/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -143,25 +143,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-servic You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-serviceregistryalpha/5.0.3+20160401/google_serviceregistryalpha/client::Delegate) to the -[Method Builder](https://docs.rs/google-serviceregistryalpha/5.0.3+20160401/google_serviceregistryalpha/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-serviceregistryalpha/5.0.3+20160401/google_serviceregistryalpha/client::Delegate) to the +[Method Builder](https://docs.rs/google-serviceregistryalpha/5.0.3+20160401/google_serviceregistryalpha/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-serviceregistryalpha/5.0.3+20160401/google_serviceregistryalpha/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-serviceregistryalpha/5.0.3+20160401/google_serviceregistryalpha/client::RequestValue) and -[decodable](https://docs.rs/google-serviceregistryalpha/5.0.3+20160401/google_serviceregistryalpha/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-serviceregistryalpha/5.0.3+20160401/google_serviceregistryalpha/client::RequestValue) and +[decodable](https://docs.rs/google-serviceregistryalpha/5.0.3+20160401/google_serviceregistryalpha/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-serviceregistryalpha/5.0.3+20160401/google_serviceregistryalpha/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-serviceregistryalpha/5.0.3+20160401/google_serviceregistryalpha/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -180,7 +180,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **serviceregistryalpha** library was generated by Sebastian Thiel, and is placed +The **serviceregistryalpha** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/serviceregistryalpha/src/api.rs b/gen/serviceregistryalpha/src/api.rs index fbdf85532d..4d223ad11a 100644 --- a/gen/serviceregistryalpha/src/api.rs +++ b/gen/serviceregistryalpha/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your data across Google Cloud Platform services CloudPlatform, @@ -76,12 +76,12 @@ impl Default for Scope { /// use std::default::Default; /// use serviceregistryalpha::{ServiceRegistry, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/serviceregistryalpha/src/lib.rs b/gen/serviceregistryalpha/src/lib.rs index 6661458b4d..0f21a87624 100644 --- a/gen/serviceregistryalpha/src/lib.rs +++ b/gen/serviceregistryalpha/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/serviceregistryalpha). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](ServiceRegistry) ... +//! Handle the following *Resources* with ease from the central [hub](ServiceRegistry) ... //! //! * [endpoints](api::Endpoint) //! * [*delete*](api::EndpointDeleteCall), [*get*](api::EndpointGetCall), [*insert*](api::EndpointInsertCall), [*list*](api::EndpointListCall), [*patch*](api::EndpointPatchCall) and [*update*](api::EndpointUpdateCall) @@ -57,8 +57,8 @@ //! let r = hub.operations().list(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -86,12 +86,12 @@ //! use std::default::Default; //! use serviceregistryalpha::{ServiceRegistry, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -131,10 +131,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -144,25 +144,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/sheets4/README.md b/gen/sheets4/README.md index 0af11f303a..d264f523a2 100644 --- a/gen/sheets4/README.md +++ b/gen/sheets4/README.md @@ -11,7 +11,7 @@ Everything else about the *Sheets* *v4* API can be found at the [official documentation site](https://developers.google.com/sheets/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-sheets4/5.0.3+20230119/google_sheets4/Sheets) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-sheets4/5.0.3+20230119/google_sheets4/Sheets) ... * [spreadsheets](https://docs.rs/google-sheets4/5.0.3+20230119/google_sheets4/api::Spreadsheet) * [*batch update*](https://docs.rs/google-sheets4/5.0.3+20230119/google_sheets4/api::SpreadsheetBatchUpdateCall), [*create*](https://docs.rs/google-sheets4/5.0.3+20230119/google_sheets4/api::SpreadsheetCreateCall), [*developer metadata get*](https://docs.rs/google-sheets4/5.0.3+20230119/google_sheets4/api::SpreadsheetDeveloperMetadataGetCall), [*developer metadata search*](https://docs.rs/google-sheets4/5.0.3+20230119/google_sheets4/api::SpreadsheetDeveloperMetadataSearchCall), [*get*](https://docs.rs/google-sheets4/5.0.3+20230119/google_sheets4/api::SpreadsheetGetCall), [*get by data filter*](https://docs.rs/google-sheets4/5.0.3+20230119/google_sheets4/api::SpreadsheetGetByDataFilterCall), [*sheets copy to*](https://docs.rs/google-sheets4/5.0.3+20230119/google_sheets4/api::SpreadsheetSheetCopyToCall), [*values append*](https://docs.rs/google-sheets4/5.0.3+20230119/google_sheets4/api::SpreadsheetValueAppendCall), [*values batch clear*](https://docs.rs/google-sheets4/5.0.3+20230119/google_sheets4/api::SpreadsheetValueBatchClearCall), [*values batch clear by data filter*](https://docs.rs/google-sheets4/5.0.3+20230119/google_sheets4/api::SpreadsheetValueBatchClearByDataFilterCall), [*values batch get*](https://docs.rs/google-sheets4/5.0.3+20230119/google_sheets4/api::SpreadsheetValueBatchGetCall), [*values batch get by data filter*](https://docs.rs/google-sheets4/5.0.3+20230119/google_sheets4/api::SpreadsheetValueBatchGetByDataFilterCall), [*values batch update*](https://docs.rs/google-sheets4/5.0.3+20230119/google_sheets4/api::SpreadsheetValueBatchUpdateCall), [*values batch update by data filter*](https://docs.rs/google-sheets4/5.0.3+20230119/google_sheets4/api::SpreadsheetValueBatchUpdateByDataFilterCall), [*values clear*](https://docs.rs/google-sheets4/5.0.3+20230119/google_sheets4/api::SpreadsheetValueClearCall), [*values get*](https://docs.rs/google-sheets4/5.0.3+20230119/google_sheets4/api::SpreadsheetValueGetCall) and [*values update*](https://docs.rs/google-sheets4/5.0.3+20230119/google_sheets4/api::SpreadsheetValueUpdateCall) @@ -66,8 +66,8 @@ let r = hub.spreadsheets().get(...).doit().await let r = hub.spreadsheets().get_by_data_filter(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -95,12 +95,12 @@ use sheets4::{Result, Error}; use std::default::Default; use sheets4::{Sheets, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -146,10 +146,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-sheets4/5.0.3+20230119/google_sheets4/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-sheets4/5.0.3+20230119/google_sheets4/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -159,25 +159,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-sheets You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-sheets4/5.0.3+20230119/google_sheets4/client::Delegate) to the -[Method Builder](https://docs.rs/google-sheets4/5.0.3+20230119/google_sheets4/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-sheets4/5.0.3+20230119/google_sheets4/client::Delegate) to the +[Method Builder](https://docs.rs/google-sheets4/5.0.3+20230119/google_sheets4/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-sheets4/5.0.3+20230119/google_sheets4/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-sheets4/5.0.3+20230119/google_sheets4/client::RequestValue) and -[decodable](https://docs.rs/google-sheets4/5.0.3+20230119/google_sheets4/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-sheets4/5.0.3+20230119/google_sheets4/client::RequestValue) and +[decodable](https://docs.rs/google-sheets4/5.0.3+20230119/google_sheets4/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-sheets4/5.0.3+20230119/google_sheets4/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-sheets4/5.0.3+20230119/google_sheets4/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -196,7 +196,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **sheets4** library was generated by Sebastian Thiel, and is placed +The **sheets4** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/sheets4/src/api.rs b/gen/sheets4/src/api.rs index ccc6614bba..60754e72cf 100644 --- a/gen/sheets4/src/api.rs +++ b/gen/sheets4/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, create, and delete all of your Google Drive files Drive, @@ -81,12 +81,12 @@ impl Default for Scope { /// use std::default::Default; /// use sheets4::{Sheets, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/sheets4/src/lib.rs b/gen/sheets4/src/lib.rs index 85d1b4e4d5..cdcb706e73 100644 --- a/gen/sheets4/src/lib.rs +++ b/gen/sheets4/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/sheets4). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Sheets) ... +//! Handle the following *Resources* with ease from the central [hub](Sheets) ... //! //! * [spreadsheets](api::Spreadsheet) //! * [*batch update*](api::SpreadsheetBatchUpdateCall), [*create*](api::SpreadsheetCreateCall), [*developer metadata get*](api::SpreadsheetDeveloperMetadataGetCall), [*developer metadata search*](api::SpreadsheetDeveloperMetadataSearchCall), [*get*](api::SpreadsheetGetCall), [*get by data filter*](api::SpreadsheetGetByDataFilterCall), [*sheets copy to*](api::SpreadsheetSheetCopyToCall), [*values append*](api::SpreadsheetValueAppendCall), [*values batch clear*](api::SpreadsheetValueBatchClearCall), [*values batch clear by data filter*](api::SpreadsheetValueBatchClearByDataFilterCall), [*values batch get*](api::SpreadsheetValueBatchGetCall), [*values batch get by data filter*](api::SpreadsheetValueBatchGetByDataFilterCall), [*values batch update*](api::SpreadsheetValueBatchUpdateCall), [*values batch update by data filter*](api::SpreadsheetValueBatchUpdateByDataFilterCall), [*values clear*](api::SpreadsheetValueClearCall), [*values get*](api::SpreadsheetValueGetCall) and [*values update*](api::SpreadsheetValueUpdateCall) @@ -66,8 +66,8 @@ //! let r = hub.spreadsheets().get_by_data_filter(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -96,12 +96,12 @@ //! use std::default::Default; //! use sheets4::{Sheets, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -147,10 +147,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -160,25 +160,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/siteverification1/README.md b/gen/siteverification1/README.md index 385c072201..0bf7150c22 100644 --- a/gen/siteverification1/README.md +++ b/gen/siteverification1/README.md @@ -11,7 +11,7 @@ Everything else about the *siteVerification* *v1* API can be found at the [official documentation site](https://developers.google.com/site-verification/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-siteverification1/5.0.3+20191119/google_siteverification1/SiteVerification) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-siteverification1/5.0.3+20191119/google_siteverification1/SiteVerification) ... * web resource * [*delete*](https://docs.rs/google-siteverification1/5.0.3+20191119/google_siteverification1/api::WebResourceDeleteCall), [*get*](https://docs.rs/google-siteverification1/5.0.3+20191119/google_siteverification1/api::WebResourceGetCall), [*get token*](https://docs.rs/google-siteverification1/5.0.3+20191119/google_siteverification1/api::WebResourceGetTokenCall), [*insert*](https://docs.rs/google-siteverification1/5.0.3+20191119/google_siteverification1/api::WebResourceInsertCall), [*list*](https://docs.rs/google-siteverification1/5.0.3+20191119/google_siteverification1/api::WebResourceListCall), [*patch*](https://docs.rs/google-siteverification1/5.0.3+20191119/google_siteverification1/api::WebResourcePatchCall) and [*update*](https://docs.rs/google-siteverification1/5.0.3+20191119/google_siteverification1/api::WebResourceUpdateCall) @@ -53,8 +53,8 @@ let r = hub.web_resource().patch(...).doit().await let r = hub.web_resource().update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -82,12 +82,12 @@ use siteverification1::{Result, Error}; use std::default::Default; use siteverification1::{SiteVerification, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -128,10 +128,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-siteverification1/5.0.3+20191119/google_siteverification1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-siteverification1/5.0.3+20191119/google_siteverification1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -141,25 +141,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-siteve You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-siteverification1/5.0.3+20191119/google_siteverification1/client::Delegate) to the -[Method Builder](https://docs.rs/google-siteverification1/5.0.3+20191119/google_siteverification1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-siteverification1/5.0.3+20191119/google_siteverification1/client::Delegate) to the +[Method Builder](https://docs.rs/google-siteverification1/5.0.3+20191119/google_siteverification1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-siteverification1/5.0.3+20191119/google_siteverification1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-siteverification1/5.0.3+20191119/google_siteverification1/client::RequestValue) and -[decodable](https://docs.rs/google-siteverification1/5.0.3+20191119/google_siteverification1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-siteverification1/5.0.3+20191119/google_siteverification1/client::RequestValue) and +[decodable](https://docs.rs/google-siteverification1/5.0.3+20191119/google_siteverification1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-siteverification1/5.0.3+20191119/google_siteverification1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-siteverification1/5.0.3+20191119/google_siteverification1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -178,7 +178,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **siteverification1** library was generated by Sebastian Thiel, and is placed +The **siteverification1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/siteverification1/src/api.rs b/gen/siteverification1/src/api.rs index 9460d11bc0..884c608e9b 100644 --- a/gen/siteverification1/src/api.rs +++ b/gen/siteverification1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// Manage the list of sites and domains you control Full, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use siteverification1::{SiteVerification, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/siteverification1/src/lib.rs b/gen/siteverification1/src/lib.rs index 06c8b5bbfc..749ce493db 100644 --- a/gen/siteverification1/src/lib.rs +++ b/gen/siteverification1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/siteverification1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](SiteVerification) ... +//! Handle the following *Resources* with ease from the central [hub](SiteVerification) ... //! //! * web resource //! * [*delete*](api::WebResourceDeleteCall), [*get*](api::WebResourceGetCall), [*get token*](api::WebResourceGetTokenCall), [*insert*](api::WebResourceInsertCall), [*list*](api::WebResourceListCall), [*patch*](api::WebResourcePatchCall) and [*update*](api::WebResourceUpdateCall) @@ -53,8 +53,8 @@ //! let r = hub.web_resource().update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -83,12 +83,12 @@ //! use std::default::Default; //! use siteverification1::{SiteVerification, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -129,10 +129,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -142,25 +142,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/smartdevicemanagement1/README.md b/gen/smartdevicemanagement1/README.md index 50af5aba4c..30b3e63ae2 100644 --- a/gen/smartdevicemanagement1/README.md +++ b/gen/smartdevicemanagement1/README.md @@ -11,7 +11,7 @@ Everything else about the *Smart Device Management* *v1* API can be found at the [official documentation site](https://developers.google.com/nest/device-access). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-smartdevicemanagement1/5.0.3+20230112/google_smartdevicemanagement1/SmartDeviceManagement) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-smartdevicemanagement1/5.0.3+20230112/google_smartdevicemanagement1/SmartDeviceManagement) ... * enterprises * [*devices execute command*](https://docs.rs/google-smartdevicemanagement1/5.0.3+20230112/google_smartdevicemanagement1/api::EnterpriseDeviceExecuteCommandCall), [*devices get*](https://docs.rs/google-smartdevicemanagement1/5.0.3+20230112/google_smartdevicemanagement1/api::EnterpriseDeviceGetCall), [*devices list*](https://docs.rs/google-smartdevicemanagement1/5.0.3+20230112/google_smartdevicemanagement1/api::EnterpriseDeviceListCall), [*structures get*](https://docs.rs/google-smartdevicemanagement1/5.0.3+20230112/google_smartdevicemanagement1/api::EnterpriseStructureGetCall), [*structures list*](https://docs.rs/google-smartdevicemanagement1/5.0.3+20230112/google_smartdevicemanagement1/api::EnterpriseStructureListCall), [*structures rooms get*](https://docs.rs/google-smartdevicemanagement1/5.0.3+20230112/google_smartdevicemanagement1/api::EnterpriseStructureRoomGetCall) and [*structures rooms list*](https://docs.rs/google-smartdevicemanagement1/5.0.3+20230112/google_smartdevicemanagement1/api::EnterpriseStructureRoomListCall) @@ -50,8 +50,8 @@ Or specifically ... let r = hub.enterprises().devices_get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -78,12 +78,12 @@ use smartdevicemanagement1::{Result, Error}; use std::default::Default; use smartdevicemanagement1::{SmartDeviceManagement, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -119,10 +119,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-smartdevicemanagement1/5.0.3+20230112/google_smartdevicemanagement1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-smartdevicemanagement1/5.0.3+20230112/google_smartdevicemanagement1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -132,25 +132,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-smartd You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-smartdevicemanagement1/5.0.3+20230112/google_smartdevicemanagement1/client::Delegate) to the -[Method Builder](https://docs.rs/google-smartdevicemanagement1/5.0.3+20230112/google_smartdevicemanagement1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-smartdevicemanagement1/5.0.3+20230112/google_smartdevicemanagement1/client::Delegate) to the +[Method Builder](https://docs.rs/google-smartdevicemanagement1/5.0.3+20230112/google_smartdevicemanagement1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-smartdevicemanagement1/5.0.3+20230112/google_smartdevicemanagement1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-smartdevicemanagement1/5.0.3+20230112/google_smartdevicemanagement1/client::RequestValue) and -[decodable](https://docs.rs/google-smartdevicemanagement1/5.0.3+20230112/google_smartdevicemanagement1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-smartdevicemanagement1/5.0.3+20230112/google_smartdevicemanagement1/client::RequestValue) and +[decodable](https://docs.rs/google-smartdevicemanagement1/5.0.3+20230112/google_smartdevicemanagement1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-smartdevicemanagement1/5.0.3+20230112/google_smartdevicemanagement1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-smartdevicemanagement1/5.0.3+20230112/google_smartdevicemanagement1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -169,7 +169,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **smartdevicemanagement1** library was generated by Sebastian Thiel, and is placed +The **smartdevicemanagement1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/smartdevicemanagement1/src/api.rs b/gen/smartdevicemanagement1/src/api.rs index 7e67751834..aab4637fd2 100644 --- a/gen/smartdevicemanagement1/src/api.rs +++ b/gen/smartdevicemanagement1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See and/or control the devices that you selected SdmService, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use smartdevicemanagement1::{SmartDeviceManagement, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/smartdevicemanagement1/src/lib.rs b/gen/smartdevicemanagement1/src/lib.rs index 9b55e9a877..53c0d76bf5 100644 --- a/gen/smartdevicemanagement1/src/lib.rs +++ b/gen/smartdevicemanagement1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/smartdevicemanagement1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](SmartDeviceManagement) ... +//! Handle the following *Resources* with ease from the central [hub](SmartDeviceManagement) ... //! //! * enterprises //! * [*devices execute command*](api::EnterpriseDeviceExecuteCommandCall), [*devices get*](api::EnterpriseDeviceGetCall), [*devices list*](api::EnterpriseDeviceListCall), [*structures get*](api::EnterpriseStructureGetCall), [*structures list*](api::EnterpriseStructureListCall), [*structures rooms get*](api::EnterpriseStructureRoomGetCall) and [*structures rooms list*](api::EnterpriseStructureRoomListCall) @@ -50,8 +50,8 @@ //! let r = hub.enterprises().devices_get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -79,12 +79,12 @@ //! use std::default::Default; //! use smartdevicemanagement1::{SmartDeviceManagement, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -120,10 +120,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -133,25 +133,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/sourcerepo1/README.md b/gen/sourcerepo1/README.md index 81e5525676..db09fc7d5a 100644 --- a/gen/sourcerepo1/README.md +++ b/gen/sourcerepo1/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Source Repositories* *v1* API can be found at t [official documentation site](https://cloud.google.com/source-repositories/docs/apis). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-sourcerepo1/5.0.3+20230123/google_sourcerepo1/CloudSourceRepositories) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-sourcerepo1/5.0.3+20230123/google_sourcerepo1/CloudSourceRepositories) ... * projects * [*get config*](https://docs.rs/google-sourcerepo1/5.0.3+20230123/google_sourcerepo1/api::ProjectGetConfigCall), [*repos create*](https://docs.rs/google-sourcerepo1/5.0.3+20230123/google_sourcerepo1/api::ProjectRepoCreateCall), [*repos delete*](https://docs.rs/google-sourcerepo1/5.0.3+20230123/google_sourcerepo1/api::ProjectRepoDeleteCall), [*repos get*](https://docs.rs/google-sourcerepo1/5.0.3+20230123/google_sourcerepo1/api::ProjectRepoGetCall), [*repos get iam policy*](https://docs.rs/google-sourcerepo1/5.0.3+20230123/google_sourcerepo1/api::ProjectRepoGetIamPolicyCall), [*repos list*](https://docs.rs/google-sourcerepo1/5.0.3+20230123/google_sourcerepo1/api::ProjectRepoListCall), [*repos patch*](https://docs.rs/google-sourcerepo1/5.0.3+20230123/google_sourcerepo1/api::ProjectRepoPatchCall), [*repos set iam policy*](https://docs.rs/google-sourcerepo1/5.0.3+20230123/google_sourcerepo1/api::ProjectRepoSetIamPolicyCall), [*repos sync*](https://docs.rs/google-sourcerepo1/5.0.3+20230123/google_sourcerepo1/api::ProjectRepoSyncCall), [*repos test iam permissions*](https://docs.rs/google-sourcerepo1/5.0.3+20230123/google_sourcerepo1/api::ProjectRepoTestIamPermissionCall) and [*update config*](https://docs.rs/google-sourcerepo1/5.0.3+20230123/google_sourcerepo1/api::ProjectUpdateConfigCall) @@ -52,8 +52,8 @@ let r = hub.projects().repos_get(...).doit().await let r = hub.projects().repos_patch(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -81,12 +81,12 @@ use sourcerepo1::{Result, Error}; use std::default::Default; use sourcerepo1::{CloudSourceRepositories, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -127,10 +127,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-sourcerepo1/5.0.3+20230123/google_sourcerepo1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-sourcerepo1/5.0.3+20230123/google_sourcerepo1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -140,25 +140,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-source You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-sourcerepo1/5.0.3+20230123/google_sourcerepo1/client::Delegate) to the -[Method Builder](https://docs.rs/google-sourcerepo1/5.0.3+20230123/google_sourcerepo1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-sourcerepo1/5.0.3+20230123/google_sourcerepo1/client::Delegate) to the +[Method Builder](https://docs.rs/google-sourcerepo1/5.0.3+20230123/google_sourcerepo1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-sourcerepo1/5.0.3+20230123/google_sourcerepo1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-sourcerepo1/5.0.3+20230123/google_sourcerepo1/client::RequestValue) and -[decodable](https://docs.rs/google-sourcerepo1/5.0.3+20230123/google_sourcerepo1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-sourcerepo1/5.0.3+20230123/google_sourcerepo1/client::RequestValue) and +[decodable](https://docs.rs/google-sourcerepo1/5.0.3+20230123/google_sourcerepo1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-sourcerepo1/5.0.3+20230123/google_sourcerepo1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-sourcerepo1/5.0.3+20230123/google_sourcerepo1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -177,7 +177,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **sourcerepo1** library was generated by Sebastian Thiel, and is placed +The **sourcerepo1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/sourcerepo1/src/api.rs b/gen/sourcerepo1/src/api.rs index a1542c5a9a..81bf0e78b7 100644 --- a/gen/sourcerepo1/src/api.rs +++ b/gen/sourcerepo1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -77,12 +77,12 @@ impl Default for Scope { /// use std::default::Default; /// use sourcerepo1::{CloudSourceRepositories, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/sourcerepo1/src/lib.rs b/gen/sourcerepo1/src/lib.rs index 76b5c48bed..058b242cf3 100644 --- a/gen/sourcerepo1/src/lib.rs +++ b/gen/sourcerepo1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/sourcerepo1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudSourceRepositories) ... +//! Handle the following *Resources* with ease from the central [hub](CloudSourceRepositories) ... //! //! * projects //! * [*get config*](api::ProjectGetConfigCall), [*repos create*](api::ProjectRepoCreateCall), [*repos delete*](api::ProjectRepoDeleteCall), [*repos get*](api::ProjectRepoGetCall), [*repos get iam policy*](api::ProjectRepoGetIamPolicyCall), [*repos list*](api::ProjectRepoListCall), [*repos patch*](api::ProjectRepoPatchCall), [*repos set iam policy*](api::ProjectRepoSetIamPolicyCall), [*repos sync*](api::ProjectRepoSyncCall), [*repos test iam permissions*](api::ProjectRepoTestIamPermissionCall) and [*update config*](api::ProjectUpdateConfigCall) @@ -52,8 +52,8 @@ //! let r = hub.projects().repos_patch(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -82,12 +82,12 @@ //! use std::default::Default; //! use sourcerepo1::{CloudSourceRepositories, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -128,10 +128,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -141,25 +141,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/spectrum1_explorer/README.md b/gen/spectrum1_explorer/README.md index ef5ffdd8ae..5bb985f0a5 100644 --- a/gen/spectrum1_explorer/README.md +++ b/gen/spectrum1_explorer/README.md @@ -11,7 +11,7 @@ Everything else about the *spectrum* *v1_explorer* API can be found at the [official documentation site](http://developers.google.com/spectrum). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-spectrum1_explorer/5.0.3+20170306/google_spectrum1_explorer/Spectrum) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-spectrum1_explorer/5.0.3+20170306/google_spectrum1_explorer/Spectrum) ... * paws * [*get spectrum*](https://docs.rs/google-spectrum1_explorer/5.0.3+20170306/google_spectrum1_explorer/api::PawGetSpectrumCall), [*get spectrum batch*](https://docs.rs/google-spectrum1_explorer/5.0.3+20170306/google_spectrum1_explorer/api::PawGetSpectrumBatchCall), [*init*](https://docs.rs/google-spectrum1_explorer/5.0.3+20170306/google_spectrum1_explorer/api::PawInitCall), [*notify spectrum use*](https://docs.rs/google-spectrum1_explorer/5.0.3+20170306/google_spectrum1_explorer/api::PawNotifySpectrumUseCall), [*register*](https://docs.rs/google-spectrum1_explorer/5.0.3+20170306/google_spectrum1_explorer/api::PawRegisterCall) and [*verify device*](https://docs.rs/google-spectrum1_explorer/5.0.3+20170306/google_spectrum1_explorer/api::PawVerifyDeviceCall) @@ -50,8 +50,8 @@ Or specifically ... let r = hub.paws().get_spectrum_batch(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -79,12 +79,12 @@ use spectrum1_explorer::{Result, Error}; use std::default::Default; use spectrum1_explorer::{Spectrum, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -125,10 +125,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-spectrum1_explorer/5.0.3+20170306/google_spectrum1_explorer/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-spectrum1_explorer/5.0.3+20170306/google_spectrum1_explorer/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -138,25 +138,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-spectr You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-spectrum1_explorer/5.0.3+20170306/google_spectrum1_explorer/client::Delegate) to the -[Method Builder](https://docs.rs/google-spectrum1_explorer/5.0.3+20170306/google_spectrum1_explorer/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-spectrum1_explorer/5.0.3+20170306/google_spectrum1_explorer/client::Delegate) to the +[Method Builder](https://docs.rs/google-spectrum1_explorer/5.0.3+20170306/google_spectrum1_explorer/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-spectrum1_explorer/5.0.3+20170306/google_spectrum1_explorer/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-spectrum1_explorer/5.0.3+20170306/google_spectrum1_explorer/client::RequestValue) and -[decodable](https://docs.rs/google-spectrum1_explorer/5.0.3+20170306/google_spectrum1_explorer/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-spectrum1_explorer/5.0.3+20170306/google_spectrum1_explorer/client::RequestValue) and +[decodable](https://docs.rs/google-spectrum1_explorer/5.0.3+20170306/google_spectrum1_explorer/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-spectrum1_explorer/5.0.3+20170306/google_spectrum1_explorer/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-spectrum1_explorer/5.0.3+20170306/google_spectrum1_explorer/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -175,7 +175,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **spectrum1_explorer** library was generated by Sebastian Thiel, and is placed +The **spectrum1_explorer** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/spectrum1_explorer/src/api.rs b/gen/spectrum1_explorer/src/api.rs index 7424d03627..c70d20859b 100644 --- a/gen/spectrum1_explorer/src/api.rs +++ b/gen/spectrum1_explorer/src/api.rs @@ -43,12 +43,12 @@ use crate::{client, client::GetToken, client::serde_with}; /// use std::default::Default; /// use spectrum1_explorer::{Spectrum, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/spectrum1_explorer/src/lib.rs b/gen/spectrum1_explorer/src/lib.rs index d4be5899dd..d968bd5ebe 100644 --- a/gen/spectrum1_explorer/src/lib.rs +++ b/gen/spectrum1_explorer/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/spectrum1_explorer). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Spectrum) ... +//! Handle the following *Resources* with ease from the central [hub](Spectrum) ... //! //! * paws //! * [*get spectrum*](api::PawGetSpectrumCall), [*get spectrum batch*](api::PawGetSpectrumBatchCall), [*init*](api::PawInitCall), [*notify spectrum use*](api::PawNotifySpectrumUseCall), [*register*](api::PawRegisterCall) and [*verify device*](api::PawVerifyDeviceCall) @@ -50,8 +50,8 @@ //! let r = hub.paws().get_spectrum_batch(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -80,12 +80,12 @@ //! use std::default::Default; //! use spectrum1_explorer::{Spectrum, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -126,10 +126,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -139,25 +139,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/speech1/README.md b/gen/speech1/README.md index 4445e1f295..bac545ec32 100644 --- a/gen/speech1/README.md +++ b/gen/speech1/README.md @@ -11,7 +11,7 @@ Everything else about the *Speech* *v1* API can be found at the [official documentation site](https://cloud.google.com/speech-to-text/docs/quickstart-protocol). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-speech1/5.0.3+20230119/google_speech1/Speech) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-speech1/5.0.3+20230119/google_speech1/Speech) ... * [operations](https://docs.rs/google-speech1/5.0.3+20230119/google_speech1/api::Operation) * [*get*](https://docs.rs/google-speech1/5.0.3+20230119/google_speech1/api::OperationGetCall) and [*list*](https://docs.rs/google-speech1/5.0.3+20230119/google_speech1/api::OperationListCall) @@ -56,8 +56,8 @@ let r = hub.operations().list(...).doit().await let r = hub.speech().longrunningrecognize(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -84,12 +84,12 @@ use speech1::{Result, Error}; use std::default::Default; use speech1::{Speech, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -129,10 +129,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-speech1/5.0.3+20230119/google_speech1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-speech1/5.0.3+20230119/google_speech1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -142,25 +142,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-speech You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-speech1/5.0.3+20230119/google_speech1/client::Delegate) to the -[Method Builder](https://docs.rs/google-speech1/5.0.3+20230119/google_speech1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-speech1/5.0.3+20230119/google_speech1/client::Delegate) to the +[Method Builder](https://docs.rs/google-speech1/5.0.3+20230119/google_speech1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-speech1/5.0.3+20230119/google_speech1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-speech1/5.0.3+20230119/google_speech1/client::RequestValue) and -[decodable](https://docs.rs/google-speech1/5.0.3+20230119/google_speech1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-speech1/5.0.3+20230119/google_speech1/client::RequestValue) and +[decodable](https://docs.rs/google-speech1/5.0.3+20230119/google_speech1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-speech1/5.0.3+20230119/google_speech1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-speech1/5.0.3+20230119/google_speech1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -179,7 +179,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **speech1** library was generated by Sebastian Thiel, and is placed +The **speech1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/speech1/src/api.rs b/gen/speech1/src/api.rs index 453f3f8a93..748b5cb8bd 100644 --- a/gen/speech1/src/api.rs +++ b/gen/speech1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use speech1::{Speech, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/speech1/src/lib.rs b/gen/speech1/src/lib.rs index aad5b2a41f..6353f4ec4b 100644 --- a/gen/speech1/src/lib.rs +++ b/gen/speech1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/speech1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Speech) ... +//! Handle the following *Resources* with ease from the central [hub](Speech) ... //! //! * [operations](api::Operation) //! * [*get*](api::OperationGetCall) and [*list*](api::OperationListCall) @@ -56,8 +56,8 @@ //! let r = hub.speech().longrunningrecognize(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -85,12 +85,12 @@ //! use std::default::Default; //! use speech1::{Speech, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -130,10 +130,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -143,25 +143,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/speech1_beta1/README.md b/gen/speech1_beta1/README.md index 866244344e..0a17b9dc3c 100644 --- a/gen/speech1_beta1/README.md +++ b/gen/speech1_beta1/README.md @@ -11,7 +11,7 @@ Everything else about the *Speech* *v1_beta1* API can be found at the [official documentation site](https://cloud.google.com/speech-to-text/docs/quickstart-protocol). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-speech1_beta1/5.0.3+20181005/google_speech1_beta1/Speech) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-speech1_beta1/5.0.3+20181005/google_speech1_beta1/Speech) ... * [operations](https://docs.rs/google-speech1_beta1/5.0.3+20181005/google_speech1_beta1/api::Operation) * [*get*](https://docs.rs/google-speech1_beta1/5.0.3+20181005/google_speech1_beta1/api::OperationGetCall) and [*list*](https://docs.rs/google-speech1_beta1/5.0.3+20181005/google_speech1_beta1/api::OperationListCall) @@ -54,8 +54,8 @@ let r = hub.operations().get(...).doit().await let r = hub.speech().asyncrecognize(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -82,12 +82,12 @@ use speech1_beta1::{Result, Error}; use std::default::Default; use speech1_beta1::{Speech, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -127,10 +127,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-speech1_beta1/5.0.3+20181005/google_speech1_beta1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-speech1_beta1/5.0.3+20181005/google_speech1_beta1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -140,25 +140,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-speech You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-speech1_beta1/5.0.3+20181005/google_speech1_beta1/client::Delegate) to the -[Method Builder](https://docs.rs/google-speech1_beta1/5.0.3+20181005/google_speech1_beta1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-speech1_beta1/5.0.3+20181005/google_speech1_beta1/client::Delegate) to the +[Method Builder](https://docs.rs/google-speech1_beta1/5.0.3+20181005/google_speech1_beta1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-speech1_beta1/5.0.3+20181005/google_speech1_beta1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-speech1_beta1/5.0.3+20181005/google_speech1_beta1/client::RequestValue) and -[decodable](https://docs.rs/google-speech1_beta1/5.0.3+20181005/google_speech1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-speech1_beta1/5.0.3+20181005/google_speech1_beta1/client::RequestValue) and +[decodable](https://docs.rs/google-speech1_beta1/5.0.3+20181005/google_speech1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-speech1_beta1/5.0.3+20181005/google_speech1_beta1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-speech1_beta1/5.0.3+20181005/google_speech1_beta1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -177,7 +177,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **speech1_beta1** library was generated by Sebastian Thiel, and is placed +The **speech1_beta1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/speech1_beta1/src/api.rs b/gen/speech1_beta1/src/api.rs index 819cd50632..07886d670f 100644 --- a/gen/speech1_beta1/src/api.rs +++ b/gen/speech1_beta1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your data across Google Cloud Platform services CloudPlatform, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use speech1_beta1::{Speech, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/speech1_beta1/src/lib.rs b/gen/speech1_beta1/src/lib.rs index 10536dccff..459f5e50aa 100644 --- a/gen/speech1_beta1/src/lib.rs +++ b/gen/speech1_beta1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/speech1_beta1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Speech) ... +//! Handle the following *Resources* with ease from the central [hub](Speech) ... //! //! * [operations](api::Operation) //! * [*get*](api::OperationGetCall) and [*list*](api::OperationListCall) @@ -54,8 +54,8 @@ //! let r = hub.speech().asyncrecognize(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -83,12 +83,12 @@ //! use std::default::Default; //! use speech1_beta1::{Speech, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -128,10 +128,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -141,25 +141,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/sql1_beta4/README.md b/gen/sql1_beta4/README.md index f33a8144ec..bf2e61239f 100644 --- a/gen/sql1_beta4/README.md +++ b/gen/sql1_beta4/README.md @@ -11,7 +11,7 @@ Everything else about the *SQL Admin* *v1_beta4* API can be found at the [official documentation site](https://developers.google.com/cloud-sql/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-sql1_beta4/5.0.3+20200331/google_sql1_beta4/SQLAdmin) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-sql1_beta4/5.0.3+20200331/google_sql1_beta4/SQLAdmin) ... * [backup runs](https://docs.rs/google-sql1_beta4/5.0.3+20200331/google_sql1_beta4/api::BackupRun) * [*delete*](https://docs.rs/google-sql1_beta4/5.0.3+20200331/google_sql1_beta4/api::BackupRunDeleteCall), [*get*](https://docs.rs/google-sql1_beta4/5.0.3+20200331/google_sql1_beta4/api::BackupRunGetCall), [*insert*](https://docs.rs/google-sql1_beta4/5.0.3+20200331/google_sql1_beta4/api::BackupRunInsertCall) and [*list*](https://docs.rs/google-sql1_beta4/5.0.3+20200331/google_sql1_beta4/api::BackupRunListCall) @@ -97,8 +97,8 @@ let r = hub.users().insert(...).doit().await let r = hub.users().update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -126,12 +126,12 @@ use sql1_beta4::{Result, Error}; use std::default::Default; use sql1_beta4::{SQLAdmin, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -174,10 +174,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-sql1_beta4/5.0.3+20200331/google_sql1_beta4/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-sql1_beta4/5.0.3+20200331/google_sql1_beta4/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -187,25 +187,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-sql1_b You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-sql1_beta4/5.0.3+20200331/google_sql1_beta4/client::Delegate) to the -[Method Builder](https://docs.rs/google-sql1_beta4/5.0.3+20200331/google_sql1_beta4/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-sql1_beta4/5.0.3+20200331/google_sql1_beta4/client::Delegate) to the +[Method Builder](https://docs.rs/google-sql1_beta4/5.0.3+20200331/google_sql1_beta4/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-sql1_beta4/5.0.3+20200331/google_sql1_beta4/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-sql1_beta4/5.0.3+20200331/google_sql1_beta4/client::RequestValue) and -[decodable](https://docs.rs/google-sql1_beta4/5.0.3+20200331/google_sql1_beta4/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-sql1_beta4/5.0.3+20200331/google_sql1_beta4/client::RequestValue) and +[decodable](https://docs.rs/google-sql1_beta4/5.0.3+20200331/google_sql1_beta4/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-sql1_beta4/5.0.3+20200331/google_sql1_beta4/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-sql1_beta4/5.0.3+20200331/google_sql1_beta4/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -224,7 +224,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **sql1_beta4** library was generated by Sebastian Thiel, and is placed +The **sql1_beta4** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/sql1_beta4/src/api.rs b/gen/sql1_beta4/src/api.rs index 9e1a0e4667..ace18c992e 100644 --- a/gen/sql1_beta4/src/api.rs +++ b/gen/sql1_beta4/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your data across Google Cloud Platform services CloudPlatform, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use sql1_beta4::{SQLAdmin, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/sql1_beta4/src/lib.rs b/gen/sql1_beta4/src/lib.rs index 7431a69e60..50d9346e3d 100644 --- a/gen/sql1_beta4/src/lib.rs +++ b/gen/sql1_beta4/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/sql1_beta4). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](SQLAdmin) ... +//! Handle the following *Resources* with ease from the central [hub](SQLAdmin) ... //! //! * [backup runs](api::BackupRun) //! * [*delete*](api::BackupRunDeleteCall), [*get*](api::BackupRunGetCall), [*insert*](api::BackupRunInsertCall) and [*list*](api::BackupRunListCall) @@ -97,8 +97,8 @@ //! let r = hub.users().update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -127,12 +127,12 @@ //! use std::default::Default; //! use sql1_beta4::{SQLAdmin, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -175,10 +175,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -188,25 +188,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/sqladmin1/README.md b/gen/sqladmin1/README.md index ade1c8718a..7bdbbf3181 100644 --- a/gen/sqladmin1/README.md +++ b/gen/sqladmin1/README.md @@ -11,7 +11,7 @@ Everything else about the *SQL Admin* *v1* API can be found at the [official documentation site](https://developers.google.com/cloud-sql/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-sqladmin1/5.0.3+20221209/google_sqladmin1/SQLAdmin) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-sqladmin1/5.0.3+20221209/google_sqladmin1/SQLAdmin) ... * [backup runs](https://docs.rs/google-sqladmin1/5.0.3+20221209/google_sqladmin1/api::BackupRun) * [*delete*](https://docs.rs/google-sqladmin1/5.0.3+20221209/google_sqladmin1/api::BackupRunDeleteCall), [*get*](https://docs.rs/google-sqladmin1/5.0.3+20221209/google_sqladmin1/api::BackupRunGetCall), [*insert*](https://docs.rs/google-sqladmin1/5.0.3+20221209/google_sqladmin1/api::BackupRunInsertCall) and [*list*](https://docs.rs/google-sqladmin1/5.0.3+20221209/google_sqladmin1/api::BackupRunListCall) @@ -99,8 +99,8 @@ let r = hub.users().insert(...).doit().await let r = hub.users().update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -128,12 +128,12 @@ use sqladmin1::{Result, Error}; use std::default::Default; use sqladmin1::{SQLAdmin, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -176,10 +176,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-sqladmin1/5.0.3+20221209/google_sqladmin1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-sqladmin1/5.0.3+20221209/google_sqladmin1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -189,25 +189,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-sqladm You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-sqladmin1/5.0.3+20221209/google_sqladmin1/client::Delegate) to the -[Method Builder](https://docs.rs/google-sqladmin1/5.0.3+20221209/google_sqladmin1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-sqladmin1/5.0.3+20221209/google_sqladmin1/client::Delegate) to the +[Method Builder](https://docs.rs/google-sqladmin1/5.0.3+20221209/google_sqladmin1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-sqladmin1/5.0.3+20221209/google_sqladmin1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-sqladmin1/5.0.3+20221209/google_sqladmin1/client::RequestValue) and -[decodable](https://docs.rs/google-sqladmin1/5.0.3+20221209/google_sqladmin1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-sqladmin1/5.0.3+20221209/google_sqladmin1/client::RequestValue) and +[decodable](https://docs.rs/google-sqladmin1/5.0.3+20221209/google_sqladmin1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-sqladmin1/5.0.3+20221209/google_sqladmin1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-sqladmin1/5.0.3+20221209/google_sqladmin1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -226,7 +226,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **sqladmin1** library was generated by Sebastian Thiel, and is placed +The **sqladmin1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/sqladmin1/src/api.rs b/gen/sqladmin1/src/api.rs index 52347e0be5..6b6448aaa5 100644 --- a/gen/sqladmin1/src/api.rs +++ b/gen/sqladmin1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use sqladmin1::{SQLAdmin, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/sqladmin1/src/lib.rs b/gen/sqladmin1/src/lib.rs index c8ea7b434f..1f33e0eec6 100644 --- a/gen/sqladmin1/src/lib.rs +++ b/gen/sqladmin1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/sqladmin1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](SQLAdmin) ... +//! Handle the following *Resources* with ease from the central [hub](SQLAdmin) ... //! //! * [backup runs](api::BackupRun) //! * [*delete*](api::BackupRunDeleteCall), [*get*](api::BackupRunGetCall), [*insert*](api::BackupRunInsertCall) and [*list*](api::BackupRunListCall) @@ -99,8 +99,8 @@ //! let r = hub.users().update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -129,12 +129,12 @@ //! use std::default::Default; //! use sqladmin1::{SQLAdmin, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -177,10 +177,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -190,25 +190,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/sqladmin1_beta4/README.md b/gen/sqladmin1_beta4/README.md index 2ef97ce671..ca9b7a6f73 100644 --- a/gen/sqladmin1_beta4/README.md +++ b/gen/sqladmin1_beta4/README.md @@ -11,7 +11,7 @@ Everything else about the *SQL Admin* *v1_beta4* API can be found at the [official documentation site](https://developers.google.com/cloud-sql/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-sqladmin1_beta4/5.0.3+20221209/google_sqladmin1_beta4/SQLAdmin) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-sqladmin1_beta4/5.0.3+20221209/google_sqladmin1_beta4/SQLAdmin) ... * [backup runs](https://docs.rs/google-sqladmin1_beta4/5.0.3+20221209/google_sqladmin1_beta4/api::BackupRun) * [*delete*](https://docs.rs/google-sqladmin1_beta4/5.0.3+20221209/google_sqladmin1_beta4/api::BackupRunDeleteCall), [*get*](https://docs.rs/google-sqladmin1_beta4/5.0.3+20221209/google_sqladmin1_beta4/api::BackupRunGetCall), [*insert*](https://docs.rs/google-sqladmin1_beta4/5.0.3+20221209/google_sqladmin1_beta4/api::BackupRunInsertCall) and [*list*](https://docs.rs/google-sqladmin1_beta4/5.0.3+20221209/google_sqladmin1_beta4/api::BackupRunListCall) @@ -99,8 +99,8 @@ let r = hub.users().insert(...).doit().await let r = hub.users().update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -128,12 +128,12 @@ use sqladmin1_beta4::{Result, Error}; use std::default::Default; use sqladmin1_beta4::{SQLAdmin, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -176,10 +176,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-sqladmin1_beta4/5.0.3+20221209/google_sqladmin1_beta4/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-sqladmin1_beta4/5.0.3+20221209/google_sqladmin1_beta4/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -189,25 +189,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-sqladm You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-sqladmin1_beta4/5.0.3+20221209/google_sqladmin1_beta4/client::Delegate) to the -[Method Builder](https://docs.rs/google-sqladmin1_beta4/5.0.3+20221209/google_sqladmin1_beta4/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-sqladmin1_beta4/5.0.3+20221209/google_sqladmin1_beta4/client::Delegate) to the +[Method Builder](https://docs.rs/google-sqladmin1_beta4/5.0.3+20221209/google_sqladmin1_beta4/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-sqladmin1_beta4/5.0.3+20221209/google_sqladmin1_beta4/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-sqladmin1_beta4/5.0.3+20221209/google_sqladmin1_beta4/client::RequestValue) and -[decodable](https://docs.rs/google-sqladmin1_beta4/5.0.3+20221209/google_sqladmin1_beta4/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-sqladmin1_beta4/5.0.3+20221209/google_sqladmin1_beta4/client::RequestValue) and +[decodable](https://docs.rs/google-sqladmin1_beta4/5.0.3+20221209/google_sqladmin1_beta4/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-sqladmin1_beta4/5.0.3+20221209/google_sqladmin1_beta4/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-sqladmin1_beta4/5.0.3+20221209/google_sqladmin1_beta4/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -226,7 +226,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **sqladmin1_beta4** library was generated by Sebastian Thiel, and is placed +The **sqladmin1_beta4** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/sqladmin1_beta4/src/api.rs b/gen/sqladmin1_beta4/src/api.rs index d0bb6755ac..6b778573df 100644 --- a/gen/sqladmin1_beta4/src/api.rs +++ b/gen/sqladmin1_beta4/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use sqladmin1_beta4::{SQLAdmin, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/sqladmin1_beta4/src/lib.rs b/gen/sqladmin1_beta4/src/lib.rs index dbdad0f9d5..2e04d8daa7 100644 --- a/gen/sqladmin1_beta4/src/lib.rs +++ b/gen/sqladmin1_beta4/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/sqladmin1_beta4). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](SQLAdmin) ... +//! Handle the following *Resources* with ease from the central [hub](SQLAdmin) ... //! //! * [backup runs](api::BackupRun) //! * [*delete*](api::BackupRunDeleteCall), [*get*](api::BackupRunGetCall), [*insert*](api::BackupRunInsertCall) and [*list*](api::BackupRunListCall) @@ -99,8 +99,8 @@ //! let r = hub.users().update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -129,12 +129,12 @@ //! use std::default::Default; //! use sqladmin1_beta4::{SQLAdmin, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -177,10 +177,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -190,25 +190,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/storage1/README.md b/gen/storage1/README.md index 4f1f80dd13..4ac795329c 100644 --- a/gen/storage1/README.md +++ b/gen/storage1/README.md @@ -11,7 +11,7 @@ Everything else about the *storage* *v1* API can be found at the [official documentation site](https://developers.google.com/storage/docs/json_api/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-storage1/5.0.3+20230119/google_storage1/Storage) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-storage1/5.0.3+20230119/google_storage1/Storage) ... * [bucket access controls](https://docs.rs/google-storage1/5.0.3+20230119/google_storage1/api::BucketAccessControl) * [*delete*](https://docs.rs/google-storage1/5.0.3+20230119/google_storage1/api::BucketAccessControlDeleteCall), [*get*](https://docs.rs/google-storage1/5.0.3+20230119/google_storage1/api::BucketAccessControlGetCall), [*insert*](https://docs.rs/google-storage1/5.0.3+20230119/google_storage1/api::BucketAccessControlInsertCall), [*list*](https://docs.rs/google-storage1/5.0.3+20230119/google_storage1/api::BucketAccessControlListCall), [*patch*](https://docs.rs/google-storage1/5.0.3+20230119/google_storage1/api::BucketAccessControlPatchCall) and [*update*](https://docs.rs/google-storage1/5.0.3+20230119/google_storage1/api::BucketAccessControlUpdateCall) @@ -89,8 +89,8 @@ let r = hub.objects().update(...).doit().await let r = hub.objects().watch_all(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -118,12 +118,12 @@ use storage1::{Result, Error}; use std::default::Default; use storage1::{Storage, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -179,10 +179,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-storage1/5.0.3+20230119/google_storage1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-storage1/5.0.3+20230119/google_storage1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -192,25 +192,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-storag You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-storage1/5.0.3+20230119/google_storage1/client::Delegate) to the -[Method Builder](https://docs.rs/google-storage1/5.0.3+20230119/google_storage1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-storage1/5.0.3+20230119/google_storage1/client::Delegate) to the +[Method Builder](https://docs.rs/google-storage1/5.0.3+20230119/google_storage1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-storage1/5.0.3+20230119/google_storage1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-storage1/5.0.3+20230119/google_storage1/client::RequestValue) and -[decodable](https://docs.rs/google-storage1/5.0.3+20230119/google_storage1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-storage1/5.0.3+20230119/google_storage1/client::RequestValue) and +[decodable](https://docs.rs/google-storage1/5.0.3+20230119/google_storage1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-storage1/5.0.3+20230119/google_storage1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-storage1/5.0.3+20230119/google_storage1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -229,7 +229,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **storage1** library was generated by Sebastian Thiel, and is placed +The **storage1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/storage1/src/api.rs b/gen/storage1/src/api.rs index bf80dc37cb..8b3f75c43b 100644 --- a/gen/storage1/src/api.rs +++ b/gen/storage1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your data across Google Cloud Platform services CloudPlatform, @@ -81,12 +81,12 @@ impl Default for Scope { /// use std::default::Default; /// use storage1::{Storage, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/storage1/src/lib.rs b/gen/storage1/src/lib.rs index b825292ddf..5a754ac97e 100644 --- a/gen/storage1/src/lib.rs +++ b/gen/storage1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/storage1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Storage) ... +//! Handle the following *Resources* with ease from the central [hub](Storage) ... //! //! * [bucket access controls](api::BucketAccessControl) //! * [*delete*](api::BucketAccessControlDeleteCall), [*get*](api::BucketAccessControlGetCall), [*insert*](api::BucketAccessControlInsertCall), [*list*](api::BucketAccessControlListCall), [*patch*](api::BucketAccessControlPatchCall) and [*update*](api::BucketAccessControlUpdateCall) @@ -89,8 +89,8 @@ //! let r = hub.objects().watch_all(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -119,12 +119,12 @@ //! use std::default::Default; //! use storage1::{Storage, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -180,10 +180,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -193,25 +193,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/storagetransfer1/README.md b/gen/storagetransfer1/README.md index f99c234f2e..1b82d38116 100644 --- a/gen/storagetransfer1/README.md +++ b/gen/storagetransfer1/README.md @@ -11,7 +11,7 @@ Everything else about the *storagetransfer* *v1* API can be found at the [official documentation site](https://cloud.google.com/storage-transfer/docs). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-storagetransfer1/5.0.3+20230111/google_storagetransfer1/Storagetransfer) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-storagetransfer1/5.0.3+20230111/google_storagetransfer1/Storagetransfer) ... * [google service accounts](https://docs.rs/google-storagetransfer1/5.0.3+20230111/google_storagetransfer1/api::GoogleServiceAccount) * [*get*](https://docs.rs/google-storagetransfer1/5.0.3+20230111/google_storagetransfer1/api::GoogleServiceAccountGetCall) @@ -61,8 +61,8 @@ let r = hub.transfer_jobs().patch(...).doit().await let r = hub.transfer_jobs().run(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -89,12 +89,12 @@ use storagetransfer1::{Result, Error}; use std::default::Default; use storagetransfer1::{Storagetransfer, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -132,10 +132,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-storagetransfer1/5.0.3+20230111/google_storagetransfer1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-storagetransfer1/5.0.3+20230111/google_storagetransfer1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -145,25 +145,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-storag You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-storagetransfer1/5.0.3+20230111/google_storagetransfer1/client::Delegate) to the -[Method Builder](https://docs.rs/google-storagetransfer1/5.0.3+20230111/google_storagetransfer1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-storagetransfer1/5.0.3+20230111/google_storagetransfer1/client::Delegate) to the +[Method Builder](https://docs.rs/google-storagetransfer1/5.0.3+20230111/google_storagetransfer1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-storagetransfer1/5.0.3+20230111/google_storagetransfer1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-storagetransfer1/5.0.3+20230111/google_storagetransfer1/client::RequestValue) and -[decodable](https://docs.rs/google-storagetransfer1/5.0.3+20230111/google_storagetransfer1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-storagetransfer1/5.0.3+20230111/google_storagetransfer1/client::RequestValue) and +[decodable](https://docs.rs/google-storagetransfer1/5.0.3+20230111/google_storagetransfer1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-storagetransfer1/5.0.3+20230111/google_storagetransfer1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-storagetransfer1/5.0.3+20230111/google_storagetransfer1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -182,7 +182,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **storagetransfer1** library was generated by Sebastian Thiel, and is placed +The **storagetransfer1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/storagetransfer1/src/api.rs b/gen/storagetransfer1/src/api.rs index c9eec6e217..bb2e60532e 100644 --- a/gen/storagetransfer1/src/api.rs +++ b/gen/storagetransfer1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use storagetransfer1::{Storagetransfer, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/storagetransfer1/src/lib.rs b/gen/storagetransfer1/src/lib.rs index 28c2aa80c7..c3ffc4fb11 100644 --- a/gen/storagetransfer1/src/lib.rs +++ b/gen/storagetransfer1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/storagetransfer1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Storagetransfer) ... +//! Handle the following *Resources* with ease from the central [hub](Storagetransfer) ... //! //! * [google service accounts](api::GoogleServiceAccount) //! * [*get*](api::GoogleServiceAccountGetCall) @@ -61,8 +61,8 @@ //! let r = hub.transfer_jobs().run(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -90,12 +90,12 @@ //! use std::default::Default; //! use storagetransfer1::{Storagetransfer, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -133,10 +133,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -146,25 +146,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/sts1/README.md b/gen/sts1/README.md index f603ae869f..891aa50ff6 100644 --- a/gen/sts1/README.md +++ b/gen/sts1/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Security Token* *v1* API can be found at the [official documentation site](http://cloud.google.com/iam/docs/workload-identity-federation). # Features -Use the following functionality with ease from the central [hub](https://docs.rs/google-sts1/5.0.3+20230114/google_sts1/CloudSecurityToken) ... +Use the following functionality with ease from the central [hub](https://docs.rs/google-sts1/5.0.3+20230114/google_sts1/CloudSecurityToken) ... * [introspect](https://docs.rs/google-sts1/5.0.3+20230114/google_sts1/api::MethodIntrospectCall) @@ -51,8 +51,8 @@ Or specifically ... let r = hub.methods().introspect(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -80,12 +80,12 @@ use sts1::{Result, Error}; use std::default::Default; use sts1::{CloudSecurityToken, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -126,10 +126,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-sts1/5.0.3+20230114/google_sts1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-sts1/5.0.3+20230114/google_sts1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -139,25 +139,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-sts1/5 You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-sts1/5.0.3+20230114/google_sts1/client::Delegate) to the -[Method Builder](https://docs.rs/google-sts1/5.0.3+20230114/google_sts1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-sts1/5.0.3+20230114/google_sts1/client::Delegate) to the +[Method Builder](https://docs.rs/google-sts1/5.0.3+20230114/google_sts1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-sts1/5.0.3+20230114/google_sts1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-sts1/5.0.3+20230114/google_sts1/client::RequestValue) and -[decodable](https://docs.rs/google-sts1/5.0.3+20230114/google_sts1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-sts1/5.0.3+20230114/google_sts1/client::RequestValue) and +[decodable](https://docs.rs/google-sts1/5.0.3+20230114/google_sts1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-sts1/5.0.3+20230114/google_sts1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-sts1/5.0.3+20230114/google_sts1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -176,7 +176,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **sts1** library was generated by Sebastian Thiel, and is placed +The **sts1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/sts1/src/api.rs b/gen/sts1/src/api.rs index 40c010d421..07401313ac 100644 --- a/gen/sts1/src/api.rs +++ b/gen/sts1/src/api.rs @@ -43,12 +43,12 @@ use crate::{client, client::GetToken, client::serde_with}; /// use std::default::Default; /// use sts1::{CloudSecurityToken, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/sts1/src/lib.rs b/gen/sts1/src/lib.rs index fa15a90598..71a5a20752 100644 --- a/gen/sts1/src/lib.rs +++ b/gen/sts1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/sts1). //! # Features //! -//! Use the following functionality with ease from the central [hub](CloudSecurityToken) ... +//! Use the following functionality with ease from the central [hub](CloudSecurityToken) ... //! //! //! * [introspect](api::MethodIntrospectCall) @@ -51,8 +51,8 @@ //! let r = hub.methods().introspect(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -81,12 +81,12 @@ //! use std::default::Default; //! use sts1::{CloudSecurityToken, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -127,10 +127,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -140,25 +140,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/surveys2/README.md b/gen/surveys2/README.md index c13d619113..6200214da0 100644 --- a/gen/surveys2/README.md +++ b/gen/surveys2/README.md @@ -8,7 +8,7 @@ The `google-surveys2` library allows access to all features of the *Google Surve This documentation was generated from *Surveys* crate version *5.0.3+20180508*, where *20180508* is the exact revision of the *surveys:v2* schema built by the [mako](http://www.makotemplates.org/) code generator *v5.0.3*. # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-surveys2/5.0.3+20180508/google_surveys2/Surveys) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-surveys2/5.0.3+20180508/google_surveys2/Surveys) ... * results * [*get*](https://docs.rs/google-surveys2/5.0.3+20180508/google_surveys2/api::ResultGetCall) @@ -59,8 +59,8 @@ let r = hub.surveys().stop(...).doit().await let r = hub.surveys().update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -87,12 +87,12 @@ use surveys2::{Result, Error}; use std::default::Default; use surveys2::{Surveys, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -131,10 +131,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-surveys2/5.0.3+20180508/google_surveys2/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-surveys2/5.0.3+20180508/google_surveys2/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -144,25 +144,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-survey You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-surveys2/5.0.3+20180508/google_surveys2/client::Delegate) to the -[Method Builder](https://docs.rs/google-surveys2/5.0.3+20180508/google_surveys2/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-surveys2/5.0.3+20180508/google_surveys2/client::Delegate) to the +[Method Builder](https://docs.rs/google-surveys2/5.0.3+20180508/google_surveys2/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-surveys2/5.0.3+20180508/google_surveys2/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-surveys2/5.0.3+20180508/google_surveys2/client::RequestValue) and -[decodable](https://docs.rs/google-surveys2/5.0.3+20180508/google_surveys2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-surveys2/5.0.3+20180508/google_surveys2/client::RequestValue) and +[decodable](https://docs.rs/google-surveys2/5.0.3+20180508/google_surveys2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-surveys2/5.0.3+20180508/google_surveys2/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-surveys2/5.0.3+20180508/google_surveys2/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -181,7 +181,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **surveys2** library was generated by Sebastian Thiel, and is placed +The **surveys2** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/surveys2/src/api.rs b/gen/surveys2/src/api.rs index 8709e061d4..e7b8e2ed97 100644 --- a/gen/surveys2/src/api.rs +++ b/gen/surveys2/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your surveys and results Full, @@ -72,12 +72,12 @@ impl Default for Scope { /// use std::default::Default; /// use surveys2::{Surveys, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/surveys2/src/lib.rs b/gen/surveys2/src/lib.rs index 922a52165b..d29a219a17 100644 --- a/gen/surveys2/src/lib.rs +++ b/gen/surveys2/src/lib.rs @@ -6,7 +6,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/surveys2). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Surveys) ... +//! Handle the following *Resources* with ease from the central [hub](Surveys) ... //! //! * results //! * [*get*](api::ResultGetCall) @@ -59,8 +59,8 @@ //! let r = hub.surveys().update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -88,12 +88,12 @@ //! use std::default::Default; //! use surveys2::{Surveys, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -132,10 +132,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -145,25 +145,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/tagmanager1/README.md b/gen/tagmanager1/README.md index d577bcb4cc..543a4de0b3 100644 --- a/gen/tagmanager1/README.md +++ b/gen/tagmanager1/README.md @@ -11,7 +11,7 @@ Everything else about the *Tag Manager* *v1* API can be found at the [official documentation site](https://developers.google.com/tag-manager). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/TagManager) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/TagManager) ... * [accounts](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::Account) * [*containers create*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountContainerCreateCall), [*containers delete*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountContainerDeleteCall), [*containers environments create*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountContainerEnvironmentCreateCall), [*containers environments delete*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountContainerEnvironmentDeleteCall), [*containers environments get*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountContainerEnvironmentGetCall), [*containers environments list*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountContainerEnvironmentListCall), [*containers environments update*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountContainerEnvironmentUpdateCall), [*containers folders create*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountContainerFolderCreateCall), [*containers folders delete*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountContainerFolderDeleteCall), [*containers folders entities list*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountContainerFolderEntityListCall), [*containers folders get*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountContainerFolderGetCall), [*containers folders list*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountContainerFolderListCall), [*containers folders update*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountContainerFolderUpdateCall), [*containers get*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountContainerGetCall), [*containers list*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountContainerListCall), [*containers move_folders update*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountContainerMoveFolderUpdateCall), [*containers reauthorize_environments update*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountContainerReauthorizeEnvironmentUpdateCall), [*containers tags create*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountContainerTagCreateCall), [*containers tags delete*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountContainerTagDeleteCall), [*containers tags get*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountContainerTagGetCall), [*containers tags list*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountContainerTagListCall), [*containers tags update*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountContainerTagUpdateCall), [*containers triggers create*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountContainerTriggerCreateCall), [*containers triggers delete*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountContainerTriggerDeleteCall), [*containers triggers get*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountContainerTriggerGetCall), [*containers triggers list*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountContainerTriggerListCall), [*containers triggers update*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountContainerTriggerUpdateCall), [*containers update*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountContainerUpdateCall), [*containers variables create*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountContainerVariableCreateCall), [*containers variables delete*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountContainerVariableDeleteCall), [*containers variables get*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountContainerVariableGetCall), [*containers variables list*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountContainerVariableListCall), [*containers variables update*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountContainerVariableUpdateCall), [*containers versions create*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountContainerVersionCreateCall), [*containers versions delete*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountContainerVersionDeleteCall), [*containers versions get*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountContainerVersionGetCall), [*containers versions list*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountContainerVersionListCall), [*containers versions publish*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountContainerVersionPublishCall), [*containers versions restore*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountContainerVersionRestoreCall), [*containers versions undelete*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountContainerVersionUndeleteCall), [*containers versions update*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountContainerVersionUpdateCall), [*get*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountGetCall), [*list*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountListCall), [*permissions create*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountPermissionCreateCall), [*permissions delete*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountPermissionDeleteCall), [*permissions get*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountPermissionGetCall), [*permissions list*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountPermissionListCall), [*permissions update*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountPermissionUpdateCall) and [*update*](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/api::AccountUpdateCall) @@ -98,8 +98,8 @@ let r = hub.accounts().list(...).doit().await let r = hub.accounts().update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -127,12 +127,12 @@ use tagmanager1::{Result, Error}; use std::default::Default; use tagmanager1::{TagManager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -176,10 +176,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -189,25 +189,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-tagman You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/client::Delegate) to the -[Method Builder](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/client::Delegate) to the +[Method Builder](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/client::RequestValue) and -[decodable](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/client::RequestValue) and +[decodable](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-tagmanager1/5.0.3+20230123/google_tagmanager1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -226,7 +226,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **tagmanager1** library was generated by Sebastian Thiel, and is placed +The **tagmanager1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/tagmanager1/src/api.rs b/gen/tagmanager1/src/api.rs index c5081aa68a..7abd10f1ae 100644 --- a/gen/tagmanager1/src/api.rs +++ b/gen/tagmanager1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// Delete your Google Tag Manager containers DeleteContainer, @@ -89,12 +89,12 @@ impl Default for Scope { /// use std::default::Default; /// use tagmanager1::{TagManager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/tagmanager1/src/lib.rs b/gen/tagmanager1/src/lib.rs index 639260e4a1..cc0ee63fa0 100644 --- a/gen/tagmanager1/src/lib.rs +++ b/gen/tagmanager1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/tagmanager1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](TagManager) ... +//! Handle the following *Resources* with ease from the central [hub](TagManager) ... //! //! * [accounts](api::Account) //! * [*containers create*](api::AccountContainerCreateCall), [*containers delete*](api::AccountContainerDeleteCall), [*containers environments create*](api::AccountContainerEnvironmentCreateCall), [*containers environments delete*](api::AccountContainerEnvironmentDeleteCall), [*containers environments get*](api::AccountContainerEnvironmentGetCall), [*containers environments list*](api::AccountContainerEnvironmentListCall), [*containers environments update*](api::AccountContainerEnvironmentUpdateCall), [*containers folders create*](api::AccountContainerFolderCreateCall), [*containers folders delete*](api::AccountContainerFolderDeleteCall), [*containers folders entities list*](api::AccountContainerFolderEntityListCall), [*containers folders get*](api::AccountContainerFolderGetCall), [*containers folders list*](api::AccountContainerFolderListCall), [*containers folders update*](api::AccountContainerFolderUpdateCall), [*containers get*](api::AccountContainerGetCall), [*containers list*](api::AccountContainerListCall), [*containers move_folders update*](api::AccountContainerMoveFolderUpdateCall), [*containers reauthorize_environments update*](api::AccountContainerReauthorizeEnvironmentUpdateCall), [*containers tags create*](api::AccountContainerTagCreateCall), [*containers tags delete*](api::AccountContainerTagDeleteCall), [*containers tags get*](api::AccountContainerTagGetCall), [*containers tags list*](api::AccountContainerTagListCall), [*containers tags update*](api::AccountContainerTagUpdateCall), [*containers triggers create*](api::AccountContainerTriggerCreateCall), [*containers triggers delete*](api::AccountContainerTriggerDeleteCall), [*containers triggers get*](api::AccountContainerTriggerGetCall), [*containers triggers list*](api::AccountContainerTriggerListCall), [*containers triggers update*](api::AccountContainerTriggerUpdateCall), [*containers update*](api::AccountContainerUpdateCall), [*containers variables create*](api::AccountContainerVariableCreateCall), [*containers variables delete*](api::AccountContainerVariableDeleteCall), [*containers variables get*](api::AccountContainerVariableGetCall), [*containers variables list*](api::AccountContainerVariableListCall), [*containers variables update*](api::AccountContainerVariableUpdateCall), [*containers versions create*](api::AccountContainerVersionCreateCall), [*containers versions delete*](api::AccountContainerVersionDeleteCall), [*containers versions get*](api::AccountContainerVersionGetCall), [*containers versions list*](api::AccountContainerVersionListCall), [*containers versions publish*](api::AccountContainerVersionPublishCall), [*containers versions restore*](api::AccountContainerVersionRestoreCall), [*containers versions undelete*](api::AccountContainerVersionUndeleteCall), [*containers versions update*](api::AccountContainerVersionUpdateCall), [*get*](api::AccountGetCall), [*list*](api::AccountListCall), [*permissions create*](api::AccountPermissionCreateCall), [*permissions delete*](api::AccountPermissionDeleteCall), [*permissions get*](api::AccountPermissionGetCall), [*permissions list*](api::AccountPermissionListCall), [*permissions update*](api::AccountPermissionUpdateCall) and [*update*](api::AccountUpdateCall) @@ -98,8 +98,8 @@ //! let r = hub.accounts().update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -128,12 +128,12 @@ //! use std::default::Default; //! use tagmanager1::{TagManager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -177,10 +177,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -190,25 +190,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/tagmanager2/README.md b/gen/tagmanager2/README.md index 94e3c3783d..d1a039d493 100644 --- a/gen/tagmanager2/README.md +++ b/gen/tagmanager2/README.md @@ -11,7 +11,7 @@ Everything else about the *Tag Manager* *v2* API can be found at the [official documentation site](https://developers.google.com/tag-manager). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/TagManager) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/TagManager) ... * [accounts](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::Account) * [*containers combine*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerCombineCall), [*containers create*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerCreateCall), [*containers delete*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerDeleteCall), [*containers destinations get*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerDestinationGetCall), [*containers destinations link*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerDestinationLinkCall), [*containers destinations list*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerDestinationListCall), [*containers environments create*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerEnvironmentCreateCall), [*containers environments delete*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerEnvironmentDeleteCall), [*containers environments get*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerEnvironmentGetCall), [*containers environments list*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerEnvironmentListCall), [*containers environments reauthorize*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerEnvironmentReauthorizeCall), [*containers environments update*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerEnvironmentUpdateCall), [*containers get*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerGetCall), [*containers list*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerListCall), [*containers lookup*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerLookupCall), [*containers move_tag_id*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerMoveTagIdCall), [*containers snippet*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerSnippetCall), [*containers update*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerUpdateCall), [*containers version_headers latest*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerVersionHeaderLatestCall), [*containers version_headers list*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerVersionHeaderListCall), [*containers versions delete*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerVersionDeleteCall), [*containers versions get*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerVersionGetCall), [*containers versions live*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerVersionLiveCall), [*containers versions publish*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerVersionPublishCall), [*containers versions set_latest*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerVersionSetLatestCall), [*containers versions undelete*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerVersionUndeleteCall), [*containers versions update*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerVersionUpdateCall), [*containers workspaces built_in_variables create*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceBuiltInVariableCreateCall), [*containers workspaces built_in_variables delete*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceBuiltInVariableDeleteCall), [*containers workspaces built_in_variables list*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceBuiltInVariableListCall), [*containers workspaces built_in_variables revert*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceBuiltInVariableRevertCall), [*containers workspaces clients create*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceClientCreateCall), [*containers workspaces clients delete*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceClientDeleteCall), [*containers workspaces clients get*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceClientGetCall), [*containers workspaces clients list*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceClientListCall), [*containers workspaces clients revert*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceClientRevertCall), [*containers workspaces clients update*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceClientUpdateCall), [*containers workspaces create*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceCreateCall), [*containers workspaces create_version*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceCreateVersionCall), [*containers workspaces delete*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceDeleteCall), [*containers workspaces folders create*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceFolderCreateCall), [*containers workspaces folders delete*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceFolderDeleteCall), [*containers workspaces folders entities*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceFolderEntityCall), [*containers workspaces folders get*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceFolderGetCall), [*containers workspaces folders list*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceFolderListCall), [*containers workspaces folders move_entities_to_folder*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceFolderMoveEntitiesToFolderCall), [*containers workspaces folders revert*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceFolderRevertCall), [*containers workspaces folders update*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceFolderUpdateCall), [*containers workspaces get*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceGetCall), [*containers workspaces get status*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceGetStatuCall), [*containers workspaces gtag_config create*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceGtagConfigCreateCall), [*containers workspaces gtag_config delete*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceGtagConfigDeleteCall), [*containers workspaces gtag_config get*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceGtagConfigGetCall), [*containers workspaces gtag_config list*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceGtagConfigListCall), [*containers workspaces gtag_config update*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceGtagConfigUpdateCall), [*containers workspaces list*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceListCall), [*containers workspaces quick_preview*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceQuickPreviewCall), [*containers workspaces resolve_conflict*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceResolveConflictCall), [*containers workspaces sync*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceSyncCall), [*containers workspaces tags create*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceTagCreateCall), [*containers workspaces tags delete*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceTagDeleteCall), [*containers workspaces tags get*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceTagGetCall), [*containers workspaces tags list*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceTagListCall), [*containers workspaces tags revert*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceTagRevertCall), [*containers workspaces tags update*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceTagUpdateCall), [*containers workspaces templates create*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceTemplateCreateCall), [*containers workspaces templates delete*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceTemplateDeleteCall), [*containers workspaces templates get*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceTemplateGetCall), [*containers workspaces templates list*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceTemplateListCall), [*containers workspaces templates revert*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceTemplateRevertCall), [*containers workspaces templates update*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceTemplateUpdateCall), [*containers workspaces triggers create*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceTriggerCreateCall), [*containers workspaces triggers delete*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceTriggerDeleteCall), [*containers workspaces triggers get*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceTriggerGetCall), [*containers workspaces triggers list*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceTriggerListCall), [*containers workspaces triggers revert*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceTriggerRevertCall), [*containers workspaces triggers update*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceTriggerUpdateCall), [*containers workspaces update*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceUpdateCall), [*containers workspaces variables create*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceVariableCreateCall), [*containers workspaces variables delete*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceVariableDeleteCall), [*containers workspaces variables get*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceVariableGetCall), [*containers workspaces variables list*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceVariableListCall), [*containers workspaces variables revert*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceVariableRevertCall), [*containers workspaces variables update*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceVariableUpdateCall), [*containers workspaces zones create*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceZoneCreateCall), [*containers workspaces zones delete*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceZoneDeleteCall), [*containers workspaces zones get*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceZoneGetCall), [*containers workspaces zones list*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceZoneListCall), [*containers workspaces zones revert*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceZoneRevertCall), [*containers workspaces zones update*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountContainerWorkspaceZoneUpdateCall), [*get*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountGetCall), [*list*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountListCall), [*update*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountUpdateCall), [*user_permissions create*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountUserPermissionCreateCall), [*user_permissions delete*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountUserPermissionDeleteCall), [*user_permissions get*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountUserPermissionGetCall), [*user_permissions list*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountUserPermissionListCall) and [*user_permissions update*](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/api::AccountUserPermissionUpdateCall) @@ -147,8 +147,8 @@ let r = hub.accounts().list(...).doit().await let r = hub.accounts().update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -175,12 +175,12 @@ use tagmanager2::{Result, Error}; use std::default::Default; use tagmanager2::{TagManager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -222,10 +222,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -235,25 +235,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-tagman You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/client::Delegate) to the -[Method Builder](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/client::Delegate) to the +[Method Builder](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/client::RequestValue) and -[decodable](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/client::RequestValue) and +[decodable](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-tagmanager2/5.0.3+20230123/google_tagmanager2/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -272,7 +272,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **tagmanager2** library was generated by Sebastian Thiel, and is placed +The **tagmanager2** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/tagmanager2/src/api.rs b/gen/tagmanager2/src/api.rs index abdcd1ad53..93f4891027 100644 --- a/gen/tagmanager2/src/api.rs +++ b/gen/tagmanager2/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// Delete your Google Tag Manager containers DeleteContainer, @@ -88,12 +88,12 @@ impl Default for Scope { /// use std::default::Default; /// use tagmanager2::{TagManager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/tagmanager2/src/lib.rs b/gen/tagmanager2/src/lib.rs index 8845efc781..c378111fce 100644 --- a/gen/tagmanager2/src/lib.rs +++ b/gen/tagmanager2/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/tagmanager2). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](TagManager) ... +//! Handle the following *Resources* with ease from the central [hub](TagManager) ... //! //! * [accounts](api::Account) //! * [*containers combine*](api::AccountContainerCombineCall), [*containers create*](api::AccountContainerCreateCall), [*containers delete*](api::AccountContainerDeleteCall), [*containers destinations get*](api::AccountContainerDestinationGetCall), [*containers destinations link*](api::AccountContainerDestinationLinkCall), [*containers destinations list*](api::AccountContainerDestinationListCall), [*containers environments create*](api::AccountContainerEnvironmentCreateCall), [*containers environments delete*](api::AccountContainerEnvironmentDeleteCall), [*containers environments get*](api::AccountContainerEnvironmentGetCall), [*containers environments list*](api::AccountContainerEnvironmentListCall), [*containers environments reauthorize*](api::AccountContainerEnvironmentReauthorizeCall), [*containers environments update*](api::AccountContainerEnvironmentUpdateCall), [*containers get*](api::AccountContainerGetCall), [*containers list*](api::AccountContainerListCall), [*containers lookup*](api::AccountContainerLookupCall), [*containers move_tag_id*](api::AccountContainerMoveTagIdCall), [*containers snippet*](api::AccountContainerSnippetCall), [*containers update*](api::AccountContainerUpdateCall), [*containers version_headers latest*](api::AccountContainerVersionHeaderLatestCall), [*containers version_headers list*](api::AccountContainerVersionHeaderListCall), [*containers versions delete*](api::AccountContainerVersionDeleteCall), [*containers versions get*](api::AccountContainerVersionGetCall), [*containers versions live*](api::AccountContainerVersionLiveCall), [*containers versions publish*](api::AccountContainerVersionPublishCall), [*containers versions set_latest*](api::AccountContainerVersionSetLatestCall), [*containers versions undelete*](api::AccountContainerVersionUndeleteCall), [*containers versions update*](api::AccountContainerVersionUpdateCall), [*containers workspaces built_in_variables create*](api::AccountContainerWorkspaceBuiltInVariableCreateCall), [*containers workspaces built_in_variables delete*](api::AccountContainerWorkspaceBuiltInVariableDeleteCall), [*containers workspaces built_in_variables list*](api::AccountContainerWorkspaceBuiltInVariableListCall), [*containers workspaces built_in_variables revert*](api::AccountContainerWorkspaceBuiltInVariableRevertCall), [*containers workspaces clients create*](api::AccountContainerWorkspaceClientCreateCall), [*containers workspaces clients delete*](api::AccountContainerWorkspaceClientDeleteCall), [*containers workspaces clients get*](api::AccountContainerWorkspaceClientGetCall), [*containers workspaces clients list*](api::AccountContainerWorkspaceClientListCall), [*containers workspaces clients revert*](api::AccountContainerWorkspaceClientRevertCall), [*containers workspaces clients update*](api::AccountContainerWorkspaceClientUpdateCall), [*containers workspaces create*](api::AccountContainerWorkspaceCreateCall), [*containers workspaces create_version*](api::AccountContainerWorkspaceCreateVersionCall), [*containers workspaces delete*](api::AccountContainerWorkspaceDeleteCall), [*containers workspaces folders create*](api::AccountContainerWorkspaceFolderCreateCall), [*containers workspaces folders delete*](api::AccountContainerWorkspaceFolderDeleteCall), [*containers workspaces folders entities*](api::AccountContainerWorkspaceFolderEntityCall), [*containers workspaces folders get*](api::AccountContainerWorkspaceFolderGetCall), [*containers workspaces folders list*](api::AccountContainerWorkspaceFolderListCall), [*containers workspaces folders move_entities_to_folder*](api::AccountContainerWorkspaceFolderMoveEntitiesToFolderCall), [*containers workspaces folders revert*](api::AccountContainerWorkspaceFolderRevertCall), [*containers workspaces folders update*](api::AccountContainerWorkspaceFolderUpdateCall), [*containers workspaces get*](api::AccountContainerWorkspaceGetCall), [*containers workspaces get status*](api::AccountContainerWorkspaceGetStatuCall), [*containers workspaces gtag_config create*](api::AccountContainerWorkspaceGtagConfigCreateCall), [*containers workspaces gtag_config delete*](api::AccountContainerWorkspaceGtagConfigDeleteCall), [*containers workspaces gtag_config get*](api::AccountContainerWorkspaceGtagConfigGetCall), [*containers workspaces gtag_config list*](api::AccountContainerWorkspaceGtagConfigListCall), [*containers workspaces gtag_config update*](api::AccountContainerWorkspaceGtagConfigUpdateCall), [*containers workspaces list*](api::AccountContainerWorkspaceListCall), [*containers workspaces quick_preview*](api::AccountContainerWorkspaceQuickPreviewCall), [*containers workspaces resolve_conflict*](api::AccountContainerWorkspaceResolveConflictCall), [*containers workspaces sync*](api::AccountContainerWorkspaceSyncCall), [*containers workspaces tags create*](api::AccountContainerWorkspaceTagCreateCall), [*containers workspaces tags delete*](api::AccountContainerWorkspaceTagDeleteCall), [*containers workspaces tags get*](api::AccountContainerWorkspaceTagGetCall), [*containers workspaces tags list*](api::AccountContainerWorkspaceTagListCall), [*containers workspaces tags revert*](api::AccountContainerWorkspaceTagRevertCall), [*containers workspaces tags update*](api::AccountContainerWorkspaceTagUpdateCall), [*containers workspaces templates create*](api::AccountContainerWorkspaceTemplateCreateCall), [*containers workspaces templates delete*](api::AccountContainerWorkspaceTemplateDeleteCall), [*containers workspaces templates get*](api::AccountContainerWorkspaceTemplateGetCall), [*containers workspaces templates list*](api::AccountContainerWorkspaceTemplateListCall), [*containers workspaces templates revert*](api::AccountContainerWorkspaceTemplateRevertCall), [*containers workspaces templates update*](api::AccountContainerWorkspaceTemplateUpdateCall), [*containers workspaces triggers create*](api::AccountContainerWorkspaceTriggerCreateCall), [*containers workspaces triggers delete*](api::AccountContainerWorkspaceTriggerDeleteCall), [*containers workspaces triggers get*](api::AccountContainerWorkspaceTriggerGetCall), [*containers workspaces triggers list*](api::AccountContainerWorkspaceTriggerListCall), [*containers workspaces triggers revert*](api::AccountContainerWorkspaceTriggerRevertCall), [*containers workspaces triggers update*](api::AccountContainerWorkspaceTriggerUpdateCall), [*containers workspaces update*](api::AccountContainerWorkspaceUpdateCall), [*containers workspaces variables create*](api::AccountContainerWorkspaceVariableCreateCall), [*containers workspaces variables delete*](api::AccountContainerWorkspaceVariableDeleteCall), [*containers workspaces variables get*](api::AccountContainerWorkspaceVariableGetCall), [*containers workspaces variables list*](api::AccountContainerWorkspaceVariableListCall), [*containers workspaces variables revert*](api::AccountContainerWorkspaceVariableRevertCall), [*containers workspaces variables update*](api::AccountContainerWorkspaceVariableUpdateCall), [*containers workspaces zones create*](api::AccountContainerWorkspaceZoneCreateCall), [*containers workspaces zones delete*](api::AccountContainerWorkspaceZoneDeleteCall), [*containers workspaces zones get*](api::AccountContainerWorkspaceZoneGetCall), [*containers workspaces zones list*](api::AccountContainerWorkspaceZoneListCall), [*containers workspaces zones revert*](api::AccountContainerWorkspaceZoneRevertCall), [*containers workspaces zones update*](api::AccountContainerWorkspaceZoneUpdateCall), [*get*](api::AccountGetCall), [*list*](api::AccountListCall), [*update*](api::AccountUpdateCall), [*user_permissions create*](api::AccountUserPermissionCreateCall), [*user_permissions delete*](api::AccountUserPermissionDeleteCall), [*user_permissions get*](api::AccountUserPermissionGetCall), [*user_permissions list*](api::AccountUserPermissionListCall) and [*user_permissions update*](api::AccountUserPermissionUpdateCall) @@ -147,8 +147,8 @@ //! let r = hub.accounts().update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -176,12 +176,12 @@ //! use std::default::Default; //! use tagmanager2::{TagManager, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -223,10 +223,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -236,25 +236,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/taskqueue1_beta2/README.md b/gen/taskqueue1_beta2/README.md index 4c9eafbdcf..a17392152a 100644 --- a/gen/taskqueue1_beta2/README.md +++ b/gen/taskqueue1_beta2/README.md @@ -11,7 +11,7 @@ Everything else about the *taskqueue* *v1_beta2* API can be found at the [official documentation site](https://developers.google.com/appengine/docs/python/taskqueue/rest). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-taskqueue1_beta2/5.0.3+20160428/google_taskqueue1_beta2/Taskqueue) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-taskqueue1_beta2/5.0.3+20160428/google_taskqueue1_beta2/Taskqueue) ... * taskqueues * [*get*](https://docs.rs/google-taskqueue1_beta2/5.0.3+20160428/google_taskqueue1_beta2/api::TaskqueueGetCall) @@ -58,8 +58,8 @@ let r = hub.tasks().patch(...).doit().await let r = hub.tasks().update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -86,12 +86,12 @@ use taskqueue1_beta2::{Result, Error}; use std::default::Default; use taskqueue1_beta2::{Taskqueue, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -129,10 +129,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-taskqueue1_beta2/5.0.3+20160428/google_taskqueue1_beta2/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-taskqueue1_beta2/5.0.3+20160428/google_taskqueue1_beta2/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -142,25 +142,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-taskqu You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-taskqueue1_beta2/5.0.3+20160428/google_taskqueue1_beta2/client::Delegate) to the -[Method Builder](https://docs.rs/google-taskqueue1_beta2/5.0.3+20160428/google_taskqueue1_beta2/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-taskqueue1_beta2/5.0.3+20160428/google_taskqueue1_beta2/client::Delegate) to the +[Method Builder](https://docs.rs/google-taskqueue1_beta2/5.0.3+20160428/google_taskqueue1_beta2/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-taskqueue1_beta2/5.0.3+20160428/google_taskqueue1_beta2/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-taskqueue1_beta2/5.0.3+20160428/google_taskqueue1_beta2/client::RequestValue) and -[decodable](https://docs.rs/google-taskqueue1_beta2/5.0.3+20160428/google_taskqueue1_beta2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-taskqueue1_beta2/5.0.3+20160428/google_taskqueue1_beta2/client::RequestValue) and +[decodable](https://docs.rs/google-taskqueue1_beta2/5.0.3+20160428/google_taskqueue1_beta2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-taskqueue1_beta2/5.0.3+20160428/google_taskqueue1_beta2/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-taskqueue1_beta2/5.0.3+20160428/google_taskqueue1_beta2/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -179,7 +179,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **taskqueue1_beta2** library was generated by Sebastian Thiel, and is placed +The **taskqueue1_beta2** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/taskqueue1_beta2/src/api.rs b/gen/taskqueue1_beta2/src/api.rs index 392d42b7b5..818db22d60 100644 --- a/gen/taskqueue1_beta2/src/api.rs +++ b/gen/taskqueue1_beta2/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// Manage your Tasks and Taskqueues Full, @@ -68,12 +68,12 @@ impl Default for Scope { /// use std::default::Default; /// use taskqueue1_beta2::{Taskqueue, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/taskqueue1_beta2/src/lib.rs b/gen/taskqueue1_beta2/src/lib.rs index dac013f6be..4a6ba5915e 100644 --- a/gen/taskqueue1_beta2/src/lib.rs +++ b/gen/taskqueue1_beta2/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/taskqueue1_beta2). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Taskqueue) ... +//! Handle the following *Resources* with ease from the central [hub](Taskqueue) ... //! //! * taskqueues //! * [*get*](api::TaskqueueGetCall) @@ -58,8 +58,8 @@ //! let r = hub.tasks().update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -87,12 +87,12 @@ //! use std::default::Default; //! use taskqueue1_beta2::{Taskqueue, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -130,10 +130,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -143,25 +143,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/tasks1/README.md b/gen/tasks1/README.md index 8c53baedc6..84f1d050ad 100644 --- a/gen/tasks1/README.md +++ b/gen/tasks1/README.md @@ -11,7 +11,7 @@ Everything else about the *Tasks* *v1* API can be found at the [official documentation site](https://developers.google.com/tasks/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-tasks1/5.0.3+20230122/google_tasks1/TasksHub) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-tasks1/5.0.3+20230122/google_tasks1/TasksHub) ... * tasklists * [*delete*](https://docs.rs/google-tasks1/5.0.3+20230122/google_tasks1/api::TasklistDeleteCall), [*get*](https://docs.rs/google-tasks1/5.0.3+20230122/google_tasks1/api::TasklistGetCall), [*insert*](https://docs.rs/google-tasks1/5.0.3+20230122/google_tasks1/api::TasklistInsertCall), [*list*](https://docs.rs/google-tasks1/5.0.3+20230122/google_tasks1/api::TasklistListCall), [*patch*](https://docs.rs/google-tasks1/5.0.3+20230122/google_tasks1/api::TasklistPatchCall) and [*update*](https://docs.rs/google-tasks1/5.0.3+20230122/google_tasks1/api::TasklistUpdateCall) @@ -59,8 +59,8 @@ let r = hub.tasks().patch(...).doit().await let r = hub.tasks().update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -87,12 +87,12 @@ use tasks1::{Result, Error}; use std::default::Default; use tasks1::{TasksHub, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -138,10 +138,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-tasks1/5.0.3+20230122/google_tasks1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-tasks1/5.0.3+20230122/google_tasks1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -151,25 +151,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-tasks1 You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-tasks1/5.0.3+20230122/google_tasks1/client::Delegate) to the -[Method Builder](https://docs.rs/google-tasks1/5.0.3+20230122/google_tasks1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-tasks1/5.0.3+20230122/google_tasks1/client::Delegate) to the +[Method Builder](https://docs.rs/google-tasks1/5.0.3+20230122/google_tasks1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-tasks1/5.0.3+20230122/google_tasks1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-tasks1/5.0.3+20230122/google_tasks1/client::RequestValue) and -[decodable](https://docs.rs/google-tasks1/5.0.3+20230122/google_tasks1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-tasks1/5.0.3+20230122/google_tasks1/client::RequestValue) and +[decodable](https://docs.rs/google-tasks1/5.0.3+20230122/google_tasks1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-tasks1/5.0.3+20230122/google_tasks1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-tasks1/5.0.3+20230122/google_tasks1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -188,7 +188,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **tasks1** library was generated by Sebastian Thiel, and is placed +The **tasks1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/tasks1/src/api.rs b/gen/tasks1/src/api.rs index 13392706cb..9d14425d99 100644 --- a/gen/tasks1/src/api.rs +++ b/gen/tasks1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// Create, edit, organize, and delete all your tasks Full, @@ -68,12 +68,12 @@ impl Default for Scope { /// use std::default::Default; /// use tasks1::{TasksHub, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/tasks1/src/lib.rs b/gen/tasks1/src/lib.rs index 123416fa3b..cb8cce8b3c 100644 --- a/gen/tasks1/src/lib.rs +++ b/gen/tasks1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/tasks1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](TasksHub) ... +//! Handle the following *Resources* with ease from the central [hub](TasksHub) ... //! //! * tasklists //! * [*delete*](api::TasklistDeleteCall), [*get*](api::TasklistGetCall), [*insert*](api::TasklistInsertCall), [*list*](api::TasklistListCall), [*patch*](api::TasklistPatchCall) and [*update*](api::TasklistUpdateCall) @@ -59,8 +59,8 @@ //! let r = hub.tasks().update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -88,12 +88,12 @@ //! use std::default::Default; //! use tasks1::{TasksHub, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -139,10 +139,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -152,25 +152,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/testing1/README.md b/gen/testing1/README.md index 7111efc864..808938817e 100644 --- a/gen/testing1/README.md +++ b/gen/testing1/README.md @@ -11,7 +11,7 @@ Everything else about the *testing* *v1* API can be found at the [official documentation site](https://developers.google.com/cloud-test-lab/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-testing1/5.0.3+20230119/google_testing1/Testing) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-testing1/5.0.3+20230119/google_testing1/Testing) ... * application detail service * [*get apk details*](https://docs.rs/google-testing1/5.0.3+20230119/google_testing1/api::ApplicationDetailServiceGetApkDetailCall) @@ -55,8 +55,8 @@ let r = hub.projects().test_matrices_create(...).doit().await let r = hub.projects().test_matrices_get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -84,12 +84,12 @@ use testing1::{Result, Error}; use std::default::Default; use testing1::{Testing, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -131,10 +131,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-testing1/5.0.3+20230119/google_testing1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-testing1/5.0.3+20230119/google_testing1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -144,25 +144,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-testin You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-testing1/5.0.3+20230119/google_testing1/client::Delegate) to the -[Method Builder](https://docs.rs/google-testing1/5.0.3+20230119/google_testing1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-testing1/5.0.3+20230119/google_testing1/client::Delegate) to the +[Method Builder](https://docs.rs/google-testing1/5.0.3+20230119/google_testing1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-testing1/5.0.3+20230119/google_testing1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-testing1/5.0.3+20230119/google_testing1/client::RequestValue) and -[decodable](https://docs.rs/google-testing1/5.0.3+20230119/google_testing1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-testing1/5.0.3+20230119/google_testing1/client::RequestValue) and +[decodable](https://docs.rs/google-testing1/5.0.3+20230119/google_testing1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-testing1/5.0.3+20230119/google_testing1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-testing1/5.0.3+20230119/google_testing1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -181,7 +181,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **testing1** library was generated by Sebastian Thiel, and is placed +The **testing1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/testing1/src/api.rs b/gen/testing1/src/api.rs index 20c84d74b7..38d9f52e84 100644 --- a/gen/testing1/src/api.rs +++ b/gen/testing1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use testing1::{Testing, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/testing1/src/lib.rs b/gen/testing1/src/lib.rs index 60fb533646..e5f6cb299a 100644 --- a/gen/testing1/src/lib.rs +++ b/gen/testing1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/testing1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Testing) ... +//! Handle the following *Resources* with ease from the central [hub](Testing) ... //! //! * application detail service //! * [*get apk details*](api::ApplicationDetailServiceGetApkDetailCall) @@ -55,8 +55,8 @@ //! let r = hub.projects().test_matrices_get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -85,12 +85,12 @@ //! use std::default::Default; //! use testing1::{Testing, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -132,10 +132,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -145,25 +145,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/texttospeech1/README.md b/gen/texttospeech1/README.md index b53bbb742c..7b8c39ed8d 100644 --- a/gen/texttospeech1/README.md +++ b/gen/texttospeech1/README.md @@ -11,7 +11,7 @@ Everything else about the *Texttospeech* *v1* API can be found at the [official documentation site](https://cloud.google.com/text-to-speech/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-texttospeech1/5.0.3+20230118/google_texttospeech1/Texttospeech) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-texttospeech1/5.0.3+20230118/google_texttospeech1/Texttospeech) ... * [operations](https://docs.rs/google-texttospeech1/5.0.3+20230118/google_texttospeech1/api::Operation) * [*cancel*](https://docs.rs/google-texttospeech1/5.0.3+20230118/google_texttospeech1/api::OperationCancelCall) and [*delete*](https://docs.rs/google-texttospeech1/5.0.3+20230118/google_texttospeech1/api::OperationDeleteCall) @@ -59,8 +59,8 @@ let r = hub.projects().locations_operations_get(...).doit().await let r = hub.projects().locations_synthesize_long_audio(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -88,12 +88,12 @@ use texttospeech1::{Result, Error}; use std::default::Default; use texttospeech1::{Texttospeech, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -134,10 +134,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-texttospeech1/5.0.3+20230118/google_texttospeech1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-texttospeech1/5.0.3+20230118/google_texttospeech1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -147,25 +147,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-textto You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-texttospeech1/5.0.3+20230118/google_texttospeech1/client::Delegate) to the -[Method Builder](https://docs.rs/google-texttospeech1/5.0.3+20230118/google_texttospeech1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-texttospeech1/5.0.3+20230118/google_texttospeech1/client::Delegate) to the +[Method Builder](https://docs.rs/google-texttospeech1/5.0.3+20230118/google_texttospeech1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-texttospeech1/5.0.3+20230118/google_texttospeech1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-texttospeech1/5.0.3+20230118/google_texttospeech1/client::RequestValue) and -[decodable](https://docs.rs/google-texttospeech1/5.0.3+20230118/google_texttospeech1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-texttospeech1/5.0.3+20230118/google_texttospeech1/client::RequestValue) and +[decodable](https://docs.rs/google-texttospeech1/5.0.3+20230118/google_texttospeech1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-texttospeech1/5.0.3+20230118/google_texttospeech1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-texttospeech1/5.0.3+20230118/google_texttospeech1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -184,7 +184,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **texttospeech1** library was generated by Sebastian Thiel, and is placed +The **texttospeech1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/texttospeech1/src/api.rs b/gen/texttospeech1/src/api.rs index d1261aeebf..8ab30f5a43 100644 --- a/gen/texttospeech1/src/api.rs +++ b/gen/texttospeech1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use texttospeech1::{Texttospeech, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/texttospeech1/src/lib.rs b/gen/texttospeech1/src/lib.rs index 6918f925f4..69ec6363ad 100644 --- a/gen/texttospeech1/src/lib.rs +++ b/gen/texttospeech1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/texttospeech1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Texttospeech) ... +//! Handle the following *Resources* with ease from the central [hub](Texttospeech) ... //! //! * [operations](api::Operation) //! * [*cancel*](api::OperationCancelCall) and [*delete*](api::OperationDeleteCall) @@ -59,8 +59,8 @@ //! let r = hub.projects().locations_synthesize_long_audio(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -89,12 +89,12 @@ //! use std::default::Default; //! use texttospeech1::{Texttospeech, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -135,10 +135,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -148,25 +148,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/tpu1/README.md b/gen/tpu1/README.md index 9a2a90ec1c..8a89f42c02 100644 --- a/gen/tpu1/README.md +++ b/gen/tpu1/README.md @@ -11,7 +11,7 @@ Everything else about the *TPU* *v1* API can be found at the [official documentation site](https://cloud.google.com/tpu/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-tpu1/5.0.3+20230105/google_tpu1/TPU) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-tpu1/5.0.3+20230105/google_tpu1/TPU) ... * projects * [*locations accelerator types get*](https://docs.rs/google-tpu1/5.0.3+20230105/google_tpu1/api::ProjectLocationAcceleratorTypeGetCall), [*locations accelerator types list*](https://docs.rs/google-tpu1/5.0.3+20230105/google_tpu1/api::ProjectLocationAcceleratorTypeListCall), [*locations get*](https://docs.rs/google-tpu1/5.0.3+20230105/google_tpu1/api::ProjectLocationGetCall), [*locations list*](https://docs.rs/google-tpu1/5.0.3+20230105/google_tpu1/api::ProjectLocationListCall), [*locations nodes create*](https://docs.rs/google-tpu1/5.0.3+20230105/google_tpu1/api::ProjectLocationNodeCreateCall), [*locations nodes delete*](https://docs.rs/google-tpu1/5.0.3+20230105/google_tpu1/api::ProjectLocationNodeDeleteCall), [*locations nodes get*](https://docs.rs/google-tpu1/5.0.3+20230105/google_tpu1/api::ProjectLocationNodeGetCall), [*locations nodes list*](https://docs.rs/google-tpu1/5.0.3+20230105/google_tpu1/api::ProjectLocationNodeListCall), [*locations nodes reimage*](https://docs.rs/google-tpu1/5.0.3+20230105/google_tpu1/api::ProjectLocationNodeReimageCall), [*locations nodes start*](https://docs.rs/google-tpu1/5.0.3+20230105/google_tpu1/api::ProjectLocationNodeStartCall), [*locations nodes stop*](https://docs.rs/google-tpu1/5.0.3+20230105/google_tpu1/api::ProjectLocationNodeStopCall), [*locations operations cancel*](https://docs.rs/google-tpu1/5.0.3+20230105/google_tpu1/api::ProjectLocationOperationCancelCall), [*locations operations delete*](https://docs.rs/google-tpu1/5.0.3+20230105/google_tpu1/api::ProjectLocationOperationDeleteCall), [*locations operations get*](https://docs.rs/google-tpu1/5.0.3+20230105/google_tpu1/api::ProjectLocationOperationGetCall), [*locations operations list*](https://docs.rs/google-tpu1/5.0.3+20230105/google_tpu1/api::ProjectLocationOperationListCall), [*locations tensorflow versions get*](https://docs.rs/google-tpu1/5.0.3+20230105/google_tpu1/api::ProjectLocationTensorflowVersionGetCall) and [*locations tensorflow versions list*](https://docs.rs/google-tpu1/5.0.3+20230105/google_tpu1/api::ProjectLocationTensorflowVersionListCall) @@ -55,8 +55,8 @@ let r = hub.projects().locations_nodes_stop(...).doit().await let r = hub.projects().locations_operations_get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -84,12 +84,12 @@ use tpu1::{Result, Error}; use std::default::Default; use tpu1::{TPU, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -131,10 +131,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-tpu1/5.0.3+20230105/google_tpu1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-tpu1/5.0.3+20230105/google_tpu1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -144,25 +144,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-tpu1/5 You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-tpu1/5.0.3+20230105/google_tpu1/client::Delegate) to the -[Method Builder](https://docs.rs/google-tpu1/5.0.3+20230105/google_tpu1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-tpu1/5.0.3+20230105/google_tpu1/client::Delegate) to the +[Method Builder](https://docs.rs/google-tpu1/5.0.3+20230105/google_tpu1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-tpu1/5.0.3+20230105/google_tpu1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-tpu1/5.0.3+20230105/google_tpu1/client::RequestValue) and -[decodable](https://docs.rs/google-tpu1/5.0.3+20230105/google_tpu1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-tpu1/5.0.3+20230105/google_tpu1/client::RequestValue) and +[decodable](https://docs.rs/google-tpu1/5.0.3+20230105/google_tpu1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-tpu1/5.0.3+20230105/google_tpu1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-tpu1/5.0.3+20230105/google_tpu1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -181,7 +181,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **tpu1** library was generated by Sebastian Thiel, and is placed +The **tpu1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/tpu1/src/api.rs b/gen/tpu1/src/api.rs index c4162aef9a..805d138e3e 100644 --- a/gen/tpu1/src/api.rs +++ b/gen/tpu1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use tpu1::{TPU, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/tpu1/src/lib.rs b/gen/tpu1/src/lib.rs index 903280761b..07403846ac 100644 --- a/gen/tpu1/src/lib.rs +++ b/gen/tpu1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/tpu1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](TPU) ... +//! Handle the following *Resources* with ease from the central [hub](TPU) ... //! //! * projects //! * [*locations accelerator types get*](api::ProjectLocationAcceleratorTypeGetCall), [*locations accelerator types list*](api::ProjectLocationAcceleratorTypeListCall), [*locations get*](api::ProjectLocationGetCall), [*locations list*](api::ProjectLocationListCall), [*locations nodes create*](api::ProjectLocationNodeCreateCall), [*locations nodes delete*](api::ProjectLocationNodeDeleteCall), [*locations nodes get*](api::ProjectLocationNodeGetCall), [*locations nodes list*](api::ProjectLocationNodeListCall), [*locations nodes reimage*](api::ProjectLocationNodeReimageCall), [*locations nodes start*](api::ProjectLocationNodeStartCall), [*locations nodes stop*](api::ProjectLocationNodeStopCall), [*locations operations cancel*](api::ProjectLocationOperationCancelCall), [*locations operations delete*](api::ProjectLocationOperationDeleteCall), [*locations operations get*](api::ProjectLocationOperationGetCall), [*locations operations list*](api::ProjectLocationOperationListCall), [*locations tensorflow versions get*](api::ProjectLocationTensorflowVersionGetCall) and [*locations tensorflow versions list*](api::ProjectLocationTensorflowVersionListCall) @@ -55,8 +55,8 @@ //! let r = hub.projects().locations_operations_get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -85,12 +85,12 @@ //! use std::default::Default; //! use tpu1::{TPU, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -132,10 +132,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -145,25 +145,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/tpu1_alpha1/README.md b/gen/tpu1_alpha1/README.md index 2ce6b532b0..1e6761935e 100644 --- a/gen/tpu1_alpha1/README.md +++ b/gen/tpu1_alpha1/README.md @@ -11,7 +11,7 @@ Everything else about the *TPU* *v1_alpha1* API can be found at the [official documentation site](https://cloud.google.com/tpu/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-tpu1_alpha1/5.0.3+20230105/google_tpu1_alpha1/TPU) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-tpu1_alpha1/5.0.3+20230105/google_tpu1_alpha1/TPU) ... * projects * [*locations accelerator types get*](https://docs.rs/google-tpu1_alpha1/5.0.3+20230105/google_tpu1_alpha1/api::ProjectLocationAcceleratorTypeGetCall), [*locations accelerator types list*](https://docs.rs/google-tpu1_alpha1/5.0.3+20230105/google_tpu1_alpha1/api::ProjectLocationAcceleratorTypeListCall), [*locations get*](https://docs.rs/google-tpu1_alpha1/5.0.3+20230105/google_tpu1_alpha1/api::ProjectLocationGetCall), [*locations list*](https://docs.rs/google-tpu1_alpha1/5.0.3+20230105/google_tpu1_alpha1/api::ProjectLocationListCall), [*locations nodes create*](https://docs.rs/google-tpu1_alpha1/5.0.3+20230105/google_tpu1_alpha1/api::ProjectLocationNodeCreateCall), [*locations nodes delete*](https://docs.rs/google-tpu1_alpha1/5.0.3+20230105/google_tpu1_alpha1/api::ProjectLocationNodeDeleteCall), [*locations nodes get*](https://docs.rs/google-tpu1_alpha1/5.0.3+20230105/google_tpu1_alpha1/api::ProjectLocationNodeGetCall), [*locations nodes list*](https://docs.rs/google-tpu1_alpha1/5.0.3+20230105/google_tpu1_alpha1/api::ProjectLocationNodeListCall), [*locations nodes reimage*](https://docs.rs/google-tpu1_alpha1/5.0.3+20230105/google_tpu1_alpha1/api::ProjectLocationNodeReimageCall), [*locations nodes start*](https://docs.rs/google-tpu1_alpha1/5.0.3+20230105/google_tpu1_alpha1/api::ProjectLocationNodeStartCall), [*locations nodes stop*](https://docs.rs/google-tpu1_alpha1/5.0.3+20230105/google_tpu1_alpha1/api::ProjectLocationNodeStopCall), [*locations operations cancel*](https://docs.rs/google-tpu1_alpha1/5.0.3+20230105/google_tpu1_alpha1/api::ProjectLocationOperationCancelCall), [*locations operations delete*](https://docs.rs/google-tpu1_alpha1/5.0.3+20230105/google_tpu1_alpha1/api::ProjectLocationOperationDeleteCall), [*locations operations get*](https://docs.rs/google-tpu1_alpha1/5.0.3+20230105/google_tpu1_alpha1/api::ProjectLocationOperationGetCall), [*locations operations list*](https://docs.rs/google-tpu1_alpha1/5.0.3+20230105/google_tpu1_alpha1/api::ProjectLocationOperationListCall), [*locations tensorflow versions get*](https://docs.rs/google-tpu1_alpha1/5.0.3+20230105/google_tpu1_alpha1/api::ProjectLocationTensorflowVersionGetCall) and [*locations tensorflow versions list*](https://docs.rs/google-tpu1_alpha1/5.0.3+20230105/google_tpu1_alpha1/api::ProjectLocationTensorflowVersionListCall) @@ -55,8 +55,8 @@ let r = hub.projects().locations_nodes_stop(...).doit().await let r = hub.projects().locations_operations_get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -84,12 +84,12 @@ use tpu1_alpha1::{Result, Error}; use std::default::Default; use tpu1_alpha1::{TPU, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -132,10 +132,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-tpu1_alpha1/5.0.3+20230105/google_tpu1_alpha1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-tpu1_alpha1/5.0.3+20230105/google_tpu1_alpha1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -145,25 +145,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-tpu1_a You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-tpu1_alpha1/5.0.3+20230105/google_tpu1_alpha1/client::Delegate) to the -[Method Builder](https://docs.rs/google-tpu1_alpha1/5.0.3+20230105/google_tpu1_alpha1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-tpu1_alpha1/5.0.3+20230105/google_tpu1_alpha1/client::Delegate) to the +[Method Builder](https://docs.rs/google-tpu1_alpha1/5.0.3+20230105/google_tpu1_alpha1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-tpu1_alpha1/5.0.3+20230105/google_tpu1_alpha1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-tpu1_alpha1/5.0.3+20230105/google_tpu1_alpha1/client::RequestValue) and -[decodable](https://docs.rs/google-tpu1_alpha1/5.0.3+20230105/google_tpu1_alpha1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-tpu1_alpha1/5.0.3+20230105/google_tpu1_alpha1/client::RequestValue) and +[decodable](https://docs.rs/google-tpu1_alpha1/5.0.3+20230105/google_tpu1_alpha1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-tpu1_alpha1/5.0.3+20230105/google_tpu1_alpha1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-tpu1_alpha1/5.0.3+20230105/google_tpu1_alpha1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -182,7 +182,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **tpu1_alpha1** library was generated by Sebastian Thiel, and is placed +The **tpu1_alpha1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/tpu1_alpha1/src/api.rs b/gen/tpu1_alpha1/src/api.rs index f81ff78146..0cd42f8874 100644 --- a/gen/tpu1_alpha1/src/api.rs +++ b/gen/tpu1_alpha1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use tpu1_alpha1::{TPU, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/tpu1_alpha1/src/lib.rs b/gen/tpu1_alpha1/src/lib.rs index d726ed004d..a16702885f 100644 --- a/gen/tpu1_alpha1/src/lib.rs +++ b/gen/tpu1_alpha1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/tpu1_alpha1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](TPU) ... +//! Handle the following *Resources* with ease from the central [hub](TPU) ... //! //! * projects //! * [*locations accelerator types get*](api::ProjectLocationAcceleratorTypeGetCall), [*locations accelerator types list*](api::ProjectLocationAcceleratorTypeListCall), [*locations get*](api::ProjectLocationGetCall), [*locations list*](api::ProjectLocationListCall), [*locations nodes create*](api::ProjectLocationNodeCreateCall), [*locations nodes delete*](api::ProjectLocationNodeDeleteCall), [*locations nodes get*](api::ProjectLocationNodeGetCall), [*locations nodes list*](api::ProjectLocationNodeListCall), [*locations nodes reimage*](api::ProjectLocationNodeReimageCall), [*locations nodes start*](api::ProjectLocationNodeStartCall), [*locations nodes stop*](api::ProjectLocationNodeStopCall), [*locations operations cancel*](api::ProjectLocationOperationCancelCall), [*locations operations delete*](api::ProjectLocationOperationDeleteCall), [*locations operations get*](api::ProjectLocationOperationGetCall), [*locations operations list*](api::ProjectLocationOperationListCall), [*locations tensorflow versions get*](api::ProjectLocationTensorflowVersionGetCall) and [*locations tensorflow versions list*](api::ProjectLocationTensorflowVersionListCall) @@ -55,8 +55,8 @@ //! let r = hub.projects().locations_operations_get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -85,12 +85,12 @@ //! use std::default::Default; //! use tpu1_alpha1::{TPU, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -133,10 +133,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -146,25 +146,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/transcoder1/README.md b/gen/transcoder1/README.md index f5c5a78516..ddddcd3727 100644 --- a/gen/transcoder1/README.md +++ b/gen/transcoder1/README.md @@ -11,7 +11,7 @@ Everything else about the *Transcoder* *v1* API can be found at the [official documentation site](https://cloud.google.com/transcoder/docs/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-transcoder1/5.0.3+20230105/google_transcoder1/Transcoder) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-transcoder1/5.0.3+20230105/google_transcoder1/Transcoder) ... * projects * [*locations job templates create*](https://docs.rs/google-transcoder1/5.0.3+20230105/google_transcoder1/api::ProjectLocationJobTemplateCreateCall), [*locations job templates delete*](https://docs.rs/google-transcoder1/5.0.3+20230105/google_transcoder1/api::ProjectLocationJobTemplateDeleteCall), [*locations job templates get*](https://docs.rs/google-transcoder1/5.0.3+20230105/google_transcoder1/api::ProjectLocationJobTemplateGetCall), [*locations job templates list*](https://docs.rs/google-transcoder1/5.0.3+20230105/google_transcoder1/api::ProjectLocationJobTemplateListCall), [*locations jobs create*](https://docs.rs/google-transcoder1/5.0.3+20230105/google_transcoder1/api::ProjectLocationJobCreateCall), [*locations jobs delete*](https://docs.rs/google-transcoder1/5.0.3+20230105/google_transcoder1/api::ProjectLocationJobDeleteCall), [*locations jobs get*](https://docs.rs/google-transcoder1/5.0.3+20230105/google_transcoder1/api::ProjectLocationJobGetCall) and [*locations jobs list*](https://docs.rs/google-transcoder1/5.0.3+20230105/google_transcoder1/api::ProjectLocationJobListCall) @@ -51,8 +51,8 @@ let r = hub.projects().locations_jobs_create(...).doit().await let r = hub.projects().locations_jobs_get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -80,12 +80,12 @@ use transcoder1::{Result, Error}; use std::default::Default; use transcoder1::{Transcoder, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -126,10 +126,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-transcoder1/5.0.3+20230105/google_transcoder1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-transcoder1/5.0.3+20230105/google_transcoder1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -139,25 +139,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-transc You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-transcoder1/5.0.3+20230105/google_transcoder1/client::Delegate) to the -[Method Builder](https://docs.rs/google-transcoder1/5.0.3+20230105/google_transcoder1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-transcoder1/5.0.3+20230105/google_transcoder1/client::Delegate) to the +[Method Builder](https://docs.rs/google-transcoder1/5.0.3+20230105/google_transcoder1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-transcoder1/5.0.3+20230105/google_transcoder1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-transcoder1/5.0.3+20230105/google_transcoder1/client::RequestValue) and -[decodable](https://docs.rs/google-transcoder1/5.0.3+20230105/google_transcoder1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-transcoder1/5.0.3+20230105/google_transcoder1/client::RequestValue) and +[decodable](https://docs.rs/google-transcoder1/5.0.3+20230105/google_transcoder1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-transcoder1/5.0.3+20230105/google_transcoder1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-transcoder1/5.0.3+20230105/google_transcoder1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -176,7 +176,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **transcoder1** library was generated by Sebastian Thiel, and is placed +The **transcoder1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/transcoder1/src/api.rs b/gen/transcoder1/src/api.rs index 602b893aae..1b0a32a2ff 100644 --- a/gen/transcoder1/src/api.rs +++ b/gen/transcoder1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use transcoder1::{Transcoder, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/transcoder1/src/lib.rs b/gen/transcoder1/src/lib.rs index 737cd9dee8..3396d3b552 100644 --- a/gen/transcoder1/src/lib.rs +++ b/gen/transcoder1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/transcoder1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Transcoder) ... +//! Handle the following *Resources* with ease from the central [hub](Transcoder) ... //! //! * projects //! * [*locations job templates create*](api::ProjectLocationJobTemplateCreateCall), [*locations job templates delete*](api::ProjectLocationJobTemplateDeleteCall), [*locations job templates get*](api::ProjectLocationJobTemplateGetCall), [*locations job templates list*](api::ProjectLocationJobTemplateListCall), [*locations jobs create*](api::ProjectLocationJobCreateCall), [*locations jobs delete*](api::ProjectLocationJobDeleteCall), [*locations jobs get*](api::ProjectLocationJobGetCall) and [*locations jobs list*](api::ProjectLocationJobListCall) @@ -51,8 +51,8 @@ //! let r = hub.projects().locations_jobs_get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -81,12 +81,12 @@ //! use std::default::Default; //! use transcoder1::{Transcoder, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -127,10 +127,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -140,25 +140,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/transcoder1_beta1/README.md b/gen/transcoder1_beta1/README.md index 5f8cf55f61..37e31a339f 100644 --- a/gen/transcoder1_beta1/README.md +++ b/gen/transcoder1_beta1/README.md @@ -11,7 +11,7 @@ Everything else about the *Transcoder* *v1_beta1* API can be found at the [official documentation site](https://cloud.google.com/transcoder/docs/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-transcoder1_beta1/5.0.3+20210323/google_transcoder1_beta1/Transcoder) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-transcoder1_beta1/5.0.3+20210323/google_transcoder1_beta1/Transcoder) ... * projects * [*locations job templates create*](https://docs.rs/google-transcoder1_beta1/5.0.3+20210323/google_transcoder1_beta1/api::ProjectLocationJobTemplateCreateCall), [*locations job templates delete*](https://docs.rs/google-transcoder1_beta1/5.0.3+20210323/google_transcoder1_beta1/api::ProjectLocationJobTemplateDeleteCall), [*locations job templates get*](https://docs.rs/google-transcoder1_beta1/5.0.3+20210323/google_transcoder1_beta1/api::ProjectLocationJobTemplateGetCall), [*locations job templates list*](https://docs.rs/google-transcoder1_beta1/5.0.3+20210323/google_transcoder1_beta1/api::ProjectLocationJobTemplateListCall), [*locations jobs create*](https://docs.rs/google-transcoder1_beta1/5.0.3+20210323/google_transcoder1_beta1/api::ProjectLocationJobCreateCall), [*locations jobs delete*](https://docs.rs/google-transcoder1_beta1/5.0.3+20210323/google_transcoder1_beta1/api::ProjectLocationJobDeleteCall), [*locations jobs get*](https://docs.rs/google-transcoder1_beta1/5.0.3+20210323/google_transcoder1_beta1/api::ProjectLocationJobGetCall) and [*locations jobs list*](https://docs.rs/google-transcoder1_beta1/5.0.3+20210323/google_transcoder1_beta1/api::ProjectLocationJobListCall) @@ -51,8 +51,8 @@ let r = hub.projects().locations_jobs_create(...).doit().await let r = hub.projects().locations_jobs_get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -80,12 +80,12 @@ use transcoder1_beta1::{Result, Error}; use std::default::Default; use transcoder1_beta1::{Transcoder, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -126,10 +126,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-transcoder1_beta1/5.0.3+20210323/google_transcoder1_beta1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-transcoder1_beta1/5.0.3+20210323/google_transcoder1_beta1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -139,25 +139,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-transc You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-transcoder1_beta1/5.0.3+20210323/google_transcoder1_beta1/client::Delegate) to the -[Method Builder](https://docs.rs/google-transcoder1_beta1/5.0.3+20210323/google_transcoder1_beta1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-transcoder1_beta1/5.0.3+20210323/google_transcoder1_beta1/client::Delegate) to the +[Method Builder](https://docs.rs/google-transcoder1_beta1/5.0.3+20210323/google_transcoder1_beta1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-transcoder1_beta1/5.0.3+20210323/google_transcoder1_beta1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-transcoder1_beta1/5.0.3+20210323/google_transcoder1_beta1/client::RequestValue) and -[decodable](https://docs.rs/google-transcoder1_beta1/5.0.3+20210323/google_transcoder1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-transcoder1_beta1/5.0.3+20210323/google_transcoder1_beta1/client::RequestValue) and +[decodable](https://docs.rs/google-transcoder1_beta1/5.0.3+20210323/google_transcoder1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-transcoder1_beta1/5.0.3+20210323/google_transcoder1_beta1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-transcoder1_beta1/5.0.3+20210323/google_transcoder1_beta1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -176,7 +176,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **transcoder1_beta1** library was generated by Sebastian Thiel, and is placed +The **transcoder1_beta1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/transcoder1_beta1/src/api.rs b/gen/transcoder1_beta1/src/api.rs index fa994f5296..82e36c24a8 100644 --- a/gen/transcoder1_beta1/src/api.rs +++ b/gen/transcoder1_beta1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud Platform data CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use transcoder1_beta1::{Transcoder, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/transcoder1_beta1/src/lib.rs b/gen/transcoder1_beta1/src/lib.rs index 221a541147..06250391a0 100644 --- a/gen/transcoder1_beta1/src/lib.rs +++ b/gen/transcoder1_beta1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/transcoder1_beta1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Transcoder) ... +//! Handle the following *Resources* with ease from the central [hub](Transcoder) ... //! //! * projects //! * [*locations job templates create*](api::ProjectLocationJobTemplateCreateCall), [*locations job templates delete*](api::ProjectLocationJobTemplateDeleteCall), [*locations job templates get*](api::ProjectLocationJobTemplateGetCall), [*locations job templates list*](api::ProjectLocationJobTemplateListCall), [*locations jobs create*](api::ProjectLocationJobCreateCall), [*locations jobs delete*](api::ProjectLocationJobDeleteCall), [*locations jobs get*](api::ProjectLocationJobGetCall) and [*locations jobs list*](api::ProjectLocationJobListCall) @@ -51,8 +51,8 @@ //! let r = hub.projects().locations_jobs_get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -81,12 +81,12 @@ //! use std::default::Default; //! use transcoder1_beta1::{Transcoder, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -127,10 +127,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -140,25 +140,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/translate2/README.md b/gen/translate2/README.md index 6fd45acfb4..8866f0311d 100644 --- a/gen/translate2/README.md +++ b/gen/translate2/README.md @@ -11,7 +11,7 @@ Everything else about the *Translate* *v2* API can be found at the [official documentation site](https://code.google.com/apis/language/translate/v2/getting_started.html). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-translate2/5.0.3+20170525/google_translate2/Translate) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-translate2/5.0.3+20170525/google_translate2/Translate) ... * detections * [*detect*](https://docs.rs/google-translate2/5.0.3+20170525/google_translate2/api::DetectionDetectCall) and [*list*](https://docs.rs/google-translate2/5.0.3+20170525/google_translate2/api::DetectionListCall) @@ -55,8 +55,8 @@ let r = hub.detections().detect(...).doit().await let r = hub.detections().list(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -84,12 +84,12 @@ use translate2::{Result, Error}; use std::default::Default; use translate2::{Translate, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -130,10 +130,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-translate2/5.0.3+20170525/google_translate2/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-translate2/5.0.3+20170525/google_translate2/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -143,25 +143,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-transl You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-translate2/5.0.3+20170525/google_translate2/client::Delegate) to the -[Method Builder](https://docs.rs/google-translate2/5.0.3+20170525/google_translate2/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-translate2/5.0.3+20170525/google_translate2/client::Delegate) to the +[Method Builder](https://docs.rs/google-translate2/5.0.3+20170525/google_translate2/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-translate2/5.0.3+20170525/google_translate2/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-translate2/5.0.3+20170525/google_translate2/client::RequestValue) and -[decodable](https://docs.rs/google-translate2/5.0.3+20170525/google_translate2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-translate2/5.0.3+20170525/google_translate2/client::RequestValue) and +[decodable](https://docs.rs/google-translate2/5.0.3+20170525/google_translate2/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-translate2/5.0.3+20170525/google_translate2/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-translate2/5.0.3+20170525/google_translate2/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -180,7 +180,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **translate2** library was generated by Sebastian Thiel, and is placed +The **translate2** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/translate2/src/api.rs b/gen/translate2/src/api.rs index 1e73c7822d..09f4f7645b 100644 --- a/gen/translate2/src/api.rs +++ b/gen/translate2/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your data across Google Cloud Platform services CloudPlatform, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use translate2::{Translate, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/translate2/src/lib.rs b/gen/translate2/src/lib.rs index f17f9f56dc..57b76820ec 100644 --- a/gen/translate2/src/lib.rs +++ b/gen/translate2/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/translate2). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Translate) ... +//! Handle the following *Resources* with ease from the central [hub](Translate) ... //! //! * detections //! * [*detect*](api::DetectionDetectCall) and [*list*](api::DetectionListCall) @@ -55,8 +55,8 @@ //! let r = hub.detections().list(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -85,12 +85,12 @@ //! use std::default::Default; //! use translate2::{Translate, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -131,10 +131,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -144,25 +144,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/translate3/README.md b/gen/translate3/README.md index 727cc08a45..637ac0b4a4 100644 --- a/gen/translate3/README.md +++ b/gen/translate3/README.md @@ -11,7 +11,7 @@ Everything else about the *Translate* *v3* API can be found at the [official documentation site](https://cloud.google.com/translate/docs/quickstarts). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/Translate) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/Translate) ... * projects * [*detect language*](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/api::ProjectDetectLanguageCall), [*get supported languages*](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/api::ProjectGetSupportedLanguageCall), [*locations batch translate document*](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/api::ProjectLocationBatchTranslateDocumentCall), [*locations batch translate text*](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/api::ProjectLocationBatchTranslateTextCall), [*locations datasets create*](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/api::ProjectLocationDatasetCreateCall), [*locations datasets delete*](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/api::ProjectLocationDatasetDeleteCall), [*locations datasets examples list*](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/api::ProjectLocationDatasetExampleListCall), [*locations datasets export data*](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/api::ProjectLocationDatasetExportDataCall), [*locations datasets get*](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/api::ProjectLocationDatasetGetCall), [*locations datasets import data*](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/api::ProjectLocationDatasetImportDataCall), [*locations datasets list*](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/api::ProjectLocationDatasetListCall), [*locations detect language*](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/api::ProjectLocationDetectLanguageCall), [*locations get*](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/api::ProjectLocationGetCall), [*locations get supported languages*](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/api::ProjectLocationGetSupportedLanguageCall), [*locations glossaries create*](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/api::ProjectLocationGlossaryCreateCall), [*locations glossaries delete*](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/api::ProjectLocationGlossaryDeleteCall), [*locations glossaries get*](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/api::ProjectLocationGlossaryGetCall), [*locations glossaries glossary entries create*](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/api::ProjectLocationGlossaryGlossaryEntryCreateCall), [*locations glossaries glossary entries delete*](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/api::ProjectLocationGlossaryGlossaryEntryDeleteCall), [*locations glossaries glossary entries get*](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/api::ProjectLocationGlossaryGlossaryEntryGetCall), [*locations glossaries glossary entries list*](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/api::ProjectLocationGlossaryGlossaryEntryListCall), [*locations glossaries glossary entries patch*](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/api::ProjectLocationGlossaryGlossaryEntryPatchCall), [*locations glossaries list*](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/api::ProjectLocationGlossaryListCall), [*locations glossaries patch*](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/api::ProjectLocationGlossaryPatchCall), [*locations list*](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/api::ProjectLocationListCall), [*locations models create*](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/api::ProjectLocationModelCreateCall), [*locations models delete*](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/api::ProjectLocationModelDeleteCall), [*locations models get*](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/api::ProjectLocationModelGetCall), [*locations models list*](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/api::ProjectLocationModelListCall), [*locations operations cancel*](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/api::ProjectLocationOperationCancelCall), [*locations operations delete*](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/api::ProjectLocationOperationDeleteCall), [*locations operations get*](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/api::ProjectLocationOperationGetCall), [*locations operations list*](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/api::ProjectLocationOperationListCall), [*locations operations wait*](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/api::ProjectLocationOperationWaitCall), [*locations translate document*](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/api::ProjectLocationTranslateDocumentCall), [*locations translate text*](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/api::ProjectLocationTranslateTextCall) and [*translate text*](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/api::ProjectTranslateTextCall) @@ -62,8 +62,8 @@ let r = hub.projects().locations_batch_translate_document(...).doit().await let r = hub.projects().locations_batch_translate_text(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -91,12 +91,12 @@ use translate3::{Result, Error}; use std::default::Default; use translate3::{Translate, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -138,10 +138,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -151,25 +151,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-transl You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/client::Delegate) to the -[Method Builder](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/client::Delegate) to the +[Method Builder](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/client::RequestValue) and -[decodable](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/client::RequestValue) and +[decodable](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-translate3/5.0.3+20230106/google_translate3/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -188,7 +188,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **translate3** library was generated by Sebastian Thiel, and is placed +The **translate3** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/translate3/src/api.rs b/gen/translate3/src/api.rs index 6f6ddfaca7..ab7b4f246a 100644 --- a/gen/translate3/src/api.rs +++ b/gen/translate3/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use translate3::{Translate, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/translate3/src/lib.rs b/gen/translate3/src/lib.rs index 6e38dc8394..e477ea6a0f 100644 --- a/gen/translate3/src/lib.rs +++ b/gen/translate3/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/translate3). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Translate) ... +//! Handle the following *Resources* with ease from the central [hub](Translate) ... //! //! * projects //! * [*detect language*](api::ProjectDetectLanguageCall), [*get supported languages*](api::ProjectGetSupportedLanguageCall), [*locations batch translate document*](api::ProjectLocationBatchTranslateDocumentCall), [*locations batch translate text*](api::ProjectLocationBatchTranslateTextCall), [*locations datasets create*](api::ProjectLocationDatasetCreateCall), [*locations datasets delete*](api::ProjectLocationDatasetDeleteCall), [*locations datasets examples list*](api::ProjectLocationDatasetExampleListCall), [*locations datasets export data*](api::ProjectLocationDatasetExportDataCall), [*locations datasets get*](api::ProjectLocationDatasetGetCall), [*locations datasets import data*](api::ProjectLocationDatasetImportDataCall), [*locations datasets list*](api::ProjectLocationDatasetListCall), [*locations detect language*](api::ProjectLocationDetectLanguageCall), [*locations get*](api::ProjectLocationGetCall), [*locations get supported languages*](api::ProjectLocationGetSupportedLanguageCall), [*locations glossaries create*](api::ProjectLocationGlossaryCreateCall), [*locations glossaries delete*](api::ProjectLocationGlossaryDeleteCall), [*locations glossaries get*](api::ProjectLocationGlossaryGetCall), [*locations glossaries glossary entries create*](api::ProjectLocationGlossaryGlossaryEntryCreateCall), [*locations glossaries glossary entries delete*](api::ProjectLocationGlossaryGlossaryEntryDeleteCall), [*locations glossaries glossary entries get*](api::ProjectLocationGlossaryGlossaryEntryGetCall), [*locations glossaries glossary entries list*](api::ProjectLocationGlossaryGlossaryEntryListCall), [*locations glossaries glossary entries patch*](api::ProjectLocationGlossaryGlossaryEntryPatchCall), [*locations glossaries list*](api::ProjectLocationGlossaryListCall), [*locations glossaries patch*](api::ProjectLocationGlossaryPatchCall), [*locations list*](api::ProjectLocationListCall), [*locations models create*](api::ProjectLocationModelCreateCall), [*locations models delete*](api::ProjectLocationModelDeleteCall), [*locations models get*](api::ProjectLocationModelGetCall), [*locations models list*](api::ProjectLocationModelListCall), [*locations operations cancel*](api::ProjectLocationOperationCancelCall), [*locations operations delete*](api::ProjectLocationOperationDeleteCall), [*locations operations get*](api::ProjectLocationOperationGetCall), [*locations operations list*](api::ProjectLocationOperationListCall), [*locations operations wait*](api::ProjectLocationOperationWaitCall), [*locations translate document*](api::ProjectLocationTranslateDocumentCall), [*locations translate text*](api::ProjectLocationTranslateTextCall) and [*translate text*](api::ProjectTranslateTextCall) @@ -62,8 +62,8 @@ //! let r = hub.projects().locations_batch_translate_text(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -92,12 +92,12 @@ //! use std::default::Default; //! use translate3::{Translate, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -139,10 +139,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -152,25 +152,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/urlshortener1/README.md b/gen/urlshortener1/README.md index 1ddc5331eb..06bc7191e7 100644 --- a/gen/urlshortener1/README.md +++ b/gen/urlshortener1/README.md @@ -11,7 +11,7 @@ Everything else about the *urlshortener* *v1* API can be found at the [official documentation site](https://developers.google.com/url-shortener/v1/getting_started). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-urlshortener1/5.0.3+20150519/google_urlshortener1/Urlshortener) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-urlshortener1/5.0.3+20150519/google_urlshortener1/Urlshortener) ... * [url](https://docs.rs/google-urlshortener1/5.0.3+20150519/google_urlshortener1/api::Url) * [*get*](https://docs.rs/google-urlshortener1/5.0.3+20150519/google_urlshortener1/api::UrlGetCall), [*insert*](https://docs.rs/google-urlshortener1/5.0.3+20150519/google_urlshortener1/api::UrlInsertCall) and [*list*](https://docs.rs/google-urlshortener1/5.0.3+20150519/google_urlshortener1/api::UrlListCall) @@ -51,8 +51,8 @@ let r = hub.url().get(...).doit().await let r = hub.url().insert(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -79,12 +79,12 @@ use urlshortener1::{Result, Error}; use std::default::Default; use urlshortener1::{Urlshortener, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -121,10 +121,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-urlshortener1/5.0.3+20150519/google_urlshortener1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-urlshortener1/5.0.3+20150519/google_urlshortener1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -134,25 +134,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-urlsho You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-urlshortener1/5.0.3+20150519/google_urlshortener1/client::Delegate) to the -[Method Builder](https://docs.rs/google-urlshortener1/5.0.3+20150519/google_urlshortener1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-urlshortener1/5.0.3+20150519/google_urlshortener1/client::Delegate) to the +[Method Builder](https://docs.rs/google-urlshortener1/5.0.3+20150519/google_urlshortener1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-urlshortener1/5.0.3+20150519/google_urlshortener1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-urlshortener1/5.0.3+20150519/google_urlshortener1/client::RequestValue) and -[decodable](https://docs.rs/google-urlshortener1/5.0.3+20150519/google_urlshortener1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-urlshortener1/5.0.3+20150519/google_urlshortener1/client::RequestValue) and +[decodable](https://docs.rs/google-urlshortener1/5.0.3+20150519/google_urlshortener1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-urlshortener1/5.0.3+20150519/google_urlshortener1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-urlshortener1/5.0.3+20150519/google_urlshortener1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -171,7 +171,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **urlshortener1** library was generated by Sebastian Thiel, and is placed +The **urlshortener1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/urlshortener1/src/api.rs b/gen/urlshortener1/src/api.rs index 21a55babc9..584d5655fa 100644 --- a/gen/urlshortener1/src/api.rs +++ b/gen/urlshortener1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// Manage your goo.gl short URLs Full, @@ -64,12 +64,12 @@ impl Default for Scope { /// use std::default::Default; /// use urlshortener1::{Urlshortener, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/urlshortener1/src/lib.rs b/gen/urlshortener1/src/lib.rs index 15e595d5c7..1e94a1016b 100644 --- a/gen/urlshortener1/src/lib.rs +++ b/gen/urlshortener1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/urlshortener1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Urlshortener) ... +//! Handle the following *Resources* with ease from the central [hub](Urlshortener) ... //! //! * [url](api::Url) //! * [*get*](api::UrlGetCall), [*insert*](api::UrlInsertCall) and [*list*](api::UrlListCall) @@ -51,8 +51,8 @@ //! let r = hub.url().insert(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -80,12 +80,12 @@ //! use std::default::Default; //! use urlshortener1::{Urlshortener, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -122,10 +122,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -135,25 +135,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/vault1/README.md b/gen/vault1/README.md index 3b99e324fa..f14cab79d0 100644 --- a/gen/vault1/README.md +++ b/gen/vault1/README.md @@ -11,7 +11,7 @@ Everything else about the *Vault* *v1* API can be found at the [official documentation site](https://developers.google.com/vault). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-vault1/5.0.3+20230123/google_vault1/Vault) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-vault1/5.0.3+20230123/google_vault1/Vault) ... * [matters](https://docs.rs/google-vault1/5.0.3+20230123/google_vault1/api::Matter) * [*add permissions*](https://docs.rs/google-vault1/5.0.3+20230123/google_vault1/api::MatterAddPermissionCall), [*close*](https://docs.rs/google-vault1/5.0.3+20230123/google_vault1/api::MatterCloseCall), [*count*](https://docs.rs/google-vault1/5.0.3+20230123/google_vault1/api::MatterCountCall), [*create*](https://docs.rs/google-vault1/5.0.3+20230123/google_vault1/api::MatterCreateCall), [*delete*](https://docs.rs/google-vault1/5.0.3+20230123/google_vault1/api::MatterDeleteCall), [*exports create*](https://docs.rs/google-vault1/5.0.3+20230123/google_vault1/api::MatterExportCreateCall), [*exports delete*](https://docs.rs/google-vault1/5.0.3+20230123/google_vault1/api::MatterExportDeleteCall), [*exports get*](https://docs.rs/google-vault1/5.0.3+20230123/google_vault1/api::MatterExportGetCall), [*exports list*](https://docs.rs/google-vault1/5.0.3+20230123/google_vault1/api::MatterExportListCall), [*get*](https://docs.rs/google-vault1/5.0.3+20230123/google_vault1/api::MatterGetCall), [*holds accounts create*](https://docs.rs/google-vault1/5.0.3+20230123/google_vault1/api::MatterHoldAccountCreateCall), [*holds accounts delete*](https://docs.rs/google-vault1/5.0.3+20230123/google_vault1/api::MatterHoldAccountDeleteCall), [*holds accounts list*](https://docs.rs/google-vault1/5.0.3+20230123/google_vault1/api::MatterHoldAccountListCall), [*holds add held accounts*](https://docs.rs/google-vault1/5.0.3+20230123/google_vault1/api::MatterHoldAddHeldAccountCall), [*holds create*](https://docs.rs/google-vault1/5.0.3+20230123/google_vault1/api::MatterHoldCreateCall), [*holds delete*](https://docs.rs/google-vault1/5.0.3+20230123/google_vault1/api::MatterHoldDeleteCall), [*holds get*](https://docs.rs/google-vault1/5.0.3+20230123/google_vault1/api::MatterHoldGetCall), [*holds list*](https://docs.rs/google-vault1/5.0.3+20230123/google_vault1/api::MatterHoldListCall), [*holds remove held accounts*](https://docs.rs/google-vault1/5.0.3+20230123/google_vault1/api::MatterHoldRemoveHeldAccountCall), [*holds update*](https://docs.rs/google-vault1/5.0.3+20230123/google_vault1/api::MatterHoldUpdateCall), [*list*](https://docs.rs/google-vault1/5.0.3+20230123/google_vault1/api::MatterListCall), [*remove permissions*](https://docs.rs/google-vault1/5.0.3+20230123/google_vault1/api::MatterRemovePermissionCall), [*reopen*](https://docs.rs/google-vault1/5.0.3+20230123/google_vault1/api::MatterReopenCall), [*saved queries create*](https://docs.rs/google-vault1/5.0.3+20230123/google_vault1/api::MatterSavedQueryCreateCall), [*saved queries delete*](https://docs.rs/google-vault1/5.0.3+20230123/google_vault1/api::MatterSavedQueryDeleteCall), [*saved queries get*](https://docs.rs/google-vault1/5.0.3+20230123/google_vault1/api::MatterSavedQueryGetCall), [*saved queries list*](https://docs.rs/google-vault1/5.0.3+20230123/google_vault1/api::MatterSavedQueryListCall), [*undelete*](https://docs.rs/google-vault1/5.0.3+20230123/google_vault1/api::MatterUndeleteCall) and [*update*](https://docs.rs/google-vault1/5.0.3+20230123/google_vault1/api::MatterUpdateCall) @@ -80,8 +80,8 @@ let r = hub.matters().undelete(...).doit().await let r = hub.matters().update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -108,12 +108,12 @@ use vault1::{Result, Error}; use std::default::Default; use vault1::{Vault, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -152,10 +152,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-vault1/5.0.3+20230123/google_vault1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-vault1/5.0.3+20230123/google_vault1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -165,25 +165,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-vault1 You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-vault1/5.0.3+20230123/google_vault1/client::Delegate) to the -[Method Builder](https://docs.rs/google-vault1/5.0.3+20230123/google_vault1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-vault1/5.0.3+20230123/google_vault1/client::Delegate) to the +[Method Builder](https://docs.rs/google-vault1/5.0.3+20230123/google_vault1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-vault1/5.0.3+20230123/google_vault1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-vault1/5.0.3+20230123/google_vault1/client::RequestValue) and -[decodable](https://docs.rs/google-vault1/5.0.3+20230123/google_vault1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-vault1/5.0.3+20230123/google_vault1/client::RequestValue) and +[decodable](https://docs.rs/google-vault1/5.0.3+20230123/google_vault1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-vault1/5.0.3+20230123/google_vault1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-vault1/5.0.3+20230123/google_vault1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -202,7 +202,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **vault1** library was generated by Sebastian Thiel, and is placed +The **vault1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/vault1/src/api.rs b/gen/vault1/src/api.rs index b25b86635a..95fdff9383 100644 --- a/gen/vault1/src/api.rs +++ b/gen/vault1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// Manage your eDiscovery data Ediscovery, @@ -68,12 +68,12 @@ impl Default for Scope { /// use std::default::Default; /// use vault1::{Vault, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/vault1/src/lib.rs b/gen/vault1/src/lib.rs index a9373a2714..84f0faf793 100644 --- a/gen/vault1/src/lib.rs +++ b/gen/vault1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/vault1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Vault) ... +//! Handle the following *Resources* with ease from the central [hub](Vault) ... //! //! * [matters](api::Matter) //! * [*add permissions*](api::MatterAddPermissionCall), [*close*](api::MatterCloseCall), [*count*](api::MatterCountCall), [*create*](api::MatterCreateCall), [*delete*](api::MatterDeleteCall), [*exports create*](api::MatterExportCreateCall), [*exports delete*](api::MatterExportDeleteCall), [*exports get*](api::MatterExportGetCall), [*exports list*](api::MatterExportListCall), [*get*](api::MatterGetCall), [*holds accounts create*](api::MatterHoldAccountCreateCall), [*holds accounts delete*](api::MatterHoldAccountDeleteCall), [*holds accounts list*](api::MatterHoldAccountListCall), [*holds add held accounts*](api::MatterHoldAddHeldAccountCall), [*holds create*](api::MatterHoldCreateCall), [*holds delete*](api::MatterHoldDeleteCall), [*holds get*](api::MatterHoldGetCall), [*holds list*](api::MatterHoldListCall), [*holds remove held accounts*](api::MatterHoldRemoveHeldAccountCall), [*holds update*](api::MatterHoldUpdateCall), [*list*](api::MatterListCall), [*remove permissions*](api::MatterRemovePermissionCall), [*reopen*](api::MatterReopenCall), [*saved queries create*](api::MatterSavedQueryCreateCall), [*saved queries delete*](api::MatterSavedQueryDeleteCall), [*saved queries get*](api::MatterSavedQueryGetCall), [*saved queries list*](api::MatterSavedQueryListCall), [*undelete*](api::MatterUndeleteCall) and [*update*](api::MatterUpdateCall) @@ -80,8 +80,8 @@ //! let r = hub.matters().update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -109,12 +109,12 @@ //! use std::default::Default; //! use vault1::{Vault, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -153,10 +153,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -166,25 +166,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/vectortile1/README.md b/gen/vectortile1/README.md index 445a7aa0fd..8e29ccbd00 100644 --- a/gen/vectortile1/README.md +++ b/gen/vectortile1/README.md @@ -11,7 +11,7 @@ Everything else about the *Semantic Tile* *v1* API can be found at the [official documentation site](https://developers.google.com/maps/contact-sales/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-vectortile1/5.0.3+20210331/google_vectortile1/SemanticTile) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-vectortile1/5.0.3+20210331/google_vectortile1/SemanticTile) ... * featuretiles * [*get*](https://docs.rs/google-vectortile1/5.0.3+20210331/google_vectortile1/api::FeaturetileGetCall) @@ -52,8 +52,8 @@ Or specifically ... let r = hub.featuretiles().get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -80,12 +80,12 @@ use vectortile1::{Result, Error}; use std::default::Default; use vectortile1::{SemanticTile, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -138,10 +138,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-vectortile1/5.0.3+20210331/google_vectortile1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-vectortile1/5.0.3+20210331/google_vectortile1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -151,25 +151,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-vector You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-vectortile1/5.0.3+20210331/google_vectortile1/client::Delegate) to the -[Method Builder](https://docs.rs/google-vectortile1/5.0.3+20210331/google_vectortile1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-vectortile1/5.0.3+20210331/google_vectortile1/client::Delegate) to the +[Method Builder](https://docs.rs/google-vectortile1/5.0.3+20210331/google_vectortile1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-vectortile1/5.0.3+20210331/google_vectortile1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-vectortile1/5.0.3+20210331/google_vectortile1/client::RequestValue) and -[decodable](https://docs.rs/google-vectortile1/5.0.3+20210331/google_vectortile1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-vectortile1/5.0.3+20210331/google_vectortile1/client::RequestValue) and +[decodable](https://docs.rs/google-vectortile1/5.0.3+20210331/google_vectortile1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-vectortile1/5.0.3+20210331/google_vectortile1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-vectortile1/5.0.3+20210331/google_vectortile1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -188,7 +188,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **vectortile1** library was generated by Sebastian Thiel, and is placed +The **vectortile1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/vectortile1/src/api.rs b/gen/vectortile1/src/api.rs index d258a2fc34..9d9544a35c 100644 --- a/gen/vectortile1/src/api.rs +++ b/gen/vectortile1/src/api.rs @@ -42,12 +42,12 @@ use crate::{client, client::GetToken, client::serde_with}; /// use std::default::Default; /// use vectortile1::{SemanticTile, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/vectortile1/src/lib.rs b/gen/vectortile1/src/lib.rs index ca063b4404..ecbe6c0a2a 100644 --- a/gen/vectortile1/src/lib.rs +++ b/gen/vectortile1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/vectortile1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](SemanticTile) ... +//! Handle the following *Resources* with ease from the central [hub](SemanticTile) ... //! //! * featuretiles //! * [*get*](api::FeaturetileGetCall) @@ -52,8 +52,8 @@ //! let r = hub.featuretiles().get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -81,12 +81,12 @@ //! use std::default::Default; //! use vectortile1::{SemanticTile, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -139,10 +139,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -152,25 +152,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/verifiedaccess1/README.md b/gen/verifiedaccess1/README.md index e22681625a..ea089b8390 100644 --- a/gen/verifiedaccess1/README.md +++ b/gen/verifiedaccess1/README.md @@ -11,7 +11,7 @@ Everything else about the *verifiedaccess* *v1* API can be found at the [official documentation site](https://developers.google.com/chrome/verified-access). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-verifiedaccess1/5.0.3+20230117/google_verifiedaccess1/Verifiedaccess) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-verifiedaccess1/5.0.3+20230117/google_verifiedaccess1/Verifiedaccess) ... * [challenge](https://docs.rs/google-verifiedaccess1/5.0.3+20230117/google_verifiedaccess1/api::Challenge) * [*create*](https://docs.rs/google-verifiedaccess1/5.0.3+20230117/google_verifiedaccess1/api::ChallengeCreateCall) and [*verify*](https://docs.rs/google-verifiedaccess1/5.0.3+20230117/google_verifiedaccess1/api::ChallengeVerifyCall) @@ -50,8 +50,8 @@ Or specifically ... let r = hub.challenge().verify(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -79,12 +79,12 @@ use verifiedaccess1::{Result, Error}; use std::default::Default; use verifiedaccess1::{Verifiedaccess, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -125,10 +125,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-verifiedaccess1/5.0.3+20230117/google_verifiedaccess1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-verifiedaccess1/5.0.3+20230117/google_verifiedaccess1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -138,25 +138,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-verifi You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-verifiedaccess1/5.0.3+20230117/google_verifiedaccess1/client::Delegate) to the -[Method Builder](https://docs.rs/google-verifiedaccess1/5.0.3+20230117/google_verifiedaccess1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-verifiedaccess1/5.0.3+20230117/google_verifiedaccess1/client::Delegate) to the +[Method Builder](https://docs.rs/google-verifiedaccess1/5.0.3+20230117/google_verifiedaccess1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-verifiedaccess1/5.0.3+20230117/google_verifiedaccess1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-verifiedaccess1/5.0.3+20230117/google_verifiedaccess1/client::RequestValue) and -[decodable](https://docs.rs/google-verifiedaccess1/5.0.3+20230117/google_verifiedaccess1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-verifiedaccess1/5.0.3+20230117/google_verifiedaccess1/client::RequestValue) and +[decodable](https://docs.rs/google-verifiedaccess1/5.0.3+20230117/google_verifiedaccess1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-verifiedaccess1/5.0.3+20230117/google_verifiedaccess1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-verifiedaccess1/5.0.3+20230117/google_verifiedaccess1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -175,7 +175,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **verifiedaccess1** library was generated by Sebastian Thiel, and is placed +The **verifiedaccess1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/verifiedaccess1/src/api.rs b/gen/verifiedaccess1/src/api.rs index 7387a33f20..dc766497d8 100644 --- a/gen/verifiedaccess1/src/api.rs +++ b/gen/verifiedaccess1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// Verify your enterprise credentials Full, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use verifiedaccess1::{Verifiedaccess, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/verifiedaccess1/src/lib.rs b/gen/verifiedaccess1/src/lib.rs index b2c4726b44..2cefe7aeaf 100644 --- a/gen/verifiedaccess1/src/lib.rs +++ b/gen/verifiedaccess1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/verifiedaccess1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Verifiedaccess) ... +//! Handle the following *Resources* with ease from the central [hub](Verifiedaccess) ... //! //! * [challenge](api::Challenge) //! * [*create*](api::ChallengeCreateCall) and [*verify*](api::ChallengeVerifyCall) @@ -50,8 +50,8 @@ //! let r = hub.challenge().verify(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -80,12 +80,12 @@ //! use std::default::Default; //! use verifiedaccess1::{Verifiedaccess, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -126,10 +126,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -139,25 +139,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/versionhistory1/README.md b/gen/versionhistory1/README.md index 60f0f238ce..f90327d205 100644 --- a/gen/versionhistory1/README.md +++ b/gen/versionhistory1/README.md @@ -11,7 +11,7 @@ Everything else about the *Version History* *v1* API can be found at the [official documentation site](https://developers.chrome.com/versionhistory). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-versionhistory1/5.0.3+20230123/google_versionhistory1/VersionHistory) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-versionhistory1/5.0.3+20230123/google_versionhistory1/VersionHistory) ... * [platforms](https://docs.rs/google-versionhistory1/5.0.3+20230123/google_versionhistory1/api::Platform) * [*channels list*](https://docs.rs/google-versionhistory1/5.0.3+20230123/google_versionhistory1/api::PlatformChannelListCall), [*channels versions list*](https://docs.rs/google-versionhistory1/5.0.3+20230123/google_versionhistory1/api::PlatformChannelVersionListCall), [*channels versions releases list*](https://docs.rs/google-versionhistory1/5.0.3+20230123/google_versionhistory1/api::PlatformChannelVersionReleaseListCall) and [*list*](https://docs.rs/google-versionhistory1/5.0.3+20230123/google_versionhistory1/api::PlatformListCall) @@ -53,8 +53,8 @@ let r = hub.platforms().channels_list(...).doit().await let r = hub.platforms().list(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -81,12 +81,12 @@ use versionhistory1::{Result, Error}; use std::default::Default; use versionhistory1::{VersionHistory, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -126,10 +126,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-versionhistory1/5.0.3+20230123/google_versionhistory1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-versionhistory1/5.0.3+20230123/google_versionhistory1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -139,25 +139,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-versio You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-versionhistory1/5.0.3+20230123/google_versionhistory1/client::Delegate) to the -[Method Builder](https://docs.rs/google-versionhistory1/5.0.3+20230123/google_versionhistory1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-versionhistory1/5.0.3+20230123/google_versionhistory1/client::Delegate) to the +[Method Builder](https://docs.rs/google-versionhistory1/5.0.3+20230123/google_versionhistory1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-versionhistory1/5.0.3+20230123/google_versionhistory1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-versionhistory1/5.0.3+20230123/google_versionhistory1/client::RequestValue) and -[decodable](https://docs.rs/google-versionhistory1/5.0.3+20230123/google_versionhistory1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-versionhistory1/5.0.3+20230123/google_versionhistory1/client::RequestValue) and +[decodable](https://docs.rs/google-versionhistory1/5.0.3+20230123/google_versionhistory1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-versionhistory1/5.0.3+20230123/google_versionhistory1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-versionhistory1/5.0.3+20230123/google_versionhistory1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -176,7 +176,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **versionhistory1** library was generated by Sebastian Thiel, and is placed +The **versionhistory1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/versionhistory1/src/api.rs b/gen/versionhistory1/src/api.rs index f494899da6..005d202799 100644 --- a/gen/versionhistory1/src/api.rs +++ b/gen/versionhistory1/src/api.rs @@ -42,12 +42,12 @@ use crate::{client, client::GetToken, client::serde_with}; /// use std::default::Default; /// use versionhistory1::{VersionHistory, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/versionhistory1/src/lib.rs b/gen/versionhistory1/src/lib.rs index 328b16e83c..aaf042e417 100644 --- a/gen/versionhistory1/src/lib.rs +++ b/gen/versionhistory1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/versionhistory1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](VersionHistory) ... +//! Handle the following *Resources* with ease from the central [hub](VersionHistory) ... //! //! * [platforms](api::Platform) //! * [*channels list*](api::PlatformChannelListCall), [*channels versions list*](api::PlatformChannelVersionListCall), [*channels versions releases list*](api::PlatformChannelVersionReleaseListCall) and [*list*](api::PlatformListCall) @@ -53,8 +53,8 @@ //! let r = hub.platforms().list(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -82,12 +82,12 @@ //! use std::default::Default; //! use versionhistory1::{VersionHistory, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -127,10 +127,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -140,25 +140,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/videointelligence1/README.md b/gen/videointelligence1/README.md index ee3993d140..1e92b714f1 100644 --- a/gen/videointelligence1/README.md +++ b/gen/videointelligence1/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Video Intelligence* *v1* API can be found at th [official documentation site](https://cloud.google.com/video-intelligence/docs/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-videointelligence1/5.0.3+20230119/google_videointelligence1/CloudVideoIntelligence) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-videointelligence1/5.0.3+20230119/google_videointelligence1/CloudVideoIntelligence) ... * operations * [*projects locations operations cancel*](https://docs.rs/google-videointelligence1/5.0.3+20230119/google_videointelligence1/api::OperationProjectLocationOperationCancelCall), [*projects locations operations delete*](https://docs.rs/google-videointelligence1/5.0.3+20230119/google_videointelligence1/api::OperationProjectLocationOperationDeleteCall) and [*projects locations operations get*](https://docs.rs/google-videointelligence1/5.0.3+20230119/google_videointelligence1/api::OperationProjectLocationOperationGetCall) @@ -57,8 +57,8 @@ let r = hub.projects().locations_operations_cancel(...).doit().await let r = hub.projects().locations_operations_delete(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -86,12 +86,12 @@ use videointelligence1::{Result, Error}; use std::default::Default; use videointelligence1::{CloudVideoIntelligence, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -132,10 +132,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-videointelligence1/5.0.3+20230119/google_videointelligence1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-videointelligence1/5.0.3+20230119/google_videointelligence1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -145,25 +145,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-videoi You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-videointelligence1/5.0.3+20230119/google_videointelligence1/client::Delegate) to the -[Method Builder](https://docs.rs/google-videointelligence1/5.0.3+20230119/google_videointelligence1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-videointelligence1/5.0.3+20230119/google_videointelligence1/client::Delegate) to the +[Method Builder](https://docs.rs/google-videointelligence1/5.0.3+20230119/google_videointelligence1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-videointelligence1/5.0.3+20230119/google_videointelligence1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-videointelligence1/5.0.3+20230119/google_videointelligence1/client::RequestValue) and -[decodable](https://docs.rs/google-videointelligence1/5.0.3+20230119/google_videointelligence1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-videointelligence1/5.0.3+20230119/google_videointelligence1/client::RequestValue) and +[decodable](https://docs.rs/google-videointelligence1/5.0.3+20230119/google_videointelligence1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-videointelligence1/5.0.3+20230119/google_videointelligence1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-videointelligence1/5.0.3+20230119/google_videointelligence1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -182,7 +182,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **videointelligence1** library was generated by Sebastian Thiel, and is placed +The **videointelligence1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/videointelligence1/src/api.rs b/gen/videointelligence1/src/api.rs index 5f4286d044..82ba176ce7 100644 --- a/gen/videointelligence1/src/api.rs +++ b/gen/videointelligence1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use videointelligence1::{CloudVideoIntelligence, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/videointelligence1/src/lib.rs b/gen/videointelligence1/src/lib.rs index 963d297f16..df60f43473 100644 --- a/gen/videointelligence1/src/lib.rs +++ b/gen/videointelligence1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/videointelligence1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudVideoIntelligence) ... +//! Handle the following *Resources* with ease from the central [hub](CloudVideoIntelligence) ... //! //! * operations //! * [*projects locations operations cancel*](api::OperationProjectLocationOperationCancelCall), [*projects locations operations delete*](api::OperationProjectLocationOperationDeleteCall) and [*projects locations operations get*](api::OperationProjectLocationOperationGetCall) @@ -57,8 +57,8 @@ //! let r = hub.projects().locations_operations_delete(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -87,12 +87,12 @@ //! use std::default::Default; //! use videointelligence1::{CloudVideoIntelligence, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -133,10 +133,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -146,25 +146,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/videointelligence1_beta1/README.md b/gen/videointelligence1_beta1/README.md index 8a11f3bfcc..835838e52d 100644 --- a/gen/videointelligence1_beta1/README.md +++ b/gen/videointelligence1_beta1/README.md @@ -11,7 +11,7 @@ Everything else about the *Cloud Video Intelligence* *v1_beta1* API can be found [official documentation site](https://cloud.google.com/video-intelligence/docs/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-videointelligence1_beta1/5.0.3+20171122/google_videointelligence1_beta1/CloudVideoIntelligence) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-videointelligence1_beta1/5.0.3+20171122/google_videointelligence1_beta1/CloudVideoIntelligence) ... * videos * [*annotate*](https://docs.rs/google-videointelligence1_beta1/5.0.3+20171122/google_videointelligence1_beta1/api::VideoAnnotateCall) @@ -50,8 +50,8 @@ Or specifically ... let r = hub.videos().annotate(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -79,12 +79,12 @@ use videointelligence1_beta1::{Result, Error}; use std::default::Default; use videointelligence1_beta1::{CloudVideoIntelligence, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -125,10 +125,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-videointelligence1_beta1/5.0.3+20171122/google_videointelligence1_beta1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-videointelligence1_beta1/5.0.3+20171122/google_videointelligence1_beta1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -138,25 +138,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-videoi You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-videointelligence1_beta1/5.0.3+20171122/google_videointelligence1_beta1/client::Delegate) to the -[Method Builder](https://docs.rs/google-videointelligence1_beta1/5.0.3+20171122/google_videointelligence1_beta1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-videointelligence1_beta1/5.0.3+20171122/google_videointelligence1_beta1/client::Delegate) to the +[Method Builder](https://docs.rs/google-videointelligence1_beta1/5.0.3+20171122/google_videointelligence1_beta1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-videointelligence1_beta1/5.0.3+20171122/google_videointelligence1_beta1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-videointelligence1_beta1/5.0.3+20171122/google_videointelligence1_beta1/client::RequestValue) and -[decodable](https://docs.rs/google-videointelligence1_beta1/5.0.3+20171122/google_videointelligence1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-videointelligence1_beta1/5.0.3+20171122/google_videointelligence1_beta1/client::RequestValue) and +[decodable](https://docs.rs/google-videointelligence1_beta1/5.0.3+20171122/google_videointelligence1_beta1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-videointelligence1_beta1/5.0.3+20171122/google_videointelligence1_beta1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-videointelligence1_beta1/5.0.3+20171122/google_videointelligence1_beta1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -175,7 +175,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **videointelligence1_beta1** library was generated by Sebastian Thiel, and is placed +The **videointelligence1_beta1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/videointelligence1_beta1/src/api.rs b/gen/videointelligence1_beta1/src/api.rs index 7b33278c82..abeb9fb976 100644 --- a/gen/videointelligence1_beta1/src/api.rs +++ b/gen/videointelligence1_beta1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage your data across Google Cloud Platform services CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use videointelligence1_beta1::{CloudVideoIntelligence, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/videointelligence1_beta1/src/lib.rs b/gen/videointelligence1_beta1/src/lib.rs index ce1276e024..743d1827ae 100644 --- a/gen/videointelligence1_beta1/src/lib.rs +++ b/gen/videointelligence1_beta1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/videointelligence1_beta1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](CloudVideoIntelligence) ... +//! Handle the following *Resources* with ease from the central [hub](CloudVideoIntelligence) ... //! //! * videos //! * [*annotate*](api::VideoAnnotateCall) @@ -50,8 +50,8 @@ //! let r = hub.videos().annotate(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -80,12 +80,12 @@ //! use std::default::Default; //! use videointelligence1_beta1::{CloudVideoIntelligence, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -126,10 +126,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -139,25 +139,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/vision1/README.md b/gen/vision1/README.md index e5c0924604..4b908fdac4 100644 --- a/gen/vision1/README.md +++ b/gen/vision1/README.md @@ -11,7 +11,7 @@ Everything else about the *Vision* *v1* API can be found at the [official documentation site](https://cloud.google.com/vision/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-vision1/5.0.3+20230113/google_vision1/Vision) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-vision1/5.0.3+20230113/google_vision1/Vision) ... * files * [*annotate*](https://docs.rs/google-vision1/5.0.3+20230113/google_vision1/api::FileAnnotateCall) and [*async batch annotate*](https://docs.rs/google-vision1/5.0.3+20230113/google_vision1/api::FileAsyncBatchAnnotateCall) @@ -72,8 +72,8 @@ let r = hub.projects().locations_products_purge(...).doit().await let r = hub.projects().operations_get(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -100,12 +100,12 @@ use vision1::{Result, Error}; use std::default::Default; use vision1::{Vision, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -144,10 +144,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-vision1/5.0.3+20230113/google_vision1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-vision1/5.0.3+20230113/google_vision1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -157,25 +157,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-vision You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-vision1/5.0.3+20230113/google_vision1/client::Delegate) to the -[Method Builder](https://docs.rs/google-vision1/5.0.3+20230113/google_vision1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-vision1/5.0.3+20230113/google_vision1/client::Delegate) to the +[Method Builder](https://docs.rs/google-vision1/5.0.3+20230113/google_vision1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-vision1/5.0.3+20230113/google_vision1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-vision1/5.0.3+20230113/google_vision1/client::RequestValue) and -[decodable](https://docs.rs/google-vision1/5.0.3+20230113/google_vision1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-vision1/5.0.3+20230113/google_vision1/client::RequestValue) and +[decodable](https://docs.rs/google-vision1/5.0.3+20230113/google_vision1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-vision1/5.0.3+20230113/google_vision1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-vision1/5.0.3+20230113/google_vision1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -194,7 +194,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **vision1** library was generated by Sebastian Thiel, and is placed +The **vision1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/vision1/src/api.rs b/gen/vision1/src/api.rs index c6f3eefccf..7788abd640 100644 --- a/gen/vision1/src/api.rs +++ b/gen/vision1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -68,12 +68,12 @@ impl Default for Scope { /// use std::default::Default; /// use vision1::{Vision, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/vision1/src/lib.rs b/gen/vision1/src/lib.rs index 55cea93dbb..6c62c4997f 100644 --- a/gen/vision1/src/lib.rs +++ b/gen/vision1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/vision1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Vision) ... +//! Handle the following *Resources* with ease from the central [hub](Vision) ... //! //! * files //! * [*annotate*](api::FileAnnotateCall) and [*async batch annotate*](api::FileAsyncBatchAnnotateCall) @@ -72,8 +72,8 @@ //! let r = hub.projects().operations_get(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -101,12 +101,12 @@ //! use std::default::Default; //! use vision1::{Vision, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -145,10 +145,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -158,25 +158,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/vmmigration1/README.md b/gen/vmmigration1/README.md index 412cb8b4c8..1266833adb 100644 --- a/gen/vmmigration1/README.md +++ b/gen/vmmigration1/README.md @@ -11,7 +11,7 @@ Everything else about the *VM Migration Service* *v1* API can be found at the [official documentation site](https://cloud.google.com/migrate/virtual-machines). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/VMMigrationService) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/VMMigrationService) ... * projects * [*locations get*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationGetCall), [*locations groups add group migration*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationGroupAddGroupMigrationCall), [*locations groups create*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationGroupCreateCall), [*locations groups delete*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationGroupDeleteCall), [*locations groups get*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationGroupGetCall), [*locations groups list*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationGroupListCall), [*locations groups patch*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationGroupPatchCall), [*locations groups remove group migration*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationGroupRemoveGroupMigrationCall), [*locations list*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationListCall), [*locations operations cancel*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationOperationCancelCall), [*locations operations delete*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationOperationDeleteCall), [*locations operations get*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationOperationGetCall), [*locations operations list*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationOperationListCall), [*locations sources create*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationSourceCreateCall), [*locations sources datacenter connectors create*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationSourceDatacenterConnectorCreateCall), [*locations sources datacenter connectors delete*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationSourceDatacenterConnectorDeleteCall), [*locations sources datacenter connectors get*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationSourceDatacenterConnectorGetCall), [*locations sources datacenter connectors list*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationSourceDatacenterConnectorListCall), [*locations sources datacenter connectors upgrade appliance*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationSourceDatacenterConnectorUpgradeApplianceCall), [*locations sources delete*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationSourceDeleteCall), [*locations sources fetch inventory*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationSourceFetchInventoryCall), [*locations sources get*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationSourceGetCall), [*locations sources list*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationSourceListCall), [*locations sources migrating vms clone jobs cancel*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationSourceMigratingVmCloneJobCancelCall), [*locations sources migrating vms clone jobs create*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationSourceMigratingVmCloneJobCreateCall), [*locations sources migrating vms clone jobs get*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationSourceMigratingVmCloneJobGetCall), [*locations sources migrating vms clone jobs list*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationSourceMigratingVmCloneJobListCall), [*locations sources migrating vms create*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationSourceMigratingVmCreateCall), [*locations sources migrating vms cutover jobs cancel*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationSourceMigratingVmCutoverJobCancelCall), [*locations sources migrating vms cutover jobs create*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationSourceMigratingVmCutoverJobCreateCall), [*locations sources migrating vms cutover jobs get*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationSourceMigratingVmCutoverJobGetCall), [*locations sources migrating vms cutover jobs list*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationSourceMigratingVmCutoverJobListCall), [*locations sources migrating vms delete*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationSourceMigratingVmDeleteCall), [*locations sources migrating vms finalize migration*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationSourceMigratingVmFinalizeMigrationCall), [*locations sources migrating vms get*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationSourceMigratingVmGetCall), [*locations sources migrating vms list*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationSourceMigratingVmListCall), [*locations sources migrating vms patch*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationSourceMigratingVmPatchCall), [*locations sources migrating vms pause migration*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationSourceMigratingVmPauseMigrationCall), [*locations sources migrating vms replication cycles get*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationSourceMigratingVmReplicationCycleGetCall), [*locations sources migrating vms replication cycles list*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationSourceMigratingVmReplicationCycleListCall), [*locations sources migrating vms resume migration*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationSourceMigratingVmResumeMigrationCall), [*locations sources migrating vms start migration*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationSourceMigratingVmStartMigrationCall), [*locations sources patch*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationSourcePatchCall), [*locations sources utilization reports create*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationSourceUtilizationReportCreateCall), [*locations sources utilization reports delete*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationSourceUtilizationReportDeleteCall), [*locations sources utilization reports get*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationSourceUtilizationReportGetCall), [*locations sources utilization reports list*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationSourceUtilizationReportListCall), [*locations target projects create*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationTargetProjectCreateCall), [*locations target projects delete*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationTargetProjectDeleteCall), [*locations target projects get*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationTargetProjectGetCall), [*locations target projects list*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationTargetProjectListCall) and [*locations target projects patch*](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/api::ProjectLocationTargetProjectPatchCall) @@ -77,8 +77,8 @@ let r = hub.projects().locations_target_projects_delete(...).doit().await let r = hub.projects().locations_target_projects_patch(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -106,12 +106,12 @@ use vmmigration1::{Result, Error}; use std::default::Default; use vmmigration1::{VMMigrationService, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -154,10 +154,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -167,25 +167,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-vmmigr You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/client::Delegate) to the -[Method Builder](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/client::Delegate) to the +[Method Builder](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/client::RequestValue) and -[decodable](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/client::RequestValue) and +[decodable](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-vmmigration1/5.0.3+20230119/google_vmmigration1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -204,7 +204,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **vmmigration1** library was generated by Sebastian Thiel, and is placed +The **vmmigration1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/vmmigration1/src/api.rs b/gen/vmmigration1/src/api.rs index 7345a83992..6b6e5d3a68 100644 --- a/gen/vmmigration1/src/api.rs +++ b/gen/vmmigration1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use vmmigration1::{VMMigrationService, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/vmmigration1/src/lib.rs b/gen/vmmigration1/src/lib.rs index f3905a5bf9..7e4112fbf2 100644 --- a/gen/vmmigration1/src/lib.rs +++ b/gen/vmmigration1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/vmmigration1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](VMMigrationService) ... +//! Handle the following *Resources* with ease from the central [hub](VMMigrationService) ... //! //! * projects //! * [*locations get*](api::ProjectLocationGetCall), [*locations groups add group migration*](api::ProjectLocationGroupAddGroupMigrationCall), [*locations groups create*](api::ProjectLocationGroupCreateCall), [*locations groups delete*](api::ProjectLocationGroupDeleteCall), [*locations groups get*](api::ProjectLocationGroupGetCall), [*locations groups list*](api::ProjectLocationGroupListCall), [*locations groups patch*](api::ProjectLocationGroupPatchCall), [*locations groups remove group migration*](api::ProjectLocationGroupRemoveGroupMigrationCall), [*locations list*](api::ProjectLocationListCall), [*locations operations cancel*](api::ProjectLocationOperationCancelCall), [*locations operations delete*](api::ProjectLocationOperationDeleteCall), [*locations operations get*](api::ProjectLocationOperationGetCall), [*locations operations list*](api::ProjectLocationOperationListCall), [*locations sources create*](api::ProjectLocationSourceCreateCall), [*locations sources datacenter connectors create*](api::ProjectLocationSourceDatacenterConnectorCreateCall), [*locations sources datacenter connectors delete*](api::ProjectLocationSourceDatacenterConnectorDeleteCall), [*locations sources datacenter connectors get*](api::ProjectLocationSourceDatacenterConnectorGetCall), [*locations sources datacenter connectors list*](api::ProjectLocationSourceDatacenterConnectorListCall), [*locations sources datacenter connectors upgrade appliance*](api::ProjectLocationSourceDatacenterConnectorUpgradeApplianceCall), [*locations sources delete*](api::ProjectLocationSourceDeleteCall), [*locations sources fetch inventory*](api::ProjectLocationSourceFetchInventoryCall), [*locations sources get*](api::ProjectLocationSourceGetCall), [*locations sources list*](api::ProjectLocationSourceListCall), [*locations sources migrating vms clone jobs cancel*](api::ProjectLocationSourceMigratingVmCloneJobCancelCall), [*locations sources migrating vms clone jobs create*](api::ProjectLocationSourceMigratingVmCloneJobCreateCall), [*locations sources migrating vms clone jobs get*](api::ProjectLocationSourceMigratingVmCloneJobGetCall), [*locations sources migrating vms clone jobs list*](api::ProjectLocationSourceMigratingVmCloneJobListCall), [*locations sources migrating vms create*](api::ProjectLocationSourceMigratingVmCreateCall), [*locations sources migrating vms cutover jobs cancel*](api::ProjectLocationSourceMigratingVmCutoverJobCancelCall), [*locations sources migrating vms cutover jobs create*](api::ProjectLocationSourceMigratingVmCutoverJobCreateCall), [*locations sources migrating vms cutover jobs get*](api::ProjectLocationSourceMigratingVmCutoverJobGetCall), [*locations sources migrating vms cutover jobs list*](api::ProjectLocationSourceMigratingVmCutoverJobListCall), [*locations sources migrating vms delete*](api::ProjectLocationSourceMigratingVmDeleteCall), [*locations sources migrating vms finalize migration*](api::ProjectLocationSourceMigratingVmFinalizeMigrationCall), [*locations sources migrating vms get*](api::ProjectLocationSourceMigratingVmGetCall), [*locations sources migrating vms list*](api::ProjectLocationSourceMigratingVmListCall), [*locations sources migrating vms patch*](api::ProjectLocationSourceMigratingVmPatchCall), [*locations sources migrating vms pause migration*](api::ProjectLocationSourceMigratingVmPauseMigrationCall), [*locations sources migrating vms replication cycles get*](api::ProjectLocationSourceMigratingVmReplicationCycleGetCall), [*locations sources migrating vms replication cycles list*](api::ProjectLocationSourceMigratingVmReplicationCycleListCall), [*locations sources migrating vms resume migration*](api::ProjectLocationSourceMigratingVmResumeMigrationCall), [*locations sources migrating vms start migration*](api::ProjectLocationSourceMigratingVmStartMigrationCall), [*locations sources patch*](api::ProjectLocationSourcePatchCall), [*locations sources utilization reports create*](api::ProjectLocationSourceUtilizationReportCreateCall), [*locations sources utilization reports delete*](api::ProjectLocationSourceUtilizationReportDeleteCall), [*locations sources utilization reports get*](api::ProjectLocationSourceUtilizationReportGetCall), [*locations sources utilization reports list*](api::ProjectLocationSourceUtilizationReportListCall), [*locations target projects create*](api::ProjectLocationTargetProjectCreateCall), [*locations target projects delete*](api::ProjectLocationTargetProjectDeleteCall), [*locations target projects get*](api::ProjectLocationTargetProjectGetCall), [*locations target projects list*](api::ProjectLocationTargetProjectListCall) and [*locations target projects patch*](api::ProjectLocationTargetProjectPatchCall) @@ -77,8 +77,8 @@ //! let r = hub.projects().locations_target_projects_patch(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -107,12 +107,12 @@ //! use std::default::Default; //! use vmmigration1::{VMMigrationService, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -155,10 +155,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -168,25 +168,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/walletobjects1/README.md b/gen/walletobjects1/README.md index af6b6038b7..ff7bd2630e 100644 --- a/gen/walletobjects1/README.md +++ b/gen/walletobjects1/README.md @@ -11,7 +11,7 @@ Everything else about the *Walletobjects* *v1* API can be found at the [official documentation site](https://developers.google.com/pay/passes). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-walletobjects1/5.0.3+20230124/google_walletobjects1/Walletobjects) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-walletobjects1/5.0.3+20230124/google_walletobjects1/Walletobjects) ... * eventticketclass * [*addmessage*](https://docs.rs/google-walletobjects1/5.0.3+20230124/google_walletobjects1/api::EventticketclasAddmessageCall), [*get*](https://docs.rs/google-walletobjects1/5.0.3+20230124/google_walletobjects1/api::EventticketclasGetCall), [*insert*](https://docs.rs/google-walletobjects1/5.0.3+20230124/google_walletobjects1/api::EventticketclasInsertCall), [*list*](https://docs.rs/google-walletobjects1/5.0.3+20230124/google_walletobjects1/api::EventticketclasListCall), [*patch*](https://docs.rs/google-walletobjects1/5.0.3+20230124/google_walletobjects1/api::EventticketclasPatchCall) and [*update*](https://docs.rs/google-walletobjects1/5.0.3+20230124/google_walletobjects1/api::EventticketclasUpdateCall) @@ -103,8 +103,8 @@ let r = hub.transitclass().addmessage(...).doit().await let r = hub.transitobject().addmessage(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -132,12 +132,12 @@ use walletobjects1::{Result, Error}; use std::default::Default; use walletobjects1::{Walletobjects, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -178,10 +178,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-walletobjects1/5.0.3+20230124/google_walletobjects1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-walletobjects1/5.0.3+20230124/google_walletobjects1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -191,25 +191,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-wallet You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-walletobjects1/5.0.3+20230124/google_walletobjects1/client::Delegate) to the -[Method Builder](https://docs.rs/google-walletobjects1/5.0.3+20230124/google_walletobjects1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-walletobjects1/5.0.3+20230124/google_walletobjects1/client::Delegate) to the +[Method Builder](https://docs.rs/google-walletobjects1/5.0.3+20230124/google_walletobjects1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-walletobjects1/5.0.3+20230124/google_walletobjects1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-walletobjects1/5.0.3+20230124/google_walletobjects1/client::RequestValue) and -[decodable](https://docs.rs/google-walletobjects1/5.0.3+20230124/google_walletobjects1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-walletobjects1/5.0.3+20230124/google_walletobjects1/client::RequestValue) and +[decodable](https://docs.rs/google-walletobjects1/5.0.3+20230124/google_walletobjects1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-walletobjects1/5.0.3+20230124/google_walletobjects1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-walletobjects1/5.0.3+20230124/google_walletobjects1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -228,7 +228,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **walletobjects1** library was generated by Sebastian Thiel, and is placed +The **walletobjects1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/walletobjects1/src/api.rs b/gen/walletobjects1/src/api.rs index ee5628e4e3..713f871c7b 100644 --- a/gen/walletobjects1/src/api.rs +++ b/gen/walletobjects1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// Private Service: https://www.googleapis.com/auth/wallet_object.issuer WalletObjectIssuer, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use walletobjects1::{Walletobjects, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/walletobjects1/src/lib.rs b/gen/walletobjects1/src/lib.rs index ffb2242461..5fb09cde38 100644 --- a/gen/walletobjects1/src/lib.rs +++ b/gen/walletobjects1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/walletobjects1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Walletobjects) ... +//! Handle the following *Resources* with ease from the central [hub](Walletobjects) ... //! //! * eventticketclass //! * [*addmessage*](api::EventticketclasAddmessageCall), [*get*](api::EventticketclasGetCall), [*insert*](api::EventticketclasInsertCall), [*list*](api::EventticketclasListCall), [*patch*](api::EventticketclasPatchCall) and [*update*](api::EventticketclasUpdateCall) @@ -103,8 +103,8 @@ //! let r = hub.transitobject().addmessage(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -133,12 +133,12 @@ //! use std::default::Default; //! use walletobjects1::{Walletobjects, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -179,10 +179,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -192,25 +192,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/webfonts1/README.md b/gen/webfonts1/README.md index b35d49ff0a..2ea1a974da 100644 --- a/gen/webfonts1/README.md +++ b/gen/webfonts1/README.md @@ -11,7 +11,7 @@ Everything else about the *Webfonts* *v1* API can be found at the [official documentation site](https://developers.google.com/fonts/docs/developer_api). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-webfonts1/5.0.3+20221206/google_webfonts1/Webfonts) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-webfonts1/5.0.3+20221206/google_webfonts1/Webfonts) ... * [webfonts](https://docs.rs/google-webfonts1/5.0.3+20221206/google_webfonts1/api::Webfont) * [*list*](https://docs.rs/google-webfonts1/5.0.3+20221206/google_webfonts1/api::WebfontListCall) @@ -50,8 +50,8 @@ Or specifically ... let r = hub.webfonts().list(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -78,12 +78,12 @@ use webfonts1::{Result, Error}; use std::default::Default; use webfonts1::{Webfonts, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -120,10 +120,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-webfonts1/5.0.3+20221206/google_webfonts1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-webfonts1/5.0.3+20221206/google_webfonts1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -133,25 +133,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-webfon You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-webfonts1/5.0.3+20221206/google_webfonts1/client::Delegate) to the -[Method Builder](https://docs.rs/google-webfonts1/5.0.3+20221206/google_webfonts1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-webfonts1/5.0.3+20221206/google_webfonts1/client::Delegate) to the +[Method Builder](https://docs.rs/google-webfonts1/5.0.3+20221206/google_webfonts1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-webfonts1/5.0.3+20221206/google_webfonts1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-webfonts1/5.0.3+20221206/google_webfonts1/client::RequestValue) and -[decodable](https://docs.rs/google-webfonts1/5.0.3+20221206/google_webfonts1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-webfonts1/5.0.3+20221206/google_webfonts1/client::RequestValue) and +[decodable](https://docs.rs/google-webfonts1/5.0.3+20221206/google_webfonts1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-webfonts1/5.0.3+20221206/google_webfonts1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-webfonts1/5.0.3+20221206/google_webfonts1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -170,7 +170,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **webfonts1** library was generated by Sebastian Thiel, and is placed +The **webfonts1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/webfonts1/src/api.rs b/gen/webfonts1/src/api.rs index e7fa95e2d3..1d0e81c89d 100644 --- a/gen/webfonts1/src/api.rs +++ b/gen/webfonts1/src/api.rs @@ -42,12 +42,12 @@ use crate::{client, client::GetToken, client::serde_with}; /// use std::default::Default; /// use webfonts1::{Webfonts, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/webfonts1/src/lib.rs b/gen/webfonts1/src/lib.rs index 6e203d9771..0beb6ba719 100644 --- a/gen/webfonts1/src/lib.rs +++ b/gen/webfonts1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/webfonts1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Webfonts) ... +//! Handle the following *Resources* with ease from the central [hub](Webfonts) ... //! //! * [webfonts](api::Webfont) //! * [*list*](api::WebfontListCall) @@ -50,8 +50,8 @@ //! let r = hub.webfonts().list(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -79,12 +79,12 @@ //! use std::default::Default; //! use webfonts1::{Webfonts, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -121,10 +121,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -134,25 +134,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/webmasters3/README.md b/gen/webmasters3/README.md index f64c19a66e..4fe0e95925 100644 --- a/gen/webmasters3/README.md +++ b/gen/webmasters3/README.md @@ -11,7 +11,7 @@ Everything else about the *webmasters* *v3* API can be found at the [official documentation site](https://developers.google.com/webmaster-tools/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-webmasters3/5.0.3+20190428/google_webmasters3/Webmasters) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-webmasters3/5.0.3+20190428/google_webmasters3/Webmasters) ... * searchanalytics * [*query*](https://docs.rs/google-webmasters3/5.0.3+20190428/google_webmasters3/api::SearchanalyticQueryCall) @@ -54,8 +54,8 @@ Or specifically ... let r = hub.searchanalytics().query(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -83,12 +83,12 @@ use webmasters3::{Result, Error}; use std::default::Default; use webmasters3::{Webmasters, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -129,10 +129,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-webmasters3/5.0.3+20190428/google_webmasters3/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-webmasters3/5.0.3+20190428/google_webmasters3/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -142,25 +142,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-webmas You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-webmasters3/5.0.3+20190428/google_webmasters3/client::Delegate) to the -[Method Builder](https://docs.rs/google-webmasters3/5.0.3+20190428/google_webmasters3/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-webmasters3/5.0.3+20190428/google_webmasters3/client::Delegate) to the +[Method Builder](https://docs.rs/google-webmasters3/5.0.3+20190428/google_webmasters3/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-webmasters3/5.0.3+20190428/google_webmasters3/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-webmasters3/5.0.3+20190428/google_webmasters3/client::RequestValue) and -[decodable](https://docs.rs/google-webmasters3/5.0.3+20190428/google_webmasters3/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-webmasters3/5.0.3+20190428/google_webmasters3/client::RequestValue) and +[decodable](https://docs.rs/google-webmasters3/5.0.3+20190428/google_webmasters3/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-webmasters3/5.0.3+20190428/google_webmasters3/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-webmasters3/5.0.3+20190428/google_webmasters3/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -179,7 +179,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **webmasters3** library was generated by Sebastian Thiel, and is placed +The **webmasters3** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/webmasters3/src/api.rs b/gen/webmasters3/src/api.rs index d04501bd8b..997a6d3f82 100644 --- a/gen/webmasters3/src/api.rs +++ b/gen/webmasters3/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View and manage Search Console data for your verified sites Full, @@ -69,12 +69,12 @@ impl Default for Scope { /// use std::default::Default; /// use webmasters3::{Webmasters, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/webmasters3/src/lib.rs b/gen/webmasters3/src/lib.rs index 6cd2068347..e131f57094 100644 --- a/gen/webmasters3/src/lib.rs +++ b/gen/webmasters3/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/webmasters3). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Webmasters) ... +//! Handle the following *Resources* with ease from the central [hub](Webmasters) ... //! //! * searchanalytics //! * [*query*](api::SearchanalyticQueryCall) @@ -54,8 +54,8 @@ //! let r = hub.searchanalytics().query(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -84,12 +84,12 @@ //! use std::default::Default; //! use webmasters3::{Webmasters, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -130,10 +130,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -143,25 +143,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/webrisk1/README.md b/gen/webrisk1/README.md index 6941c9e75f..524e1f4608 100644 --- a/gen/webrisk1/README.md +++ b/gen/webrisk1/README.md @@ -11,7 +11,7 @@ Everything else about the *Web Risk* *v1* API can be found at the [official documentation site](https://cloud.google.com/web-risk/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-webrisk1/5.0.3+20230121/google_webrisk1/WebRisk) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-webrisk1/5.0.3+20230121/google_webrisk1/WebRisk) ... * hashes * [*search*](https://docs.rs/google-webrisk1/5.0.3+20230121/google_webrisk1/api::HashSearchCall) @@ -57,8 +57,8 @@ let r = hub.projects().operations_get(...).doit().await let r = hub.projects().uris_submit(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -86,12 +86,12 @@ use webrisk1::{Result, Error}; use std::default::Default; use webrisk1::{WebRisk, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -132,10 +132,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-webrisk1/5.0.3+20230121/google_webrisk1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-webrisk1/5.0.3+20230121/google_webrisk1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -145,25 +145,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-webris You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-webrisk1/5.0.3+20230121/google_webrisk1/client::Delegate) to the -[Method Builder](https://docs.rs/google-webrisk1/5.0.3+20230121/google_webrisk1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-webrisk1/5.0.3+20230121/google_webrisk1/client::Delegate) to the +[Method Builder](https://docs.rs/google-webrisk1/5.0.3+20230121/google_webrisk1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-webrisk1/5.0.3+20230121/google_webrisk1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-webrisk1/5.0.3+20230121/google_webrisk1/client::RequestValue) and -[decodable](https://docs.rs/google-webrisk1/5.0.3+20230121/google_webrisk1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-webrisk1/5.0.3+20230121/google_webrisk1/client::RequestValue) and +[decodable](https://docs.rs/google-webrisk1/5.0.3+20230121/google_webrisk1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-webrisk1/5.0.3+20230121/google_webrisk1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-webrisk1/5.0.3+20230121/google_webrisk1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -182,7 +182,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **webrisk1** library was generated by Sebastian Thiel, and is placed +The **webrisk1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/webrisk1/src/api.rs b/gen/webrisk1/src/api.rs index 39884b311d..bd660e7120 100644 --- a/gen/webrisk1/src/api.rs +++ b/gen/webrisk1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use webrisk1::{WebRisk, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/webrisk1/src/lib.rs b/gen/webrisk1/src/lib.rs index 0c69e0ef39..9d3deef57e 100644 --- a/gen/webrisk1/src/lib.rs +++ b/gen/webrisk1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/webrisk1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](WebRisk) ... +//! Handle the following *Resources* with ease from the central [hub](WebRisk) ... //! //! * hashes //! * [*search*](api::HashSearchCall) @@ -57,8 +57,8 @@ //! let r = hub.projects().uris_submit(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -87,12 +87,12 @@ //! use std::default::Default; //! use webrisk1::{WebRisk, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -133,10 +133,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -146,25 +146,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/workflowexecutions1/README.md b/gen/workflowexecutions1/README.md index 23e63179fe..3f9c1813ba 100644 --- a/gen/workflowexecutions1/README.md +++ b/gen/workflowexecutions1/README.md @@ -11,7 +11,7 @@ Everything else about the *Workflow Executions* *v1* API can be found at the [official documentation site](https://cloud.google.com/workflows). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-workflowexecutions1/5.0.3+20230110/google_workflowexecutions1/WorkflowExecutions) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-workflowexecutions1/5.0.3+20230110/google_workflowexecutions1/WorkflowExecutions) ... * projects * [*locations workflows executions cancel*](https://docs.rs/google-workflowexecutions1/5.0.3+20230110/google_workflowexecutions1/api::ProjectLocationWorkflowExecutionCancelCall), [*locations workflows executions create*](https://docs.rs/google-workflowexecutions1/5.0.3+20230110/google_workflowexecutions1/api::ProjectLocationWorkflowExecutionCreateCall), [*locations workflows executions get*](https://docs.rs/google-workflowexecutions1/5.0.3+20230110/google_workflowexecutions1/api::ProjectLocationWorkflowExecutionGetCall), [*locations workflows executions list*](https://docs.rs/google-workflowexecutions1/5.0.3+20230110/google_workflowexecutions1/api::ProjectLocationWorkflowExecutionListCall) and [*locations workflows trigger pubsub execution*](https://docs.rs/google-workflowexecutions1/5.0.3+20230110/google_workflowexecutions1/api::ProjectLocationWorkflowTriggerPubsubExecutionCall) @@ -53,8 +53,8 @@ let r = hub.projects().locations_workflows_executions_get(...).doit().await let r = hub.projects().locations_workflows_trigger_pubsub_execution(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -82,12 +82,12 @@ use workflowexecutions1::{Result, Error}; use std::default::Default; use workflowexecutions1::{WorkflowExecutions, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -128,10 +128,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-workflowexecutions1/5.0.3+20230110/google_workflowexecutions1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-workflowexecutions1/5.0.3+20230110/google_workflowexecutions1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -141,25 +141,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-workfl You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-workflowexecutions1/5.0.3+20230110/google_workflowexecutions1/client::Delegate) to the -[Method Builder](https://docs.rs/google-workflowexecutions1/5.0.3+20230110/google_workflowexecutions1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-workflowexecutions1/5.0.3+20230110/google_workflowexecutions1/client::Delegate) to the +[Method Builder](https://docs.rs/google-workflowexecutions1/5.0.3+20230110/google_workflowexecutions1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-workflowexecutions1/5.0.3+20230110/google_workflowexecutions1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-workflowexecutions1/5.0.3+20230110/google_workflowexecutions1/client::RequestValue) and -[decodable](https://docs.rs/google-workflowexecutions1/5.0.3+20230110/google_workflowexecutions1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-workflowexecutions1/5.0.3+20230110/google_workflowexecutions1/client::RequestValue) and +[decodable](https://docs.rs/google-workflowexecutions1/5.0.3+20230110/google_workflowexecutions1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-workflowexecutions1/5.0.3+20230110/google_workflowexecutions1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-workflowexecutions1/5.0.3+20230110/google_workflowexecutions1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -178,7 +178,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **workflowexecutions1** library was generated by Sebastian Thiel, and is placed +The **workflowexecutions1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/workflowexecutions1/src/api.rs b/gen/workflowexecutions1/src/api.rs index 7704437b16..1d95676517 100644 --- a/gen/workflowexecutions1/src/api.rs +++ b/gen/workflowexecutions1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use workflowexecutions1::{WorkflowExecutions, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/workflowexecutions1/src/lib.rs b/gen/workflowexecutions1/src/lib.rs index f1f1dca14c..da8e47993d 100644 --- a/gen/workflowexecutions1/src/lib.rs +++ b/gen/workflowexecutions1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/workflowexecutions1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](WorkflowExecutions) ... +//! Handle the following *Resources* with ease from the central [hub](WorkflowExecutions) ... //! //! * projects //! * [*locations workflows executions cancel*](api::ProjectLocationWorkflowExecutionCancelCall), [*locations workflows executions create*](api::ProjectLocationWorkflowExecutionCreateCall), [*locations workflows executions get*](api::ProjectLocationWorkflowExecutionGetCall), [*locations workflows executions list*](api::ProjectLocationWorkflowExecutionListCall) and [*locations workflows trigger pubsub execution*](api::ProjectLocationWorkflowTriggerPubsubExecutionCall) @@ -53,8 +53,8 @@ //! let r = hub.projects().locations_workflows_trigger_pubsub_execution(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -83,12 +83,12 @@ //! use std::default::Default; //! use workflowexecutions1::{WorkflowExecutions, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -129,10 +129,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -142,25 +142,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/workflows1/README.md b/gen/workflows1/README.md index 506a81ece4..b72bb72f10 100644 --- a/gen/workflows1/README.md +++ b/gen/workflows1/README.md @@ -11,7 +11,7 @@ Everything else about the *Workflows* *v1* API can be found at the [official documentation site](https://cloud.google.com/workflows). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-workflows1/5.0.3+20230105/google_workflows1/Workflows) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-workflows1/5.0.3+20230105/google_workflows1/Workflows) ... * projects * [*locations get*](https://docs.rs/google-workflows1/5.0.3+20230105/google_workflows1/api::ProjectLocationGetCall), [*locations list*](https://docs.rs/google-workflows1/5.0.3+20230105/google_workflows1/api::ProjectLocationListCall), [*locations operations delete*](https://docs.rs/google-workflows1/5.0.3+20230105/google_workflows1/api::ProjectLocationOperationDeleteCall), [*locations operations get*](https://docs.rs/google-workflows1/5.0.3+20230105/google_workflows1/api::ProjectLocationOperationGetCall), [*locations operations list*](https://docs.rs/google-workflows1/5.0.3+20230105/google_workflows1/api::ProjectLocationOperationListCall), [*locations workflows create*](https://docs.rs/google-workflows1/5.0.3+20230105/google_workflows1/api::ProjectLocationWorkflowCreateCall), [*locations workflows delete*](https://docs.rs/google-workflows1/5.0.3+20230105/google_workflows1/api::ProjectLocationWorkflowDeleteCall), [*locations workflows get*](https://docs.rs/google-workflows1/5.0.3+20230105/google_workflows1/api::ProjectLocationWorkflowGetCall), [*locations workflows list*](https://docs.rs/google-workflows1/5.0.3+20230105/google_workflows1/api::ProjectLocationWorkflowListCall) and [*locations workflows patch*](https://docs.rs/google-workflows1/5.0.3+20230105/google_workflows1/api::ProjectLocationWorkflowPatchCall) @@ -53,8 +53,8 @@ let r = hub.projects().locations_workflows_delete(...).doit().await let r = hub.projects().locations_workflows_patch(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -82,12 +82,12 @@ use workflows1::{Result, Error}; use std::default::Default; use workflows1::{Workflows, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -129,10 +129,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-workflows1/5.0.3+20230105/google_workflows1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-workflows1/5.0.3+20230105/google_workflows1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -142,25 +142,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-workfl You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-workflows1/5.0.3+20230105/google_workflows1/client::Delegate) to the -[Method Builder](https://docs.rs/google-workflows1/5.0.3+20230105/google_workflows1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-workflows1/5.0.3+20230105/google_workflows1/client::Delegate) to the +[Method Builder](https://docs.rs/google-workflows1/5.0.3+20230105/google_workflows1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-workflows1/5.0.3+20230105/google_workflows1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-workflows1/5.0.3+20230105/google_workflows1/client::RequestValue) and -[decodable](https://docs.rs/google-workflows1/5.0.3+20230105/google_workflows1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-workflows1/5.0.3+20230105/google_workflows1/client::RequestValue) and +[decodable](https://docs.rs/google-workflows1/5.0.3+20230105/google_workflows1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-workflows1/5.0.3+20230105/google_workflows1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-workflows1/5.0.3+20230105/google_workflows1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -179,7 +179,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **workflows1** library was generated by Sebastian Thiel, and is placed +The **workflows1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/workflows1/src/api.rs b/gen/workflows1/src/api.rs index f22660ce04..61c3c8b1ac 100644 --- a/gen/workflows1/src/api.rs +++ b/gen/workflows1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. CloudPlatform, @@ -65,12 +65,12 @@ impl Default for Scope { /// use std::default::Default; /// use workflows1::{Workflows, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/workflows1/src/lib.rs b/gen/workflows1/src/lib.rs index 8be856d302..48d4a88588 100644 --- a/gen/workflows1/src/lib.rs +++ b/gen/workflows1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/workflows1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](Workflows) ... +//! Handle the following *Resources* with ease from the central [hub](Workflows) ... //! //! * projects //! * [*locations get*](api::ProjectLocationGetCall), [*locations list*](api::ProjectLocationListCall), [*locations operations delete*](api::ProjectLocationOperationDeleteCall), [*locations operations get*](api::ProjectLocationOperationGetCall), [*locations operations list*](api::ProjectLocationOperationListCall), [*locations workflows create*](api::ProjectLocationWorkflowCreateCall), [*locations workflows delete*](api::ProjectLocationWorkflowDeleteCall), [*locations workflows get*](api::ProjectLocationWorkflowGetCall), [*locations workflows list*](api::ProjectLocationWorkflowListCall) and [*locations workflows patch*](api::ProjectLocationWorkflowPatchCall) @@ -53,8 +53,8 @@ //! let r = hub.projects().locations_workflows_patch(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -83,12 +83,12 @@ //! use std::default::Default; //! use workflows1::{Workflows, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -130,10 +130,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -143,25 +143,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/youtube3/README.md b/gen/youtube3/README.md index c650cbd540..d25ecb06d4 100644 --- a/gen/youtube3/README.md +++ b/gen/youtube3/README.md @@ -11,7 +11,7 @@ Everything else about the *YouTube* *v3* API can be found at the [official documentation site](https://developers.google.com/youtube/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-youtube3/5.0.3+20230123/google_youtube3/YouTube) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-youtube3/5.0.3+20230123/google_youtube3/YouTube) ... * [abuse reports](https://docs.rs/google-youtube3/5.0.3+20230123/google_youtube3/api::AbuseReport) * [*insert*](https://docs.rs/google-youtube3/5.0.3+20230123/google_youtube3/api::AbuseReportInsertCall) @@ -127,8 +127,8 @@ let r = hub.videos().report_abuse(...).doit().await let r = hub.videos().update(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -155,12 +155,12 @@ use youtube3::{Result, Error}; use std::default::Default; use youtube3::{YouTube, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -208,10 +208,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-youtube3/5.0.3+20230123/google_youtube3/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-youtube3/5.0.3+20230123/google_youtube3/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -221,25 +221,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-youtub You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-youtube3/5.0.3+20230123/google_youtube3/client::Delegate) to the -[Method Builder](https://docs.rs/google-youtube3/5.0.3+20230123/google_youtube3/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-youtube3/5.0.3+20230123/google_youtube3/client::Delegate) to the +[Method Builder](https://docs.rs/google-youtube3/5.0.3+20230123/google_youtube3/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-youtube3/5.0.3+20230123/google_youtube3/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-youtube3/5.0.3+20230123/google_youtube3/client::RequestValue) and -[decodable](https://docs.rs/google-youtube3/5.0.3+20230123/google_youtube3/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-youtube3/5.0.3+20230123/google_youtube3/client::RequestValue) and +[decodable](https://docs.rs/google-youtube3/5.0.3+20230123/google_youtube3/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-youtube3/5.0.3+20230123/google_youtube3/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-youtube3/5.0.3+20230123/google_youtube3/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -258,7 +258,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **youtube3** library was generated by Sebastian Thiel, and is placed +The **youtube3** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/youtube3/src/api.rs b/gen/youtube3/src/api.rs index a3071263ae..0fc15e9e48 100644 --- a/gen/youtube3/src/api.rs +++ b/gen/youtube3/src/api.rs @@ -88,12 +88,12 @@ impl Default for Scope { /// use std::default::Default; /// use youtube3::{YouTube, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/youtube3/src/lib.rs b/gen/youtube3/src/lib.rs index 339d71e842..f4621a15e3 100644 --- a/gen/youtube3/src/lib.rs +++ b/gen/youtube3/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/youtube3). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](YouTube) ... +//! Handle the following *Resources* with ease from the central [hub](YouTube) ... //! //! * [abuse reports](api::AbuseReport) //! * [*insert*](api::AbuseReportInsertCall) @@ -127,8 +127,8 @@ //! let r = hub.videos().update(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -156,12 +156,12 @@ //! use std::default::Default; //! use youtube3::{YouTube, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -209,10 +209,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -222,25 +222,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/gen/youtubereporting1/README.md b/gen/youtubereporting1/README.md index 9d03336b35..bb4f62f4e6 100644 --- a/gen/youtubereporting1/README.md +++ b/gen/youtubereporting1/README.md @@ -11,7 +11,7 @@ Everything else about the *YouTube Reporting* *v1* API can be found at the [official documentation site](https://developers.google.com/youtube/reporting/v1/reports/). # Features -Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-youtubereporting1/5.0.3+20230123/google_youtubereporting1/YouTubeReporting) ... +Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-youtubereporting1/5.0.3+20230123/google_youtubereporting1/YouTubeReporting) ... * [jobs](https://docs.rs/google-youtubereporting1/5.0.3+20230123/google_youtubereporting1/api::Job) * [*create*](https://docs.rs/google-youtubereporting1/5.0.3+20230123/google_youtubereporting1/api::JobCreateCall), [*delete*](https://docs.rs/google-youtubereporting1/5.0.3+20230123/google_youtubereporting1/api::JobDeleteCall), [*get*](https://docs.rs/google-youtubereporting1/5.0.3+20230123/google_youtubereporting1/api::JobGetCall), [*list*](https://docs.rs/google-youtubereporting1/5.0.3+20230123/google_youtubereporting1/api::JobListCall), [*reports get*](https://docs.rs/google-youtubereporting1/5.0.3+20230123/google_youtubereporting1/api::JobReportGetCall) and [*reports list*](https://docs.rs/google-youtubereporting1/5.0.3+20230123/google_youtubereporting1/api::JobReportListCall) @@ -63,8 +63,8 @@ let r = hub.jobs().get(...).doit().await let r = hub.jobs().list(...).doit().await ``` -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `doit()` method performs the actual communication with the server and returns the respective result. @@ -91,12 +91,12 @@ use youtubereporting1::{Result, Error}; use std::default::Default; use youtubereporting1::{YouTubeReporting, oauth2, hyper, hyper_rustls, chrono, FieldMask}; -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. let secret: oauth2::ApplicationSecret = Default::default(); -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -138,10 +138,10 @@ match result { ## Handling Errors All errors produced by the system are provided either as [Result](https://docs.rs/google-youtubereporting1/5.0.3+20230123/google_youtubereporting1/client::Result) enumeration as return value of -the doit() methods, or handed as possibly intermediate results to either the +the doit() methods, or handed as possibly intermediate results to either the [Hub Delegate](https://docs.rs/google-youtubereporting1/5.0.3+20230123/google_youtubereporting1/client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ## Uploads and Downloads @@ -151,25 +151,25 @@ If such a method also supports a [Response Result](https://docs.rs/google-youtub You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `.param("alt", "media")`. -Methods supporting uploads can do so using up to 2 different protocols: -*simple* and *resumable*. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to 2 different protocols: +*simple* and *resumable*. The distinctiveness of each is represented by customized `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. ## Customization and Callbacks -You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-youtubereporting1/5.0.3+20230123/google_youtubereporting1/client::Delegate) to the -[Method Builder](https://docs.rs/google-youtubereporting1/5.0.3+20230123/google_youtubereporting1/client::CallBuilder) before making the final `doit()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-youtubereporting1/5.0.3+20230123/google_youtubereporting1/client::Delegate) to the +[Method Builder](https://docs.rs/google-youtubereporting1/5.0.3+20230123/google_youtubereporting1/client::CallBuilder) before making the final `doit()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The [delegate trait](https://docs.rs/google-youtubereporting1/5.0.3+20230123/google_youtubereporting1/client::Delegate) is default-implemented, allowing you to customize it with minimal effort. ## Optional Parts in Server-Requests -All structures provided by this library are made to be [encodable](https://docs.rs/google-youtubereporting1/5.0.3+20230123/google_youtubereporting1/client::RequestValue) and -[decodable](https://docs.rs/google-youtubereporting1/5.0.3+20230123/google_youtubereporting1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be [encodable](https://docs.rs/google-youtubereporting1/5.0.3+20230123/google_youtubereporting1/client::RequestValue) and +[decodable](https://docs.rs/google-youtubereporting1/5.0.3+20230123/google_youtubereporting1/client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered [Parts](https://docs.rs/google-youtubereporting1/5.0.3+20230123/google_youtubereporting1/client::Part) which are identifiable by name, which will be sent to +Most optionals are are considered [Parts](https://docs.rs/google-youtubereporting1/5.0.3+20230123/google_youtubereporting1/client::Part) which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ## Builder Arguments @@ -188,7 +188,7 @@ Arguments will always be copied or cloned into the builder, to make them indepen [google-go-api]: https://github.com/google/google-api-go-client # License -The **youtubereporting1** library was generated by Sebastian Thiel, and is placed +The **youtubereporting1** library was generated by Sebastian Thiel, and is placed under the *MIT* license. You can read the full text at the repository's [license file][repo-license]. diff --git a/gen/youtubereporting1/src/api.rs b/gen/youtubereporting1/src/api.rs index 9a291c5fef..223df2cea8 100644 --- a/gen/youtubereporting1/src/api.rs +++ b/gen/youtubereporting1/src/api.rs @@ -23,7 +23,7 @@ use crate::{client, client::GetToken, client::serde_with}; /// Identifies the an OAuth2 authorization scope. /// A scope is needed when requesting an /// [authorization token](https://developers.google.com/youtube/v3/guides/authentication). -#[derive(PartialEq, Eq, Hash)] +#[derive(PartialEq, Eq, Hash, Debug)] pub enum Scope { /// View monetary and non-monetary YouTube Analytics reports for your YouTube content YtAnalyticMonetaryReadonly, @@ -68,12 +68,12 @@ impl Default for Scope { /// use std::default::Default; /// use youtubereporting1::{YouTubeReporting, oauth2, hyper, hyper_rustls, chrono, FieldMask}; /// -/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and +/// // Get an ApplicationSecret instance by some means. It contains the `client_id` and /// // `client_secret`, among other things. /// let secret: oauth2::ApplicationSecret = Default::default(); -/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, +/// // Instantiate the authenticator. It will choose a suitable authentication flow for you, /// // unless you replace `None` with the desired Flow. -/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +/// // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about /// // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and /// // retrieve them from storage. /// let auth = oauth2::InstalledFlowAuthenticator::builder( diff --git a/gen/youtubereporting1/src/lib.rs b/gen/youtubereporting1/src/lib.rs index a307643288..850059ac94 100644 --- a/gen/youtubereporting1/src/lib.rs +++ b/gen/youtubereporting1/src/lib.rs @@ -9,7 +9,7 @@ //! The original source code is [on github](https://github.com/Byron/google-apis-rs/tree/main/gen/youtubereporting1). //! # Features //! -//! Handle the following *Resources* with ease from the central [hub](YouTubeReporting) ... +//! Handle the following *Resources* with ease from the central [hub](YouTubeReporting) ... //! //! * [jobs](api::Job) //! * [*create*](api::JobCreateCall), [*delete*](api::JobDeleteCall), [*get*](api::JobGetCall), [*list*](api::JobListCall), [*reports get*](api::JobReportGetCall) and [*reports list*](api::JobReportListCall) @@ -63,8 +63,8 @@ //! let r = hub.jobs().list(...).doit().await //! ``` //! -//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +//! The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +//! supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be //! specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. //! The `doit()` method performs the actual communication with the server and returns the respective result. //! @@ -92,12 +92,12 @@ //! use std::default::Default; //! use youtubereporting1::{YouTubeReporting, oauth2, hyper, hyper_rustls, chrono, FieldMask}; //! -//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and +//! // Get an ApplicationSecret instance by some means. It contains the `client_id` and //! // `client_secret`, among other things. //! let secret: oauth2::ApplicationSecret = Default::default(); -//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, +//! // Instantiate the authenticator. It will choose a suitable authentication flow for you, //! // unless you replace `None` with the desired Flow. -//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +//! // Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about //! // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and //! // retrieve them from storage. //! let auth = oauth2::InstalledFlowAuthenticator::builder( @@ -139,10 +139,10 @@ //! ## Handling Errors //! //! All errors produced by the system are provided either as [Result](client::Result) enumeration as return value of -//! the doit() methods, or handed as possibly intermediate results to either the +//! the doit() methods, or handed as possibly intermediate results to either the //! [Hub Delegate](client::Delegate), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html). //! -//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +//! When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This //! makes the system potentially resilient to all kinds of errors. //! //! ## Uploads and Downloads @@ -152,25 +152,25 @@ //! You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making //! this call: `.param("alt", "media")`. //! -//! Methods supporting uploads can do so using up to 2 different protocols: -//! *simple* and *resumable*. The distinctiveness of each is represented by customized +//! Methods supporting uploads can do so using up to 2 different protocols: +//! *simple* and *resumable*. The distinctiveness of each is represented by customized //! `doit(...)` methods, which are then named `upload(...)` and `upload_resumable(...)` respectively. //! //! ## Customization and Callbacks //! -//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the -//! [Method Builder](client::CallBuilder) before making the final `doit()` call. -//! Respective methods will be called to provide progress information, as well as determine whether the system should +//! You may alter the way an `doit()` method is called by providing a [delegate](client::Delegate) to the +//! [Method Builder](client::CallBuilder) before making the final `doit()` call. +//! Respective methods will be called to provide progress information, as well as determine whether the system should //! retry on failure. //! //! The [delegate trait](client::Delegate) is default-implemented, allowing you to customize it with minimal effort. //! //! ## Optional Parts in Server-Requests //! -//! All structures provided by this library are made to be [encodable](client::RequestValue) and -//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses +//! All structures provided by this library are made to be [encodable](client::RequestValue) and +//! [decodable](client::ResponseResult) via *json*. Optionals are used to indicate that partial requests are responses //! are valid. -//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to +//! Most optionals are are considered [Parts](client::Part) which are identifiable by name, which will be sent to //! the server to indicate either the set parts of the request or the desired parts in the response. //! //! ## Builder Arguments diff --git a/src/generator/templates/api/lib/lib.mako b/src/generator/templates/api/lib/lib.mako index 477d27bda8..fec45dbe2d 100644 --- a/src/generator/templates/api/lib/lib.mako +++ b/src/generator/templates/api/lib/lib.mako @@ -2,12 +2,12 @@ from generator.lib.util import (activity_split, put_and, md_italic, split_camelcase_s, canonical_type_name, hub_type, rust_test_fn_invisible, rust_doc_test_norun, rust_doc_comment, markdown_rust_block, unindent_first_by, mangle_ident, mb_type, singular, scope_url_to_variant, - PART_MARKER_TRAIT, RESOURCE_MARKER_TRAIT, CALL_BUILDER_MARKERT_TRAIT, + PART_MARKER_TRAIT, RESOURCE_MARKER_TRAIT, CALL_BUILDER_MARKERT_TRAIT, find_fattest_resource, build_all_params, pass_through, parts_from_params, REQUEST_MARKER_TRAIT, RESPONSE_MARKER_TRAIT, supports_scopes, to_api_version, to_fqan, METHODS_RESOURCE, ADD_PARAM_MEDIA_EXAMPLE, PROTOCOL_TYPE_INFO, enclose_in, upload_action_fn, METHODS_BUILDER_MARKER_TRAIT, DELEGATE_TYPE, - to_extern_crate_name, rust_doc_sanitize) + to_extern_crate_name, rust_doc_sanitize) def pretty_name(name): return ' '.join(split_camelcase_s(name).split('.')) @@ -15,7 +15,7 @@ <%namespace name="util" file="../../../lib/util.mako"/>\ <%namespace name="mbuild" file="mbuild.mako"/>\ -## If rust-doc is True, examples will be made to work for rust doc tests. Otherwise they are set +## If rust-doc is True, examples will be made to work for rust doc tests. Otherwise they are set ## for github markdown. ############################################################################################### ############################################################################################### @@ -69,9 +69,9 @@ The original source code is [on github](${util.github_source_root_url()}). # Features % if len(c.rta_map) > 0 + (METHODS_RESOURCE in c.rta_map): -Handle the following *Resources* with ease from the central ${link('hub', hub_url)} ... +Handle the following *Resources* with ease from the central ${link('hub', hub_url)} ... % elif METHODS_RESOURCE in c.rta_map: -Use the following functionality with ease from the central ${link('hub', hub_url)} ... +Use the following functionality with ease from the central ${link('hub', hub_url)} ... % else: It seems there is nothing you can do here ... . % endif @@ -109,7 +109,7 @@ Other activities are ... ${method_type} supported by ... % for m in methods: -<% +<% _, resource, method = activity_split(m.id) name_parts = [pretty_name(method)] if resource != METHODS_RESOURCE: @@ -162,8 +162,8 @@ let r = hub.${mangle_ident(resource)}().${mangle_ident(activity)}(...).${api.ter ``` % endif -The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` -supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be +The `resource()` and `activity(...)` calls create [builders][builder-pattern]. The second one dealing with `Activities` +supports various methods to configure the impending operation (not shown here). It is made such that all required arguments have to be specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired. The `${api.terms.action}()` method performs the actual communication with the server and returns the respective result. @@ -187,10 +187,10 @@ ${self.hub_usage_example(c, rust_doc, fr=fr)}\ ${'##'} Handling Errors All errors produced by the system are provided either as ${link('Result', 'client::Result')} enumeration as return value of -the ${api.terms.action}() methods, or handed as possibly intermediate results to either the +the ${api.terms.action}() methods, or handed as possibly intermediate results to either the ${link('Hub Delegate', delegate_url)}, or the ${link('Authenticator Delegate', urls.authenticator_delegate)}. -When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This +When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This makes the system potentially resilient to all kinds of errors. ${'##'} Uploads and Downloads @@ -200,25 +200,25 @@ If such a method also supports a ${link('Response Result', 'client::ResponseResu You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making this call: `${ADD_PARAM_MEDIA_EXAMPLE}`. -Methods supporting uploads can do so using up to ${len(PROTOCOL_TYPE_INFO)} different protocols: -${put_and(md_italic(PROTOCOL_TYPE_INFO.keys()))}. The distinctiveness of each is represented by customized +Methods supporting uploads can do so using up to ${len(PROTOCOL_TYPE_INFO)} different protocols: +${put_and(md_italic(PROTOCOL_TYPE_INFO.keys()))}. The distinctiveness of each is represented by customized `${api.terms.action}(...)` methods, which are then named ${put_and(enclose_in('`', ("%s(...)" % upload_action_fn(api.terms.upload_action, v['suffix']) for v in PROTOCOL_TYPE_INFO.values())))} respectively. ${'##'} Customization and Callbacks -You may alter the way an `${api.terms.action}()` method is called by providing a ${link('delegate', delegate_url)} to the -${link('Method Builder', call_builder_url)} before making the final `${api.terms.action}()` call. -Respective methods will be called to provide progress information, as well as determine whether the system should +You may alter the way an `${api.terms.action}()` method is called by providing a ${link('delegate', delegate_url)} to the +${link('Method Builder', call_builder_url)} before making the final `${api.terms.action}()` call. +Respective methods will be called to provide progress information, as well as determine whether the system should retry on failure. The ${link('delegate trait', delegate_url)} is default-implemented, allowing you to customize it with minimal effort. ${'##'} Optional Parts in Server-Requests -All structures provided by this library are made to be ${link('encodable', request_trait_url)} and -${link('decodable', response_trait_url)} via *json*. Optionals are used to indicate that partial requests are responses +All structures provided by this library are made to be ${link('encodable', request_trait_url)} and +${link('decodable', response_trait_url)} via *json*. Optionals are used to indicate that partial requests are responses are valid. -Most optionals are are considered ${link('Parts', part_trait_url)} which are identifiable by name, which will be sent to +Most optionals are are considered ${link('Parts', part_trait_url)} which are identifiable by name, which will be sent to the server to indicate either the set parts of the request or the desired parts in the response. ${'##'} Builder Arguments @@ -246,14 +246,14 @@ use std::default::Default; use ${util.library_name()}::{${hub_type}, oauth2, hyper, hyper_rustls, chrono, FieldMask}; % if comments: -// Get an ApplicationSecret instance by some means. It contains the `client_id` and +// Get an ApplicationSecret instance by some means. It contains the `client_id` and // `client_secret`, among other things. % endif let secret: oauth2::ApplicationSecret = Default::default(); % if comments: -// Instantiate the authenticator. It will choose a suitable authentication flow for you, +// Instantiate the authenticator. It will choose a suitable authentication flow for you, // unless you replace `None` with the desired Flow. -// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about +// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about // what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and // retrieve them from storage. % endif @@ -268,7 +268,7 @@ let mut hub = ${hub_type}::new(hyper::Client::builder().build(hyper_rustls::Http ############################################################################################### ############################################################################################### <%def name="hub_usage_example(c, rust_doc=True, fr=None)">\ -<% +<% test_filter = rust_test_fn_invisible main_filter = rust_doc_test_norun if not rust_doc: @@ -312,7 +312,7 @@ ${self.test_hub(hub_type(c.schemas, util.canonical_name()))} ############################################################################################### <%def name="license()">\ # License -The **${util.library_name()}** library was generated by ${put_and(copyright.authors)}, and is placed +The **${util.library_name()}** library was generated by ${put_and(copyright.authors)}, and is placed under the *${copyright.license_abbrev}* license. You can read the full text at the repository's [license file][repo-license].