Hướng dẫn bắt đầu nhanh về Python
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Hướng dẫn bắt đầu nhanh giải thích cách thiết lập và chạy một ứng dụng gọi một API Google Workspace. Hướng dẫn bắt đầu nhanh này sử dụng phương pháp xác thực đơn giản phù hợp với môi trường kiểm thử. Đối với môi trường phát hành công khai, bạn nên tìm hiểu về xác thực và uỷ quyền trước khi chọn thông tin đăng nhập để truy cập phù hợp với ứng dụng của bạn.
Tạo một ứng dụng dòng lệnh Python đưa ra yêu cầu đối với Drive Labels API.
Mục tiêu
- Thiết lập môi trường.
- Cài đặt thư viện ứng dụng.
- Thiết lập mẫu.
- Chạy mẫu.
Điều kiện tiên quyết
Thiết lập môi trường
Để hoàn tất hướng dẫn nhanh này, hãy thiết lập môi trường của bạn.
Bật API
Trước khi sử dụng API của Google, bạn cần bật các API đó trong một dự án Google Cloud.
Bạn có thể bật một hoặc nhiều API trong một dự án Google Cloud.
Uỷ quyền thông tin đăng nhập cho một ứng dụng máy tính
Để xác thực người dùng cuối và truy cập vào dữ liệu người dùng trong ứng dụng của mình, bạn cần tạo một hoặc nhiều Mã ứng dụng OAuth 2.0. Mã ứng dụng khách được dùng để xác định một ứng dụng duy nhất cho các máy chủ OAuth của Google. Nếu ứng dụng của bạn chạy trên nhiều nền tảng, bạn phải tạo một mã nhận dạng ứng dụng riêng cho mỗi nền tảng.
-
Trong bảng điều khiển Google Cloud, hãy chuyển đến phần Trình đơn menu
> Google Auth platform
> Ứng dụng.
Chuyển đến mục Khách hàng
- Nhấp vào Tạo ứng dụng.
- Nhấp vào Loại ứng dụng > Ứng dụng dành cho máy tính.
- Trong trường Name (Tên), hãy nhập tên cho thông tin đăng nhập. Tên này chỉ xuất hiện trong Google Cloud Console.
- Nhấp vào Tạo.
Thông tin xác thực mới tạo sẽ xuất hiện trong phần "Mã ứng dụng OAuth 2.0".
- Lưu tệp JSON đã tải xuống dưới dạng
credentials.json rồi di chuyển tệp đó vào thư mục làm việc của bạn.
Cài đặt thư viện ứng dụng Google
Để biết các lựa chọn cài đặt thay thế, hãy tham khảo phần Cài đặt của thư viện Python.
- Trong thư mục làm việc, hãy tạo một tệp có tên là
quickstart.py.
Thêm mã sau vào quickstart.py:
import os.path
from google.auth.transport.requests import Request
from google.oauth2.credentials import Credentials
from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError
# If modifying these scopes, delete the file token.json.
SCOPES = ['https://www.googleapis.com/auth/drive.labels.readonly']
def main():
"""Shows basic usage of the Drive Labels API.
Prints the first page of the customer's Labels.
"""
creds = None
# The file token.json stores the user's access and refresh tokens, and is
# created automatically when the authorization flow completes for the first
# time.
if os.path.exists('token.json'):
creds = Credentials.from_authorized_user_file('token.json', SCOPES)
# If there are no (valid) credentials available, let the user log in.
if not creds or not creds.valid:
if creds and creds.expired and creds.refresh_token:
creds.refresh(Request())
else:
flow = InstalledAppFlow.from_client_secrets_file('credentials.json',
SCOPES)
creds = flow.run_local_server(port=0)
# Save the credentials for the next run
with open('token.json', 'w') as token:
token.write(creds.to_json())
try:
service = build('drivelabels', 'v2', credentials=creds)
response = service.labels().list(
view='LABEL_VIEW_FULL').execute()
labels = response['labels']
if not labels:
print('No Labels')
else:
for label in labels:
name = label['name']
title = label['properties']['title']
print(u'{0}:\t{1}'.format(name, title))
except HttpError as error:
# TODO (developer) - Handle errors from Labels API.
print(f'An error occurred: {error}')
if __name__ == '__main__':
main()
Chạy mẫu
Trong thư mục làm việc, hãy tạo và chạy mẫu:
python quickstart.py
Trong lần đầu tiên chạy mẫu, bạn sẽ được nhắc uỷ quyền truy cập:
- Nếu chưa đăng nhập vào Tài khoản Google, bạn sẽ được nhắc đăng nhập. Nếu bạn đã đăng nhập vào nhiều tài khoản, hãy chọn một tài khoản để dùng cho việc uỷ quyền.
- Nhấp vào Chấp nhận.
Thông tin uỷ quyền được lưu trữ trong hệ thống tệp, vì vậy, vào lần tiếp theo chạy mã mẫu, bạn sẽ không được nhắc uỷ quyền.
Bạn đã tạo thành công ứng dụng Python đầu tiên gửi yêu cầu đến Drive Labels API.
Các bước tiếp theo
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-08-29 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-29 UTC."],[],[],null,["Quickstarts explain how to set up and run an app that calls a\nGoogle Workspace API. This quickstart uses a\nsimplified authentication approach that is appropriate for a testing\nenvironment. For a production environment, we recommend learning about\n[authentication and authorization](/workspace/guides/auth-overview)\nbefore\n[choosing the access credentials](/workspace/guides/create-credentials#choose_the_access_credential_that_is_right_for_you)\nthat are appropriate for your app.\n\nCreate a Python command-line application that makes requests to the\nDrive Labels API.\n\nObjectives\n\n- Set up your environment.\n- Install the client library.\n- Set up the sample.\n- Run the sample.\n\nPrerequisites\n\n- Python 2.6 or greater\n- The [pip](https://pypi.python.org/pypi/pip) package management tool\n- [A Google Cloud project](/workspace/guides/create-project).\n\n\u003c!-- --\u003e\n\n- A Google Account.\n\nSet up your environment\n\nTo complete this quickstart, set up your environment.\n\nEnable the API Before using Google APIs, you need to turn them on in a Google Cloud project. You can turn on one or more APIs in a single Google Cloud project.\n\n- In the Google Cloud console, enable the Drive Labels API.\n\n [Enable the API](https://console.cloud.google.com/flows/enableapi?apiid=drivelabels.googleapis.com)\n\nAuthorize credentials for a desktop application To authenticate end users and access user data in your app, you need to create one or more OAuth 2.0 Client IDs. A client ID is used to identify a single app to Google's OAuth servers. If your app runs on multiple platforms, you must create a separate client ID for each platform.\n\n1. In the Google Cloud console, go to Menu menu \\\u003e **Google Auth platform** \\\u003e **Clients** .\n\n [Go to Clients](https://console.cloud.google.com/auth/clients)\n2. Click **Create Client**.\n3. Click **Application type** \\\u003e **Desktop app**.\n4. In the **Name** field, type a name for the credential. This name is only shown in the Google Cloud console.\n5. Click **Create** .\n\n\n The newly created credential appears under \"OAuth 2.0 Client IDs.\"\n6. Save the downloaded JSON file as `credentials.json`, and move the file to your working directory.\n\nInstall the Google client library\n\n- Install the Google client library for Python:\n\n pip install --upgrade google-api-python-client google-auth-httplib2 google-auth-oauthlib\n\nFor alternate installation options, refer to the Python library's\n[Installation section](/api-client-library/python/start/installation#installation).\n\nConfigure the sample\n\n1. In your working directory, create a file named `quickstart.py`.\n2. Include the following code in `quickstart.py`:\n\n import os.path\n\n from google.auth.transport.requests import Request\n from google.oauth2.credentials import Credentials\n from google_auth_oauthlib.flow import InstalledAppFlow\n from googleapiclient.discovery import build\n from googleapiclient.errors import HttpError\n\n # If modifying these scopes, delete the file token.json.\n SCOPES = ['https://www.googleapis.com/auth/drive.labels.readonly']\n\n def main():\n \"\"\"Shows basic usage of the Drive Labels API.\n\n Prints the first page of the customer's Labels.\n \"\"\"\n creds = None\n # The file token.json stores the user's access and refresh tokens, and is\n # created automatically when the authorization flow completes for the first\n # time.\n if os.path.exists('token.json'):\n creds = Credentials.from_authorized_user_file('token.json', SCOPES)\n # If there are no (valid) credentials available, let the user log in.\n if not creds or not creds.valid:\n if creds and creds.expired and creds.refresh_token:\n creds.refresh(Request())\n else:\n flow = InstalledAppFlow.from_client_secrets_file('credentials.json',\n SCOPES)\n creds = flow.run_local_server(port=0)\n # Save the credentials for the next run\n with open('token.json', 'w') as token:\n token.write(creds.to_json())\n try:\n service = build('drivelabels', 'v2', credentials=creds)\n response = service.labels().list(\n view='LABEL_VIEW_FULL').execute()\n labels = response['labels']\n\n if not labels:\n print('No Labels')\n else:\n for label in labels:\n name = label['name']\n title = label['properties']['title']\n print(u'{0}:\\t{1}'.format(name, title))\n except HttpError as error:\n # TODO (developer) - Handle errors from Labels API.\n print(f'An error occurred: {error}')\n\n if __name__ == '__main__':\n main()\n\nRun the sample\n\n1. In your working directory, build and run the sample:\n\n python quickstart.py\n\n2. The first time you run the sample, it prompts you to authorize access:\n\n 1. If you're not already signed in to your Google Account, you're prompted to sign in. If you're signed in to multiple accounts, select one account to use for authorization.\n 2. Click **Accept**.\n\n Authorization information is stored in the file system, so the next time you\n run the sample code, you aren't prompted for authorization.\n\nYou have successfully created your first Python application that makes requests to\nthe Drive Labels API.\n\nNext steps\n\n- [Troubleshoot authentication and authorization issues](/workspace/drive/labels/troubleshoot-authentication-authorization)\n- [Google APIs Client for Python documentation](/api-client-library/python)"]]
