Để thảo luận và đưa ra ý kiến phản hồi về các sản phẩm của chúng tôi, hãy tham gia kênh Discord chính thức của Google Ads trong máy chủ Cộng đồng quảng cáo và đo lường của Google.
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 này sẽ hướng dẫn bạn cách thiết lập OAuth 2.0 để truy cập API bằng thông tin đăng nhập của riêng bạn và quy trình trên máy tính hoặc quy trình trên web. Bạn chỉ cần thực hiện các bước này một lần, trừ phi bạn thu hồi, xoá hoặc cần thay đổi các phạm vi được phép cho thông tin đăng nhập OAuth 2.0.
Lưu lại mã ứng dụng khách và khoá bí mật của ứng dụng khách, sau đó quay lại trang này.
Thiết lập thư viện ứng dụng
Trong một thiết bị đầu cuối, hãy chạy ví dụ generate_user_credentials.pl. Bạn có thể sửa đổi các giá trị INSERT_XXX_HERE trong ví dụ trước khi chạy hoặc sử dụng các đối số dòng lệnh -client_id cho mã ứng dụng và -client_secret cho khoá bí mật của ứng dụng.
Ví dụ về mã này nhắc bạn truy cập vào một URL mà bạn phải uỷ quyền cho ứng dụng truy cập vào tài khoản Google Ads của bạn thay cho bạn.
Paste this url in your browser:
https://accounts.google.com/o/oauth2/v2/auth?response_type=code&access_type=offline&client_id=...
Truy cập vào URL đó trong một phiên duyệt web ở chế độ riêng tư hoặc cửa sổ ẩn danh. Đăng nhập bằng Tài khoản Google mà bạn dùng để truy cập vào Google Ads. Thông thường, đây là email đăng nhập vào một tài khoản người quản lý Google Ads chứa tất cả các tài khoản mà bạn cần quản lý trong hệ thống phân cấp tài khoản của tài khoản đó. Nhấp vào Tiếp tục trên màn hình đồng ý OAuth 2.0.
Bạn sẽ được chuyển đến một trang có thông báo cho biết rằng quá trình uỷ quyền đã thành công.
Authorization code was successfully retrieved.
Quay lại bảng điều khiển nơi bạn đang chạy ví dụ về mã. Bạn sẽ thấy ví dụ về mã đã hoàn tất và đang hiển thị mã làm mới cũng như một số hướng dẫn, sau đó là những hướng dẫn bạn cần làm theo để định cấu hình thư viện ứng dụng:
Replace the following keys and values in your googleads.properties configuration file:
clientId==***********************apps.googleusercontent.com
clientSecret=****
refreshToken=****
Nhấn Ctrl + C để kết thúc quá trình. Sau đó, hãy sao chép mã làm mới đã tạo cùng với mã ứng dụng và khoá bí mật ứng dụng vào tệp googleads.properties hoặc lưu mã này ở nơi khác để sử dụng nếu khởi tạo thư viện trong thời gian chạy.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-31 UTC."],[[["\u003cp\u003eThis guide provides instructions on setting up OAuth2 for API access using your own credentials.\u003c/p\u003e\n"],["\u003cp\u003eYou can set this up using either the desktop or web flow, requiring a one-time setup unless credentials are modified.\u003c/p\u003e\n"],["\u003cp\u003eThe process involves creating OAuth2 credentials, setting up the client library, and authorizing access to your Google Ads account.\u003c/p\u003e\n"],["\u003cp\u003eYou'll need to obtain a refresh token, client ID, and client secret to configure the client library for API access.\u003c/p\u003e\n"]]],[],null,["# OAuth Desktop and Web Application Flows\n\nThis guide walks you through how to set up OAuth 2.0 for API access using your\nown credentials and either the [desktop flow](/identity/protocols/oauth2/native-app)\nor the [web flow](/identity/protocols/oauth2/web-server). These steps only need\nto be done once, unless you revoke, delete, or need to change the allowed scopes\nfor your OAuth 2.0 credentials.\n\nCreate OAuth 2.0 credentials\n----------------------------\n\n1. Follow the steps to [configure a Google API Console project for the\n Google Ads API](/google-ads/api/docs/oauth/cloud-project).\n\n2. Note the *client ID* and *client secret*, then come back to this page.\n\nSet up the client library\n-------------------------\n\n| The following steps run an interactive code example, which will require you to provide input.\n\n1. In a terminal, run the [`generate_user_credentials.pl`](https://github.com/googleads/google-ads-perl/blob/HEAD/examples/authentication/generate_user_credentials.pl) example. You can either modify the\n `INSERT_XXX_HERE` values in the example before running or use the command-line\n arguments `-client_id` for client ID and `-client_secret` for\n client secret.\n\n ```\n perl generate_user_credentials.pl -client_id {client_id} -client_secret {client_secret}\n ```\n2. This code example prompts you to visit a URL where you must authorize the app to access\n your Google Ads account on your behalf.\n\n ```\n Paste this url in your browser:\n https://accounts.google.com/o/oauth2/v2/auth?response_type=code&access_type=offline&client_id=...\n ```\n\n Navigate to the URL in a private browser session or an incognito window. Sign in\n with the Google Account you use to access Google Ads. Usually, this is a login email to a\n Google Ads manager account that contains all the accounts you need to manage under its\n account hierarchy. Click **Continue** on the OAuth 2.0 consent screen.\n\n You'll be taken to a page with a message indicating that the authorization succeeded. \n\n ```\n Authorization code was successfully retrieved.\n ```\n3. Return to the console where you're running the code example. You'll see that the\n code example has completed and is displaying your refresh token and some instructions,\n followed by the instructions you'll need to follow to configure the client library:\n\n ```scdoc\n Replace the following keys and values in your googleads.properties configuration file:\n\n clientId==***********************apps.googleusercontent.com\n clientSecret=****\n refreshToken=****\n ```\n4. Press `Ctrl + C` to terminate the process. Then copy the generated\n refresh token along with the client ID and client secret into your\n `googleads.properties` file or save it somewhere else to use if\n instantiating the library at runtime."]]
