… (Bug #613326)

Review link: https://review.docs.microsoft.com/en-us/rest/api/power-bi/gateways/update-datasource?branch=tris-gatewaysupdatedatasource-review

…tes - second pass

Review link: https://review.docs.microsoft.com/en-us/rest/api/power-bi/capacities?branch=tris-capacities-review

Review link: https://review.docs.microsoft.com/en-us/rest/api/power-bi/?branch=tris-definitions6-review

Review link: https://review.docs.microsoft.com/en-us/rest/api/power-bi/admin/get-refreshables?branch=tris-refreshables-review

Added "Power BI retains a seven-day refresh history for each dataset, up to a maximum of sixty refreshes" to description and Refreshable definition.

Review links:
•	[Capacities - Get Refreshables](https://review.docs.microsoft.com/en-us/rest/api/power-bi/capacities/get-refreshables?branch=tris-refreshables-window-review)
•	[Capacities - Get Refreshables For Capacity](https://review.docs.microsoft.com/en-us/rest/api/power-bi/capacities/get-refreshables-for-capacity?branch=tris-refreshables-window-review)
•	[Capacities - Get Refreshable For Capacity](https://review.docs.microsoft.com/en-us/rest/api/power-bi/capacities/get-refreshable-for-capacity?branch=tris-refreshables-window-review)
•	[Admin - Get Refreshables](https://review.docs.microsoft.com/en-us/rest/api/power-bi/admin/get-refreshables?branch=tris-refreshables-window-review)
•	[Admin - Get Refreshables For Capacity](https://review.docs.microsoft.com/en-us/rest/api/power-bi/admin/get-refreshables-for-capacity?branch=tris-refreshables-window-review)
•	[Admin - Get Refreshable For Capacity](https://review.docs.microsoft.com/en-us/rest/api/power-bi/admin/get-refreshable-for-capacity?branch=tris-refreshables-window-review)

Branch: trisshores-update-definitions-10

Review link: https://review.docs.microsoft.com/en-us/rest/api/power-bi/gateways/get-datasources?branch=tris-credentialtype-review#credentialtype

Review link: https://review.docs.microsoft.com/en-us/rest/api/power-bi/?branch=tris-definitions5-review

Review branch: tris-example-casing

An example of the casing fix is:
"completed import example" -> "Completed import example"
See https://review.docs.microsoft.com/en-us/rest/api/power-bi/imports/get-import-in-group?branch=tris-example-casing

Please review carefully. This PR fixes what appears to be inadvertent trailing space in 19 swagger field names. One C# API file is affected by this fix.

Review link: https://review.docs.microsoft.com/en-us/rest/api/power-bi/reports?branch=tris-reports-review

Add workspaceId in AdminApp

- Replace "artifact" references in summary, descriptions, and definitions.
- Make "datasource" two separate words.
- Standardize "My workspace" formatting.
- Use "OAuth 2.0" instead of "OAuth2", unless describing the parameter value.

Add widelySharedArtifacts APIs

Related work items: #719387

Remove Reports API preview messages from:
- Reports - Update Datasources
- Reports - Update Datasources In Group

Fix the principal type, as requested by Lir.

Review link: https://review.docs.microsoft.com/en-us/rest/api/power-bi/pipelines/update-pipeline-user?branch=tris-principalfix-review

Review link: https://review.docs.microsoft.com/en-us/rest/api/power-bi/admin/users-get-user-artifact-access-as-admin?branch=tris-upn-example

Updated PostDatasetUser  to make it clear that both datasets which resides in my workspace or Folders are supported

- Remove obsolete content (WS collection related)
- Change the description to be more general: not focused on embed only but REST APIs in general
- Provide up-to date simple examples (Get Report and Datasets, Generate Embed Token V2, Get Reports as Admin).

…nfo)

Remove preview status from these API:

- WorkspaceInfo GetModifiedWorkspaces
- WorkspaceInfo GetScanResult
- WorkspaceInfo GetScanStatus
- WorkspaceInfo PostWorkspaceInfo

Notes:

- Descriptions for boolean variables should start with something like "Whether to return..." instead of "Returns...", because the latter assumes that the boolean value was set to `true`.
- I suggest "fully enabled" over "properly enabled" because "properly" doesn't on its own help a user know which control to enable, whereas "fully enabled" implies that both tenant settings that control metadata scanning should be enabled. However, it's not my decision, so let me know if changes are needed.
- I updated the provided link for [Enable tenant settings for metadata scanning](Enable tenant settings for metadata scanning) since it pointed to the wrong article section.

This PR ensures all preview API calls have consistent language. Preview API summaries will have this final sentence: "This is a preview API call."

This PR is layered on top of [Remove preview status from Scanner APIs (WorkspaceInfo)](https://powerbi.visualstudio.com/Embedded/_git/PowerBI-CSharp/pullrequest/229238) to avoid merge conflicts when that PR is merged. **Please review that PR first.**

Standardize all user principal name (UPN) references.

Please let me know whether your customers are expected to know what a UPN is. If that's the case, I'll replace all instances of "user principal name (UPN)" with "UPN".

- Capitalizes all the examples (this was previously done, new examples got added since)
- 'Required scope’ to ‘Required Scope’

The state of Goals API at this moment. It has been tested by a set of tests written by @<Andrew Garbuzov> which operate on msit deployment.

…eteDashboardInGroup new API

Related work items: #692111

Version Bump to 4.2

… dev/alonyeshurun/mirror_4.2.0