<!---
DO NOT EDIT !
This file was generated automatically from 'src/mako/api/README.md.mako'
DO NOT EDIT !
-->
The `google-dfareporting3d2` library allows access to all features of the *Google dfareporting* service.
This documentation was generated from *dfareporting* crate version *2.0.3+20190531*, where *20190531* is the exact revision of the *dfareporting:v3.2* schema built by the [mako](http://www.makotemplates.org/) code generator *v2.0.3*.
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/2.0.3+20190531/google_dfareporting3d2/Dfareporting) ...
* [account active ad summaries](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::AccountActiveAdSummary)
* [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::AccountActiveAdSummaryGetCall)
* [account permission groups](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::AccountPermissionGroup)
* [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::AccountPermissionGroupGetCall) and [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::AccountPermissionGroupListCall)
* [account permissions](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::AccountPermission)
* [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::AccountPermissionGetCall) and [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::AccountPermissionListCall)
* [account user profiles](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::AccountUserProfile)
* [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::AccountUserProfileGetCall), [*insert*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::AccountUserProfileInsertCall), [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::AccountUserProfileListCall), [*patch*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::AccountUserProfilePatchCall) and [*update*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::AccountUserProfileUpdateCall)
* [accounts](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::Account)
* [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::AccountGetCall), [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::AccountListCall), [*patch*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::AccountPatchCall) and [*update*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::AccountUpdateCall)
* [ads](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::Ad)
* [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::AdGetCall), [*insert*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::AdInsertCall), [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::AdListCall), [*patch*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::AdPatchCall) and [*update*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::AdUpdateCall)
* [advertiser groups](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::AdvertiserGroup)
* [*delete*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::AdvertiserGroupDeleteCall), [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::AdvertiserGroupGetCall), [*insert*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::AdvertiserGroupInsertCall), [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::AdvertiserGroupListCall), [*patch*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::AdvertiserGroupPatchCall) and [*update*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::AdvertiserGroupUpdateCall)
* advertiser landing pages
* [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::AdvertiserLandingPageGetCall), [*insert*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::AdvertiserLandingPageInsertCall), [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::AdvertiserLandingPageListCall), [*patch*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::AdvertiserLandingPagePatchCall) and [*update*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::AdvertiserLandingPageUpdateCall)
* [advertisers](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::Advertiser)
* [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::AdvertiserGetCall), [*insert*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::AdvertiserInsertCall), [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::AdvertiserListCall), [*patch*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::AdvertiserPatchCall) and [*update*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::AdvertiserUpdateCall)
* [browsers](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::Browser)
* [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::BrowserListCall)
* [campaign creative associations](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::CampaignCreativeAssociation)
* [*insert*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::CampaignCreativeAssociationInsertCall) and [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::CampaignCreativeAssociationListCall)
* [campaigns](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::Campaign)
* [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::CampaignGetCall), [*insert*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::CampaignInsertCall), [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::CampaignListCall), [*patch*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::CampaignPatchCall) and [*update*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::CampaignUpdateCall)
* [change logs](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::ChangeLog)
* [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::ChangeLogGetCall) and [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::ChangeLogListCall)
* [cities](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::City)
* [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::CityListCall)
* [connection types](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::ConnectionType)
* [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::ConnectionTypeGetCall) and [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::ConnectionTypeListCall)
* [content categories](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::ContentCategory)
* [*delete*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::ContentCategoryDeleteCall), [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::ContentCategoryGetCall), [*insert*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::ContentCategoryInsertCall), [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::ContentCategoryListCall), [*patch*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::ContentCategoryPatchCall) and [*update*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::ContentCategoryUpdateCall)
* [conversions](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::Conversion)
* [*batchinsert*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::ConversionBatchinsertCall) and [*batchupdate*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::ConversionBatchupdateCall)
* [countries](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::Country)
* [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::CountryGetCall) and [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::CountryListCall)
* [creative assets](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::CreativeAsset)
* [*insert*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::CreativeAssetInsertCall)
* [creative field values](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::CreativeFieldValue)
* [*delete*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::CreativeFieldValueDeleteCall), [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::CreativeFieldValueGetCall), [*insert*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::CreativeFieldValueInsertCall), [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::CreativeFieldValueListCall), [*patch*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::CreativeFieldValuePatchCall) and [*update*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::CreativeFieldValueUpdateCall)
* [creative fields](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::CreativeField)
* [*delete*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::CreativeFieldDeleteCall), [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::CreativeFieldGetCall), [*insert*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::CreativeFieldInsertCall), [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::CreativeFieldListCall), [*patch*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::CreativeFieldPatchCall) and [*update*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::CreativeFieldUpdateCall)
* [creative groups](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::CreativeGroup)
* [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::CreativeGroupGetCall), [*insert*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::CreativeGroupInsertCall), [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::CreativeGroupListCall), [*patch*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::CreativeGroupPatchCall) and [*update*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::CreativeGroupUpdateCall)
* [creatives](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::Creative)
* [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::CreativeGetCall), [*insert*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::CreativeInsertCall), [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::CreativeListCall), [*patch*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::CreativePatchCall) and [*update*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::CreativeUpdateCall)
* [dimension values](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::DimensionValue)
* [*query*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::DimensionValueQueryCall)
* [directory site contacts](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::DirectorySiteContact)
* [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::DirectorySiteContactGetCall) and [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::DirectorySiteContactListCall)
* [directory sites](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::DirectorySite)
* [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::DirectorySiteGetCall), [*insert*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::DirectorySiteInsertCall) and [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::DirectorySiteListCall)
* [dynamic targeting keys](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::DynamicTargetingKey)
* [*delete*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::DynamicTargetingKeyDeleteCall), [*insert*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::DynamicTargetingKeyInsertCall) and [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::DynamicTargetingKeyListCall)
* [event tags](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::EventTag)
* [*delete*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::EventTagDeleteCall), [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::EventTagGetCall), [*insert*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::EventTagInsertCall), [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::EventTagListCall), [*patch*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::EventTagPatchCall) and [*update*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::EventTagUpdateCall)
* [files](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::File)
* [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::FileGetCall) and [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::FileListCall)
* [floodlight activities](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::FloodlightActivity)
* [*delete*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::FloodlightActivityDeleteCall), [*generatetag*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::FloodlightActivityGeneratetagCall), [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::FloodlightActivityGetCall), [*insert*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::FloodlightActivityInsertCall), [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::FloodlightActivityListCall), [*patch*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::FloodlightActivityPatchCall) and [*update*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::FloodlightActivityUpdateCall)
* [floodlight activity groups](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::FloodlightActivityGroup)
* [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::FloodlightActivityGroupGetCall), [*insert*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::FloodlightActivityGroupInsertCall), [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::FloodlightActivityGroupListCall), [*patch*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::FloodlightActivityGroupPatchCall) and [*update*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::FloodlightActivityGroupUpdateCall)
* [floodlight configurations](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::FloodlightConfiguration)
* [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::FloodlightConfigurationGetCall), [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::FloodlightConfigurationListCall), [*patch*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::FloodlightConfigurationPatchCall) and [*update*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::FloodlightConfigurationUpdateCall)
* [inventory items](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::InventoryItem)
* [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::InventoryItemGetCall) and [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::InventoryItemListCall)
* [languages](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::Language)
* [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::LanguageListCall)
* [metros](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::Metro)
* [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::MetroListCall)
* [mobile apps](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::MobileApp)
* [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::MobileAppGetCall) and [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::MobileAppListCall)
* [mobile carriers](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::MobileCarrier)
* [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::MobileCarrierGetCall) and [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::MobileCarrierListCall)
* [operating system versions](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::OperatingSystemVersion)
* [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::OperatingSystemVersionGetCall) and [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::OperatingSystemVersionListCall)
* [operating systems](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::OperatingSystem)
* [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::OperatingSystemGetCall) and [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::OperatingSystemListCall)
* [order documents](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::OrderDocument)
* [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::OrderDocumentGetCall) and [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::OrderDocumentListCall)
* [orders](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::Order)
* [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::OrderGetCall) and [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::OrderListCall)
* [placement groups](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::PlacementGroup)
* [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::PlacementGroupGetCall), [*insert*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::PlacementGroupInsertCall), [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::PlacementGroupListCall), [*patch*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::PlacementGroupPatchCall) and [*update*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::PlacementGroupUpdateCall)
* [placement strategies](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::PlacementStrategy)
* [*delete*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::PlacementStrategyDeleteCall), [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::PlacementStrategyGetCall), [*insert*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::PlacementStrategyInsertCall), [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::PlacementStrategyListCall), [*patch*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::PlacementStrategyPatchCall) and [*update*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::PlacementStrategyUpdateCall)
* [placements](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::Placement)
* [*generatetags*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::PlacementGeneratetagCall), [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::PlacementGetCall), [*insert*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::PlacementInsertCall), [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::PlacementListCall), [*patch*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::PlacementPatchCall) and [*update*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::PlacementUpdateCall)
* [platform types](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::PlatformType)
* [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::PlatformTypeGetCall) and [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::PlatformTypeListCall)
* [postal codes](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::PostalCode)
* [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::PostalCodeGetCall) and [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::PostalCodeListCall)
* [projects](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::Project)
* [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::ProjectGetCall) and [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::ProjectListCall)
* [regions](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::Region)
* [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::RegionListCall)
* [remarketing list shares](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::RemarketingListShare)
* [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::RemarketingListShareGetCall), [*patch*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::RemarketingListSharePatchCall) and [*update*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::RemarketingListShareUpdateCall)
* [remarketing lists](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::RemarketingList)
* [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::RemarketingListGetCall), [*insert*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::RemarketingListInsertCall), [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::RemarketingListListCall), [*patch*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::RemarketingListPatchCall) and [*update*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::RemarketingListUpdateCall)
* [reports](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::Report)
* [*compatible fields query*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::ReportCompatibleFieldQueryCall), [*delete*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::ReportDeleteCall), [*files get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::ReportFileGetCall), [*files list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::ReportFileListCall), [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::ReportGetCall), [*insert*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::ReportInsertCall), [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::ReportListCall), [*patch*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::ReportPatchCall), [*run*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::ReportRunCall) and [*update*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::ReportUpdateCall)
* [sites](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::Site)
* [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::SiteGetCall), [*insert*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::SiteInsertCall), [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::SiteListCall), [*patch*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::SitePatchCall) and [*update*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::SiteUpdateCall)
* [sizes](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::Size)
* [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::SizeGetCall), [*insert*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::SizeInsertCall) and [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::SizeListCall)
* [subaccounts](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::Subaccount)
* [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::SubaccountGetCall), [*insert*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::SubaccountInsertCall), [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::SubaccountListCall), [*patch*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::SubaccountPatchCall) and [*update*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::SubaccountUpdateCall)
* [targetable remarketing lists](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::TargetableRemarketingList)
* [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::TargetableRemarketingListGetCall) and [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::TargetableRemarketingListListCall)
* [targeting templates](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::TargetingTemplate)
* [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::TargetingTemplateGetCall), [*insert*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::TargetingTemplateInsertCall), [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::TargetingTemplateListCall), [*patch*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::TargetingTemplatePatchCall) and [*update*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::TargetingTemplateUpdateCall)
* [user profiles](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::UserProfile)
* [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::UserProfileGetCall) and [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::UserProfileListCall)
* [user role permission groups](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::UserRolePermissionGroup)
* [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::UserRolePermissionGroupGetCall) and [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::UserRolePermissionGroupListCall)
* [user role permissions](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::UserRolePermission)
* [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::UserRolePermissionGetCall) and [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::UserRolePermissionListCall)
* [user roles](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::UserRole)
* [*delete*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::UserRoleDeleteCall), [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::UserRoleGetCall), [*insert*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::UserRoleInsertCall), [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::UserRoleListCall), [*patch*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::UserRolePatchCall) and [*update*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::UserRoleUpdateCall)
* [video formats](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::VideoFormat)
* [*get*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::VideoFormatGetCall) and [*list*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::VideoFormatListCall)
Upload supported by ...
* [*insert creative assets*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::CreativeAssetInsertCall)
Download supported by ...
* [*get files*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::FileGetCall)
* [*files get reports*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/api::ReportFileGetCall)
# Structure of this Library
The API is structured into the following primary items:
* **[Hub](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/Dfareporting)**
* a central object to maintain state and allow accessing all *Activities*
* creates [*Method Builders*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/client::MethodsBuilder) which in turn
allow access to individual [*Call Builders*](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/client::CallBuilder)
* **[Resources](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/client::Resource)**
* primary types that you can apply *Activities* to
* a collection of properties and *Parts*
* **[Parts](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/client::Part)**
* a collection of properties
* never directly used in *Activities*
* **[Activities](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/client::CallBuilder)**
* operations to apply to *Resources*
All *structures* are marked with applicable traits to further categorize them and ease browsing.
Generally speaking, you can invoke *Activities* like this:
```Rust,ignore
let r = hub.resource().activity(...).doit().await
```
Or specifically ...
```ignore
let r = hub.reports().compatible_fields_query(...).doit().await
let r = hub.reports().files_get(...).doit().await
let r = hub.reports().files_list(...).doit().await
let r = hub.reports().delete(...).doit().await
let r = hub.reports().get(...).doit().await
let r = hub.reports().insert(...).doit().await
let r = hub.reports().list(...).doit().await
let r = hub.reports().patch(...).doit().await
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
specified right away (i.e. `(...)`), whereas all optional ones can be [build up][builder-pattern] as desired.
The `doit()` method performs the actual communication with the server and returns the respective result.
# Usage
## Setting up your Project
To use this library, you would put the following lines into your `Cargo.toml` file:
```toml
[dependencies]
google-dfareporting3d2 = "*"
# This project intentionally uses an old version of Hyper. See
# https://github.com/Byron/google-apis-rs/issues/173 for more
# information.
hyper = "^0.14"
hyper-rustls = "^0.22"
serde = "^1.0"
serde_json = "^1.0"
yup-oauth2 = "^5.0"
```
## A complete example
```Rust
extern crate hyper;
extern crate hyper_rustls;
extern crate yup_oauth2 as oauth2;
extern crate google_dfareporting3d2 as dfareporting3d2;
use dfareporting3d2::{Result, Error};
use std::default::Default;
use oauth2;
use dfareporting3d2::Dfareporting;
// Get an ApplicationSecret instance by some means. It contains the `client_id` and
// `client_secret`, among other things.
let secret: oauth2::ApplicationSecret = Default::default();
// Instantiate the authenticator. It will choose a suitable authentication flow for you,
// unless you replace `None` with the desired Flow.
// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about
// what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and
// retrieve them from storage.
let auth = yup_oauth2::InstalledFlowAuthenticator::builder(
secret,
yup_oauth2::InstalledFlowReturnMethod::HTTPRedirect,
).build().await.unwrap();
let mut hub = Dfareporting::new(hyper::Client::builder().build(hyper_rustls::HttpsConnector::with_native_roots()), auth);
// You can configure optional parameters by calling the respective setters at will, and
// execute the final call using `doit()`.
// Values shown here are possibly random and not representative !
let result = hub.reports().files_list("profileId", "reportId")
.sort_order("no")
.sort_field("ipsum")
.page_token("voluptua.")
.max_results(-27)
.doit().await;
match result {
Err(e) => match e {
// The Error enum provides details about what exactly happened.
// You can also just use its `Debug`, `Display` or `Error` traits
Error::HttpError(_)
|Error::Io(_)
|Error::MissingAPIKey
|Error::MissingToken(_)
|Error::Cancelled
|Error::UploadSizeLimitExceeded(_, _)
|Error::Failure(_)
|Error::BadRequest(_)
|Error::FieldClash(_)
|Error::JsonDecodeError(_, _) => println!("{}", e),
},
Ok(res) => println!("Success: {:?}", res),
}
```
## Handling Errors
All errors produced by the system are provided either as [Result](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/client::Result) enumeration as return value of
the doit() methods, or handed as possibly intermediate results to either the
[Hub Delegate](https://docs.rs/google-dfareporting3d2/2.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
makes the system potentially resilient to all kinds of errors.
## Uploads and Downloads
If a method supports downloads, the response body, which is part of the [Result](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/client::Result), should be
read by you to obtain the media.
If such a method also supports a [Response Result](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/client::ResponseResult), it will return that by default.
You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making
this call: `.param("alt", "media")`.
Methods supporting uploads can do so using up to 2 different protocols:
*simple* and *resumable*. The distinctiveness of each is represented by customized
`doit(...)` methods, which are then named `upload(...)` and `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/2.0.3+20190531/google_dfareporting3d2/client::Delegate) to the
[Method Builder](https://docs.rs/google-dfareporting3d2/2.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/2.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/2.0.3+20190531/google_dfareporting3d2/client::RequestValue) and
[decodable](https://docs.rs/google-dfareporting3d2/2.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/2.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
Using [method builders](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/client::CallBuilder), you are able to prepare an action call by repeatedly calling it's methods.
These will always take a single argument, for which the following statements are true.
* [PODs][wiki-pod] are handed by copy
* strings are passed as `&str`
* [request values](https://docs.rs/google-dfareporting3d2/2.0.3+20190531/google_dfareporting3d2/client::RequestValue) are moved
Arguments will always be copied or cloned into the builder, to make them independent of their original life times.
[wiki-pod]: http://en.wikipedia.org/wiki/Plain_old_data_structure
[builder-pattern]: http://en.wikipedia.org/wiki/Builder_pattern
[google-go-api]: https://github.com/google/google-api-go-client
# License
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].
[repo-license]: https://github.com/Byron/google-apis-rsblob/main/LICENSE.md