Merge pull request #861 from AdobeDocs/python-4.0-release-updates

python sdk 4.0 release updates

Author: jasnoors

src/pages/overview/document-generation-api/quickstarts/python/index.md

@@ -199,6 +199,8 @@ with open(output_file_path, "wb") as file:
     file.write(stream_asset.get_input_stream())
 ```
 
+![alt](shot8.png)
+
 Here's the complete application (`src/documentmerge/merge_document_to_pdf.py`):
 
 ```python

src/pages/overview/document-generation-api/quickstarts/python/shot7.png

@@ -644,7 +644,7 @@ pip hash <download_dir>/pdfservices-sdk-4.0.0.tar.gz
 2.  Verify the hash matches the value published here.
 
 ```
-08d1c40995658e380c7e5d2fec4cebfbfc22b246582719c5451ae708a28b6a09
+9537bf4659d3e939b86f0d925dec2eafc1fc533d09c96674791389b09c88e8c9
 ```
 
 ###### To generate tagged PDF from the sample file

src/pages/overview/document-generation-api/quickstarts/python/shot8.png

@@ -29,12 +29,10 @@ the SDK supports custom timeouts for the API calls. You can tailor the
 timeout settings for your environment and network speed. In addition to
 the details below, you can refer to working code samples:
 
-[//]: # (TODO update python sample)
-
 -   [Java](https://github.com/adobe/pdfservices-java-sdk-samples/blob/master/src/main/java/com/adobe/pdfservices/operation/samples/customconfigurations/CreatePDFWithCustomTimeouts.java)
 -   [.NET](https://github.com/adobe/PDFServices.NET.SDK.Samples/blob/master/CreatePDFWithCustomTimeouts/Program.cs)
 -   [Node.js](https://github.com/adobe/pdfservices-node-sdk-samples/blob/master/src/customconfigurations/create-pdf-with-custom-timeouts.js)
--   [Python](https://github.com/adobe/pdfservices-python-sdk-samples/blob/master/src/extractpdf/extract_txt_from_pdf_with_custom_timeouts.py)
+-   [Python](https://github.com/adobe/pdfservices-python-sdk-samples/blob/main/src/customconfigurations/create_pdf_with_custom_timeouts.py)
 
 ### Java timeout configuration
 

src/pages/overview/pdf-accessibility-auto-tag-api/gettingstarted.md

@@ -45,7 +45,6 @@ To complete this guide, you will need:
 
 3) At the command line, change to the directory you created, and run the following command to install the Python SDK: `pip install pdfservices-sdk`.
 
-[//]: # (TODO update ss)
 ![alt](shot7.png)
 
 At this point, we've installed the Python SDK for Adobe PDF Services API as a dependency for our project and have copied over our credentials files.
@@ -136,6 +135,7 @@ with open(output_file_path, "wb") as file:
     file.write(stream_asset.get_input_stream())
 ```
 
+![alt](shot8.png)
 
 Here's the complete application (`autotag.py`):
 

src/pages/overview/pdf-accessibility-auto-tag-api/howtos/index.md

@@ -692,10 +692,8 @@ pip hash <download_dir>/pdfservices-sdk-4.0.0.tar.gz
 2.  Above command will return the hash of downloaded package.
 3.  Verify the hash matches the value published here.
 
-[//]: # (TODO Update hash value)
-
 ```
-08d1c40995658e380c7e5d2fec4cebfbfc22b246582719c5451ae708a28b6a09
+9537bf4659d3e939b86f0d925dec2eafc1fc533d09c96674791389b09c88e8c9
 ```
 
 ## Public API
@@ -727,35 +725,4 @@ After downloading the zip, you can run the samples in the zip directly by settin
        "organization_id": "<YOUR_ORGNIZATION_ID>"
     }
 }
-```
-
-## Public API
-
-PDF Services API is accessible directly via REST APIs which requires Adobe-provided credential for authentication. Once you've completed the [Getting Credentials](https://acrobatservices.adobe.com/dc-integration-creation-app-cdn/main.html?api=pdf-services-api) workflow, a zip file automatically downloads that contains content whose structure varies based on whether you opted to download personalized code samples. The zip file structures are as follows:
-
--   **Personalized Download**: Downloads the zip which contains `adobe-dc-pdf-services-sdk-java-samples` with a preconfigured `pdfservices-api-credentials.json` file.
--   **Non Personalized Download**: Downloads the `pdfservices-api-credentials.json` with your preconfigured credentials.
-
-After downloading the zip, you can run the samples in the zip directly by setting up the two environment variables `PDF_SERVICES_CLIENT_ID` and `PDF_SERVICES_CLIENT_SECRET` by running the following cammands :
-
-- **Windows:**
-   - `set PDF_SERVICES_CLIENT_ID=<YOUR CLIENT ID>`
-   - `set PDF_SERVICES_CLIENT_SECRET=<YOUR CLIENT SECRET>`
-
-- **MacOS/Linux:**
-   - `export PDF_SERVICES_CLIENT_ID=<YOUR CLIENT ID>`
-   - `export PDF_SERVICES_CLIENT_SECRET=<YOUR CLIENT SECRET>`
-
-**Example pdfservices-api-credentials.json file**
-
-```json 
-{
-    "client_credentials": {
-        "client_id": "<YOUR_CLIENT_ID>",
-        "client_secret": "<YOUR_CLIENT_SECRET>"
-    },
-    "service_principal_credentials": {
-       "organization_id": "<YOUR_ORGNIZATION_ID>"
-    }
-}
-```
+```

src/pages/overview/pdf-accessibility-auto-tag-api/quickstarts/python/index.md

@@ -45,7 +45,6 @@ To complete this guide, you will need:
 
 3) At the command line, change to the directory you created, and run the following command to install the Python SDK: `pip install pdfservices-sdk`.
 
-[//]: # (TODO update this ss  )
 ![alt](shot7.png)
 
 At this point, we've installed the Python SDK for Adobe PDF Services API as a dependency for our project and have copied over our credentials files.
@@ -60,7 +59,7 @@ Now you're ready to begin coding.
 
 1) We'll begin by including our required dependencies:
 
-```javascript
+```python
 import logging
 import os
 from datetime import datetime
@@ -93,7 +92,7 @@ from adobe.pdfservices.operation.pdfjobs.result.eseal_pdf_result import ESealPDF
 
 3) Next, we can create our credentials and use them:
 
-```javascript
+```python
 # Initial setup, create credentials instance
 credentials = ServicePrincipalCredentials(
     client_id=os.getenv('PDF_SERVICES_CLIENT_ID'),
@@ -105,7 +104,7 @@ pdf_services = PDFServices(credentials=credentials)
 
 4) Now, let's create an asset from source file and upload.
 
-```javascript
+```python
 pdf_file = open('./sampleInvoice.pdf', 'rb')
 file_input_stream = pdf_file.read()
 pdf_file.close()
@@ -121,7 +120,7 @@ seal_image_asset = pdf_services.upload(input_stream=seal_image_input_stream, mim
 
 5) Now, let's create the parameters and the job:
 
-```javascript
+```python
 # Set the document level permission to be applied for output document
 document_level_permission = DocumentLevelPermission.FORM_FILLING
 
@@ -185,7 +184,7 @@ electronic_seal_job = PDFElectronicSealJob(input_asset=asset,
 
 6) The next code block submits the job and gets the job result:
 
-```javascript
+```python
 # Submit the job and gets the job result
 location = pdf_services.submit(electronic_seal_job)
 pdf_services_response = pdf_services.get_job_result(location, ESealPDFResult)
@@ -197,15 +196,15 @@ stream_asset: StreamAsset = pdf_services.get_content(result_asset)
 
 7) The next code block saves the result at the specified location:
 
-```javascript
+```python
 output_file_path = 'output/ElectronicSeal.pdf'
 with open(output_file_path, "wb") as file:
     file.write(stream_asset.get_input_stream())
 ```
 
 Here's the complete application (`src/electronicseal/electronic_seal.py`):
 
-```javascript
+```python
 # Initialize the logger
 logging.basicConfig(level=logging.INFO)