Як обертати PDF-сторінки за допомогою Rest API у Python

Обертайте PDF-сторінки за допомогою Rest API у Python

Може виникнути багато випадків, коли ви хочете повернути сторінки документів, які мають неправильну орієнтацію або містять дезорієнтовані сторінки. Наприклад, якщо сторінки документа PDF перевернуті догори дном, читати документ може бути досить важко. Обертання сторінок – це дуже корисна допомога для покращення роботи з читачем. Тому простим рішенням для виправлення ротації документів є використання GroupDocs.Merger Python SDK. Ви можете обертати всі сторінки або окремі сторінки PDF-файлу програмним шляхом за допомогою Python SDK. У цій статті ми покажемо вам, як назавжди обертати сторінки PDF-файлів за допомогою REST API у Python.

У цій статті буде розглянуто наступне:

PDF Pages Rotation Rest API та Python SDK

Для ротації PDF-файлів я буду використовувати Python SDK API GroupDocs.Merger Cloud. Ви можете обертати PDF-сторінки, встановлюючи кути обертання, як-от 90, 180 або 270 градусів, за допомогою API GroupDocs.Merger. Він також дозволяє вам розділяти, об’єднувати, видаляти та змінювати порядок однієї сторінки чи колекції сторінок із підтримуваних форматів документів Word, Excel, PDF, PowerPoint і HTML тощо. Ви можете встановити GroupDocs.Merger Cloud SDK у свою програму Python за допомогою такої команди в терміналі:

Ви можете інсталювати GroupDocs.Merger Python SDK у свій код програми Python за допомогою такої команди в консолі:

pip install groupdocs_merger_cloud

Будь ласка, отримайте свій ідентифікатор клієнта та секретний ключ клієнта з інформаційної панелі, перш ніж почати виконувати кроки та доступні приклади коду. Отримавши ідентифікатор і секрет, додайте код, як показано нижче:

# Імпорт SDK для злиття groupdocs
import groupdocs_merger_cloud

# Отримайте app_sid і app_key з https://dashboard.groupdocs.cloud після безкоштовної реєстрації.
app_sid = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
app_key = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# Отримайте конфігурації File API 
configuration = groupdocs_merger_cloud.Configuration(app_sid, app_key)
configuration.api_base_url = "https://api.groupdocs.cloud"
storage_name = "LocalStorage"

Після успішного налаштування Cloud SDK ви можете використовувати перелік Rotation, щоб вибрати відповідне значення обертання за годинниковою стрілкою.

Як обертати всі сторінки в PDF-файлі онлайн на Python

У наступному розділі ви можете назавжди обертати сторінки файлу PDF у хмарі. Обертання базується на кроках у 90 градусів. PDF-сторінки можна повертати на 0/90/180/270 градусів. Нижче наведено кроки для обертання сторінки PDF. Спочатку завантажте PDF-файл у хмару, і завантажений PDF-файл стане доступним у розділі файлів інформаційної панелі в хмарі. Можуть бути певні сценарії, коли потрібно обертати PDF-файли. Ви можете повернути всі сторінки PDF-файлу, виконавши наведені нижче дії.

  • По-перше, створіть екземпляр класу PagesApi.
  • По-друге, створіть екземпляр класу RotateOptions
  • Потім створіть екземпляр FileInfo
  • Тепер укажіть шлях до вхідного PDF-документа та шлях до вихідного файлу
  • Далі встановіть потрібний поворот сторінки, наприклад Rotate90
  • Після цього створіть RotateRequest з RotateOptions як аргумент
  • Нарешті, викличте клас rotate() і збережіть вихідний PDF-документ

У наведеному нижче фрагменті коду показано, як обертати всі сторінки PDF-файлу за допомогою REST API у Python:

# Як повернути всі сторінки PDF-файлу онлайн у Python
try:
    # Створіть екземпляр Pages API
    pagesApi = groupdocs_merger_cloud.PagesApi.from_keys(app_sid, app_key)
     
    options = groupdocs_merger_cloud.RotateOptions()
    options.file_info = groupdocs_merger_cloud.FileInfo("python-testing/sample-file.pdf")
    options.output_path = "python-testing"
    # Встановіть потрібний кут повороту сторінки на 90, 180 або 270 градусів.
    options.mode = "Rotate90"    
     
    result = pagesApi.rotate(groupdocs_merger_cloud.RotateRequest(options))
    print("Successfully rotated all pages of PDF file online: " + result[0].path)
except groupdocs_merger_cloud.ApiException as e:
  print("Exception while calling API: {0}".format(e.message))

Нарешті, наведений вище зразок коду збереже оновлений PDF-файл у хмарі. Ви можете завантажити повернутий PDF-документ за допомогою завантажити фрагмент коду файлу.

Обертати певні сторінки PDF-документа за допомогою Python

Обертання в документі PDF застосовується на рівні сторінки. Тому ви також можете обертати певні сторінки файлу PDF відповідно до ваших вимог. Вам потрібно лише вибрати номер сторінки, до якої потрібно застосувати обертання. Наведені нижче дії пояснюють, як обертати певні сторінки файлу PDF.

  • По-перше, створіть екземпляр PagesApi
  • По-друге, створіть екземпляр класу RotateOptions
  • Потім створіть екземпляр FileInfo class
  • Укажіть шлях до вхідного PDF-документа та шлях до вихідного файлу
  • Призначте точні номери сторінок за допомогою колекції сторінок
  • Встановіть бажаний поворот сторінки на Rotate180
  • Після цього створіть RotateRequest з RotateOptions як аргумент
  • Нарешті, викличте метод rotate() і збережіть вихідний PDF-документ

