Để 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.
Thư viện này tìm kiếm một tệp cấu hình trong System.getProperty("user.home") + "/ads.properties". Bạn có thể ghi đè đường dẫn và tên tệp này trong thời gian chạy khi tạo GoogleAdsClient bằng một trong hai cơ chế sau:
Gọi fromPropertiesFile(PATH_TO_CONFIG_FILE), trong đó PATH_TO_CONFIG_FILE là đường dẫn và tên tệp của tệp cấu hình.
Đặt biến môi trường GOOGLE_ADS_CONFIGURATION_FILE_PATH thành đường dẫn và tên tệp của tệp cấu hình, rồi gọi fromPropertiesFile().
Định dạng của tệp cấu hình là định dạng của tệp Properties Java gồm các cặp khoá-giá trị. Các khoá được hỗ trợ sẽ khác nhau tuỳ thuộc vào quy trình xác thực đã chọn.
Các khoá được hỗ trợ cho quy trình ứng dụng trên máy tính và web
Nếu bạn đang sử dụng quy trình ứng dụng máy tính hoặc web, thì các khoá được hỗ trợ sẽ như sau:
# Credential for accessing Google's OAuth servers.# Provided by console.cloud.google.com.
api.googleads.clientId=INSERT_CLIENT_ID_HERE
# Credential for accessing Google's OAuth servers.# Provided by console.cloud.google.com.
api.googleads.clientSecret=INSERT_CLIENT_SECRET_HERE
# Renewable OAuth credential associated with 1 or more Google Ads accounts.
api.googleads.refreshToken=INSERT_REFRESH_TOKEN_HERE
# Token which provides access to the Google Ads API in general. It does not# grant access to any particular ad account (OAuth is used for this purpose).
api.googleads.developerToken=INSERT_DEVELOPER_TOKEN_HERE
# Required for manager accounts only: Specify the login customer ID used to# authenticate API calls. This will be the customer ID of the authenticated# manager account. You can also specify this later in code if your application# uses multiple manager account + OAuth pairs.## api.googleads.loginCustomerId=INSERT_LOGIN_CUSTOMER_ID_HERE# Only required if explicitly instructed by the service documentation.# api.googleads.linkedCustomerId=INSERT_LINKED_CUSTOMER_ID_HERE# Maximum allowed response payload size, in bytes.# Customize this to allow response sizes for GoogleAdsService.search and# GoogleAdsService.searchStream API calls to exceed the default limit of 64MB.# api.googleads.maxInboundMessageBytes=INSERT_MAX_INBOUND_MESSAGE_BYTES_HERE
Các khoá được hỗ trợ cho tài khoản dịch vụ
Nếu bạn đang sử dụng quy trình tài khoản dịch vụ, thì các khoá được hỗ trợ sẽ như sau:
# Path to the service account secrets file in JSON format.# Provided by console.cloud.google.com.
api.googleads.serviceAccountSecretsPath=INSERT_PATH_TO_JSON_HERE
# Email address of the user to impersonate.# This should be a user who has access to your Google Ads account and is in the same# Google Apps Domain as the service account.
api.googleads.serviceAccountUser=INSERT_USER_EMAIL_ADDRESS_HERE
# Token which provides access to the Google Ads API in general. It does not# grant access to any particular ad account (OAuth is used for this purpose).
api.googleads.developerToken=INSERT_DEVELOPER_TOKEN_HERE
# Required for manager accounts only: Specify the login customer ID used to# authenticate API calls. This will be the customer ID of the authenticated# manager account. You can also specify this later in code if your application# uses multiple manager account + OAuth pairs.## api.googleads.loginCustomerId=INSERT_LOGIN_CUSTOMER_ID_HERE
GoogleAdsClient và trình tạo của nó hỗ trợ kết hợp nhiều chiến lược cấu hình. Ví dụ: bạn có thể sử dụng các biến môi trường để định cấu hình thông tin đăng nhập của phiên bản và một tệp thuộc tính cho các thuộc tính khác bằng đoạn mã sau.
Trong ví dụ này, thư viện ứng dụng sẽ sử dụng giá trị trong tệp thuộc tính cho mọi thuộc tính được xác định thông qua cả biến môi trường và một mục trong tệp thuộc tính. Để có hành vi ngược lại, bạn chỉ cần gọi fromPropertiesFile() trước fromEnvironment().
Bạn có thể thực hiện các thay đổi khác trong thời gian chạy bằng cách sử dụng các phương thức định cấu hình khác của trình tạo trước khi gọi build().
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2025-09-05 UTC."],[[["\u003cp\u003eThe Google Ads API Java client library uses a configuration file (\u003ccode\u003eads.properties\u003c/code\u003e by default) or environment variables for settings like credentials and customer IDs.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can authenticate using desktop/web application flows (client ID, secret, refresh token) or service accounts (JSON key file path, impersonated email).\u003c/p\u003e\n"],["\u003cp\u003eThe configuration file format follows Java Properties standards, with specific keys for each authentication method.\u003c/p\u003e\n"],["\u003cp\u003eEnvironment variables can override or complement the configuration file, offering flexibility in setting up the client.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eGoogleAdsClient\u003c/code\u003e builder allows combining configuration approaches, prioritizing the last method called for overlapping settings.\u003c/p\u003e\n"]]],[],null,["# Configuration\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nThe library looks for a configuration file in\n`System.getProperty(\"user.home\") + \"/ads.properties\"`. You can override this\npath and file name at runtime when constructing the `GoogleAdsClient` using\neither of the following mechanisms:\n\n- Call `fromPropertiesFile(PATH_TO_CONFIG_FILE)`, where `PATH_TO_CONFIG_FILE` is the path and file name of your configuration file.\n- Set the environment variable `GOOGLE_ADS_CONFIGURATION_FILE_PATH` to the path and file name of your configuration file, and then call `fromPropertiesFile()`.\n\nThe format of the configuration file is that of a Java\n[Properties](//docs.oracle.com/javase/tutorial/essential/environment/properties.html)\nfile of key value pairs. The supported keys vary depending on the chosen\nauthentication flow.\n\nSupported keys for desktop and web application flows\n----------------------------------------------------\n\nIf you are using the [desktop](/google-ads/api/docs/client-libs/java/oauth-desktop) or\n[web](/google-ads/api/docs/client-libs/java/oauth-web) application flow, the supported keys\nare as follows: \n\n # Credential for accessing Google's OAuth servers.\n # Provided by console.cloud.google.com.\n api.googleads.clientId=INSERT_CLIENT_ID_HERE\n\n # Credential for accessing Google's OAuth servers.\n # Provided by console.cloud.google.com.\n api.googleads.clientSecret=INSERT_CLIENT_SECRET_HERE\n\n # Renewable OAuth credential associated with 1 or more Google Ads accounts.\n api.googleads.refreshToken=INSERT_REFRESH_TOKEN_HERE\n\n # Token which provides access to the Google Ads API in general. It does not\n # grant access to any particular ad account (OAuth is used for this purpose).\n api.googleads.developerToken=INSERT_DEVELOPER_TOKEN_HERE\n\n # Required for manager accounts only: Specify the login customer ID used to\n # authenticate API calls. This will be the customer ID of the authenticated\n # manager account. You can also specify this later in code if your application\n # uses multiple manager account + OAuth pairs.\n #\n # api.googleads.loginCustomerId=INSERT_LOGIN_CUSTOMER_ID_HERE\n\n # Only required if explicitly instructed by the service documentation.\n # api.googleads.linkedCustomerId=INSERT_LINKED_CUSTOMER_ID_HERE\n\n # Maximum allowed response payload size, in bytes.\n # Customize this to allow response sizes for GoogleAdsService.search and\n # GoogleAdsService.searchStream API calls to exceed the default limit of 64MB.\n # api.googleads.maxInboundMessageBytes=INSERT_MAX_INBOUND_MESSAGE_BYTES_HERE\n\nSupported keys for service accounts\n-----------------------------------\n\nIf you are using the [service account](/google-ads/api/docs/client-libs/java/oauth-service)\nflow, the supported keys are as follows: \n\n # Path to the service account secrets file in JSON format.\n # Provided by console.cloud.google.com.\n api.googleads.serviceAccountSecretsPath=INSERT_PATH_TO_JSON_HERE\n\n # Email address of the user to impersonate.\n # This should be a user who has access to your Google Ads account and is in the same\n # Google Apps Domain as the service account.\n api.googleads.serviceAccountUser=INSERT_USER_EMAIL_ADDRESS_HERE\n\n # Token which provides access to the Google Ads API in general. It does not\n # grant access to any particular ad account (OAuth is used for this purpose).\n api.googleads.developerToken=INSERT_DEVELOPER_TOKEN_HERE\n\n # Required for manager accounts only: Specify the login customer ID used to\n # authenticate API calls. This will be the customer ID of the authenticated\n # manager account. You can also specify this later in code if your application\n # uses multiple manager account + OAuth pairs.\n #\n # api.googleads.loginCustomerId=INSERT_LOGIN_CUSTOMER_ID_HERE\n\nUsing environment variables\n---------------------------\n\nThe library supports all of the [environment variables common to all Google Ads API\nclient libraries](/google-ads/api/docs/client-libs#configuration). The table below shows the\nenvironment variable that corresponds to each configuration file property.\n\n| Configuration file property | Environment variable |\n|-------------------------------------------|----------------------------------------|\n| `api.googleads.developerToken` | `GOOGLE_ADS_DEVELOPER_TOKEN` |\n| `api.googleads.clientId` | `GOOGLE_ADS_CLIENT_ID` |\n| `api.googleads.clientSecret` | `GOOGLE_ADS_CLIENT_SECRET` |\n| `api.googleads.refreshToken` | `GOOGLE_ADS_REFRESH_TOKEN` |\n| `api.googleads.serviceAccountSecretsPath` | `GOOGLE_ADS_JSON_KEY_FILE_PATH` |\n| `api.googleads.serviceAccountUser` | `GOOGLE_ADS_IMPERSONATED_EMAIL` |\n| `api.googleads.loginCustomerId` | `GOOGLE_ADS_LOGIN_CUSTOMER_ID` |\n| `api.googleads.linkedCustomerId` | `GOOGLE_ADS_LINKED_CUSTOMER_ID` |\n| `api.googleads.maxInboundMessageBytes` | `GOOGLE_ADS_MAX_INBOUND_MESSAGE_BYTES` |\n\nOnce you have set the appropriate environment variables, configure your\n`GoogleAdsClient` by calling `fromEnvironment()` on the builder. \n\n GoogleAdsClient googleAdsClient = GoogleAdsClient.newBuilder()\n .fromEnvironment()\n .build();\n\nCombining configuration approaches\n----------------------------------\n\nThe `GoogleAdsClient` and its builder support combining different configuration\nstrategies. For example, you can use environment variables to configure the\ncredentials of the instance and a properties file for other attributes using\nthe following snippet. \n\n GoogleAdsClient googleAdsClient = GoogleAdsClient.newBuilder()\n .fromEnvironment()\n .fromPropertiesFile()\n .build();\n\nIn this example, the client library will use the value from the properties file\nfor any attribute that is defined both through its environment variable and an\nentry in the properties file. For the opposite behavior, simply call\n`fromPropertiesFile()` before `fromEnvironment()`.\n\nYou can make further changes at runtime using the builder's other configuration\nmethods before calling `build()`."]]
