<div>Image2 – Postman. Import of environment variables,</div>Import previously downloaded \\\\\\\_gcp-.postman_environment.json\\\\\\\_ to Postman Environments.
Import previously downloaded _gcp-.postman_environment.json_ to Postman Environments.
### Grant permissions for users
### Grant permissions for users
...
@@ -80,25 +80,78 @@ The instruction for granting permissions is available by [the link](https://comm
...
@@ -80,25 +80,78 @@ The instruction for granting permissions is available by [the link](https://comm
### Set a value for **_refresh_token_**
### Set a value for **_refresh_token_**
You have several options to obtain `refresh_token`. But in all cases you need to have CLIENT_ID and CLIENT_SECRET and set them in Postman environment.
- Ask “Owner” or “Editor” of the GoogleCloud project where OSDU is deployed to create a client that is planned to use (API & Services -> Credentials -> OAuth 2.0 Client IDs)
- Copy-paste CLIENT_ID and CLIENT_SECRET into the environmental variables in Postman. Make sure you are updating both `INITIAL VALUE` and `CURRENT VALUE`
#### Obtaining `refresh_token` via Postman UI
Refer to [Postman authentication guide](https://community.opengroup.org/osdu/platform/pre-shipping/-/blob/main/R3-M16/GCP-M16/Postman_Authentication_Guide.md).
Open [Quick start](https://community.opengroup.org/osdu/documentation/-/wikis/uploads/3c9820ad7dfe9ed873755c53500afe4e/OSDU_Quick_start.postman_collection.json) or other Postman collection and go to the Authorization tab:
- Click on “OAuth 2.0 Configuration” icon and select “Use your own OAuth credentials” (image 3) 
- Click on “OAuth 2.0 Configuration” icon and select “Use your own OAuth credentials” (image 3)
- Ask “Owner” or “Viewer” of the GCP project where OSDU is deployed to create a client (Image 4) that is planned to use (API & Services -> Credentials -> OAuth 2.0 Client IDs) 
<div>Image 4. Adding a client</div>- Copy-paste CLIENT_ID and CLIENT_SECRET into the environmental variables in Postman (Image 5). Make sure you are updating both \\\\\\\*\\\\\\\*INITIAL VALUE\\\\\\\*\\\\\\\* and \\\\\\\*\\\\\\\*CURRENT VALUE\\\\\\\*\\\\\\\* 
<div>Image 5. Updating CLIEND_ID and CLIENT_SECRET in the Postman environment variables</div>- Click on the needed client and copy-paste CLIENT_ID and CLIENT_SECRET into the previous OAuth 2.0 Playground screen and click “Authorize APIs”. 
<div>Image 6.GCP: Client ID and Client Secret</div>- 
<div>Image 7.OAuth 2.0 Playground. Updating Client ID and Client Secret</div>- Select a user account that can be authorized on the next screen - Click “Exchange authorization code for tokens” (Image 8) 
- Paste CLIENT_ID and CLIENT_SECRET from above step to OAuth 2.0 Playground screen and click “Authorize APIs”.
<div>Image 8. OAuth 2.0 Playground. Exchange authorization code for tokens</div>- Copy refresh token into the Postman environment variables files (both \\\\\\\*\\\\\\\*INITIAL VALUE\\\\\\\*\\\\\\\* and \\\\\\\*\\\\\\\*CURRENT VALUE\\\\\\\*\\\\\\\*) (Image 9) 
- Select a user account that can be authorized on the next screen - Click “Exchange authorization code for tokens” (Image 8)
<div>Image 16. A mapping document</div>\\\\\\\*\\\\\\\*Step 2. Create a manifest file\\\\\\\*\\\\\\\*
<div>Image 16. A mapping document</div>**Step 2. Create a manifest file**
The structure of the manifest is described by [the OSDU Manifest schema](https://gitlab.opengroup.org/osdu/subcommittees/data-def/work-products/schema/-/blob/master/Generated/manifest/Manifest.1.0.0.json)
The structure of the manifest is described by [the OSDU Manifest schema](https://gitlab.opengroup.org/osdu/subcommittees/data-def/work-products/schema/-/blob/master/Generated/manifest/Manifest.1.0.0.json)
...
@@ -1037,14 +1092,13 @@ To review the log, please navigate to your Airflow console and open osdu_ingest
...
@@ -1037,14 +1092,13 @@ To review the log, please navigate to your Airflow console and open osdu_ingest
_Request:_
_Request:_
```
```http
GET {{storage_api_url}}/api/storage/v2/records/odesprod:work-product-component--WellLog:f8781f4e41b04b96b385d70a0f8a14bf
GET {{storage_api_url}}/api/storage/v2/records/odesprod:work-product-component--WellLog:f8781f4e41b04b96b385d70a0f8a14bf
```
```
_Response:_
_Response:_
```json
```json
{
{
"data":{
"data":{
"Description":"Raster Well Log",
"Description":"Raster Well Log",
...
@@ -1103,7 +1157,7 @@ See below a couple of simple search queries.
...
@@ -1103,7 +1157,7 @@ See below a couple of simple search queries.
#### Example: Search for a metadata record by id using Storage Service API
#### Example: Search for a metadata record by id using Storage Service API
```
```http
GET https://{{STORAGE_HOST}}/records/{{record-id}}
GET https://{{STORAGE_HOST}}/records/{{record-id}}
```
```
...
@@ -1126,7 +1180,7 @@ First, you need to search for the needed metadata record of the dataset (see abo
...
@@ -1126,7 +1180,7 @@ First, you need to search for the needed metadata record of the dataset (see abo
#### Example: Get file DownloadUrl using File Service API
#### Example: Get file DownloadUrl using File Service API