У наведеному нижче фрагменті коду пояснюється, як обертати певні чи певні сторінки в документі PDF за допомогою Python:

# Як обертати певні сторінки PDF-документа за допомогою Python
try:
    # Створіть екземпляр Pages API
    pagesApi = groupdocs_merger_cloud.PagesApi.from_keys(app_sid, app_key)
     
    options = groupdocs_merger_cloud.RotateOptions()
    options.file_info = groupdocs_merger_cloud.FileInfo("python-testing/sample-file.pdf")
    options.output_path = "python-testing"
    # Укажіть точні номери сторінок, починаючи з 1, через колекцію сторінок
    options.pages = [1, 7]
    options.mode = "Rotate180"    
     
    result = pagesApi.rotate(groupdocs_merger_cloud.RotateRequest(options))
    print("Successfully rotated certain pages of PDF file online: " + result[0].path)
except groupdocs_merger_cloud.ApiException as e:
  print("Exception while calling API: {0}".format(e.message))

Нарешті, наведений вище зразок коду збереже вихідний PDF-файл у хмарі.

Обертайте сторінки PDF за діапазоном номерів сторінок за допомогою Python

Ви також можете обертати сторінки PDF за номером сторінки. Щоб застосувати ротацію, потрібно вказати номер початкової та кінцевої сторінок. Наведені нижче кроки пояснюють, як обертати сторінки PDF за номерами сторінок у файлі PDF.

  • По-перше, створіть екземпляр PagesApi
  • Далі створіть екземпляр класу RotateOptions
  • Потім створіть екземпляр FileInfo class
  • Укажіть шлях до вхідного PDF-документа та шлях до вихідного файлу
  • Встановіть потрібний поворот сторінки, наприклад Rotate270
  • Встановіть значення номера початкової та кінцевої сторінок;
  • Далі встановіть діапазон\режим на EvenPages
  • Після цього створіть RotateRequest з RotateOptions як аргумент
  • Нарешті, викличте метод rotate() і збережіть вихідний PDF-документ

Наведений нижче фрагмент коду показує, як повертати сторінки в документі PDF, надаючи номери сторінок за допомогою Python Rest API:

# Як обертати сторінки PDF за діапазоном номерів сторінок за допомогою Python
try:
    # Створіть екземпляр Pages API
    pagesApi = groupdocs_merger_cloud.PagesApi.from_keys(app_sid, app_key)
     
    options = groupdocs_merger_cloud.RotateOptions()
    options.file_info = groupdocs_merger_cloud.FileInfo("python-testing/sample-file.pdf")
    options.output_path = "python-testing"
    options.mode = "Rotate270"
    options.start_page_number = 1
    options.end_page_number = 10
    # Установіть режим діапазону на «Усі сторінки», «Непарні сторінки» або «Парні сторінки»
    options.range_mode = "EvenPages" 
     
    result = pagesApi.rotate(groupdocs_merger_cloud.RotateRequest(options))
    print("Successfully rotated PDF file pages using Python: " + result[0].path)
except groupdocs_merger_cloud.ApiException as e:
  print("Exception while calling API: {0}".format(e.message))

Наведений вище приклад коду збереже вихідний PDF-документ у хмарі.

Повертайте сторінки PDF безкоштовно онлайн

Як обертати сторінки PDF онлайн безкоштовно? Будь ласка, спробуйте безкоштовний онлайн-інструмент обертання PDF, щоб безкоштовно обертати PDF онлайн, розроблений за допомогою вищезазначеного API.

Підводячи підсумки

Це підводить нас до завершення цієї статті. Про ці матеріали ви дізналися з цієї статті:

  • як повернути всі сторінки документа PDF за допомогою Python;
  • як обертати певні сторінки PDF-файлу за допомогою Python;
  • як обертати сторінки PDF за діапазоном сторінок у Python;

Крім того, ви можете дізнатися більше про GroupDocs.Merge Cloud API за допомогою документації. У нас також є розділ API Reference, який дозволяє візуалізувати наші хмарні API і взаємодіяти з ними безпосередньо через веб-переглядач. Щодо інших цікавих тем, залишайтеся на зв’язку, щоб регулярно отримувати оновлення. Радимо вам дотримуватися нашого посібника із початку роботи.

Нарешті, groupdocs.cloud зараз пише нові статті в блозі про різні рішення форматів файлів за допомогою REST API. Слідкуйте за останніми оновленнями.

Задайте питання

Якщо у вас є будь-які запитання щодо онлайн-ротатора PDF-сторінок, будь ласка, не соромтеся запитати нас на безкоштовному форумі підтримки

поширені запитання

Як назавжди обертати PDF-документи в Python?

Будь ласка, перейдіть за цим посиланням, щоб дізнатися фрагмент коду Python про те, як постійно повертати PDF-файл у Python.

Як обертати PDF-файл онлайн за допомогою REST API?

Створіть екземпляр PagesApi, установіть значення RotateOptions і викличте метод pagesApi.rotate() за допомогою RotateRequest, щоб повернути PDF-файл і зберегти його онлайн на Python.

Як встановити безкоштовну бібліотеку для завантаження PDF-сторінок?

Ви можете встановити PDF rotator безкоштовно завантажити бібліотеку Python, щоб програмно обертати PDF у Windows.

Як повернути сторінки PDF у Windows?

Будь ласка, перейдіть це посилання, щоб безкоштовно завантажити ротатор сторінок PDF. Це офлайн-програмне забезпечення використовується для виконання операцій із різними форматами файлів, у тому числі обертання документів у вікнах, одним клацанням миші.

Дивись також