如果您的项目还没有任何服务账号,系统会提示您创建一个。在服务账号名称框中输入所选名称。您输入的内容会自动填充到服务账号 ID 框中。服务账号说明框是可选的,但如果您计划将多个服务账号关联到您的项目,则建议这样做。在此框中输入服务账号的简要说明,然后点击创建。
在下一页面上,您将可以为新服务账号分配角色。如需详细了解可用角色和每个角色可以拥有的权限,请参阅 CTS IAM 权限页面。点击选择角色下拉列表,然后向下滚动至 Cloud Talent Solution。您可以从右侧列的选项中为此服务账号选择角色:
下一页提供了完成多个任务的选项。这些并非必需,但强烈建议使用。通过输入用户的电子邮件地址,您可以向各个用户授予对刚创建的服务账号的访问权限。
您还可以为服务账号创建私钥。使用 API 时,您必须在身份验证过程中使用私钥。如果您现在不执行这些操作,您可以通过主导航菜单中的 IAM 选项访问服务账户,随时生成密钥并添加/更改个人用户信息。
Provide authentication credentials to your application code by setting the
environment variable GOOGLE_APPLICATION_CREDENTIALS. This
variable applies only to your current shell session. If you want the variable
to apply to future shell sessions, set the variable in your shell startup file,
for example in the ~/.bashrc or ~/.profile file.
Linux 或 macOS
exportGOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"
Replace KEY_PATH with the path of the JSON file that contains your credentials.
[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["很难理解","hardToUnderstand","thumb-down"],["信息或示例代码不正确","incorrectInformationOrSampleCode","thumb-down"],["没有我需要的信息/示例","missingTheInformationSamplesINeed","thumb-down"],["翻译问题","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2025-08-18。"],[],[],null,["# Before You Begin\n\nOverview\n--------\n\nBefore you can begin using Cloud Talent Solution (CTS), you must\nenable the API in the Google Cloud Platform (GCP) Console. The steps below walk\nyou through the following actions:\n\n- Enable CTS on a GCP project.\n 1. Make sure billing is enabled for CTS.\n 2. Accept the Data Logging Terms \\& Conditions.\n 3. Create and/or assign one or more service accounts to Cloud Talent Solution.\n 4. Download a service account credential key.\n- Set your authentication environment variable.\n\nGCP Console set-up\n------------------\n\n1. Go to the [GCP Console](http://console.cloud.google.com).\n Navigate to the drop-down menu at the top of the page and choose the GCP\n project that you'd like to associate with Cloud Talent Solution. If you\n have previously created one or more projects, they will appear in a list\n in the pop-up menu. You can either choose a pre-existing project (a check\n mark will appear next to the project you select) or create\n a new project by clicking **NEW PROJECT** . For more details on creating a\n GCP project, please see the [documentation](/resource-manager/docs/creating-managing-projects).\n\n2. If you create a new project, you will be prompted to link a billing account\n to this project. If you are using a pre-existing project, make sure that you\n have billing enabled. You can access the project's billing information at\n any time by going to the main navigation menu (the hamburger icon in the\n upper left corner) and clicking the **Billing** option:\n\n | **Note:** You must enable billing to use Cloud Talent Solution, however you will not be charged unless you exceed the free quota of 1-10,000 API calls per month. See the [pricing](/talent-solution/pricing) page for more details.\n3. Once you have selected a GCP project and linked it to a billing account, you\n can enable the Cloud Talent Solution API. Go to the main navigation menu and\n scroll down to the **Artificial Intelligence** section. Click on\n **Talent Solution** and choose **Overview** from the menu that pops up:\n\n4. If you would first like to try the API without linking it to your project,\n you can choose the **TRY THIS API** option. See the\n [Job Search API Explorer](/talent-solution/job-search/docs/quickstart-api-explorer)\n documentation for more information on using this feature.\n To enable the Cloud Talent Solution API for use with your GCP project, click\n **ENABLE**:\n\n5. The data logging page appears. You must accept the terms \\& conditions\n to have full access to CTS features. If you choose not to accept these\n terms, you'll only be able to use deletion API requests. Click **ENABLE**:\n\n6. You are now prompted to link one or more service accounts to the CTS API.\n If you are using a project that already has service accounts associated with\n it, they will appear in a list on this page. Click **CONNECT** next to the\n account(s) that you want to link to the CTS API. Once you have done this,\n you can skip ahead to step 8 to make sure that you've downloaded a JSON or\n P12 credential for that account.\n\n If your project does not yet have any service accounts, you are prompted to\n create one. Type a name of your choosing into the **Service account name**\n box. Your input is automatically populated in the **Service account ID**\n box. The **Service account description** box is optional but recommended if\n you plan on associating multiple service accounts with your project. Enter\n a brief description of the service account into this box, then click\n **CREATE**.\n\n7. The next page allows you to assign a role to your new service account. See\n the CTS [IAM permissions](/talent-solution/docs/iam) page for full details\n on the available roles and the permissions allowed to each. Click on the\n drop-down **Select a role** menu and scroll down to\n **Cloud Talent Solution**. You can choose a role for this service account\n from the options in the right-hand column:\n\n8. The next page gives you the option to complete several tasks. These are\n not required but highly recommended. You can grant individual users access\n to the service account you just created by entering their email addresses.\n You can also create a private key for the service account. You must use a\n private key during the [authentication process](/talent-solution/job-search/docs/before-you-begin#set_up_your_environment_variables)\n when you use the API. If you choose not take these actions now, you can\n generate a key and add/change individual user information at any time by\n accessing the service account through the **IAM** option in the main\n navigation menu.\n\n Click **CREATE KEY**:\n\n Choose your preferred format from the pop-up menu and click **CREATE**:\n\n A new JSON or P12 credential file is automatically downloaded.\n Store this file in a specific location and make a note of the file path.\n You will need to point the \u003cvar translate=\"no\"\u003eGOOGLE_APPLICATION_CREDENTIALS\u003c/var\u003e\n environment variable to this file when you go through the\n [authentication process](/talent-solution/job-search/docs/before-you-begin#set_up_your_environment_variables).\n This is an essential step for authenticating requests to Cloud Talent Solution.\n\n Once your credential file has downloaded, click **DONE**:\n\n9. Your service account now appears on the **Connect service accounts** page.\n Click **CONNECT** to link it to the CTS API:\n\n10. The account is now connected, and you're now ready to begin integrating Cloud\n Talent Solution into your system:\n\nSet your authentication environment variable\n--------------------------------------------\n\n\nProvide authentication credentials to your application code by setting the\nenvironment variable `GOOGLE_APPLICATION_CREDENTIALS`. This\nvariable applies only to your current shell session. If you want the variable\nto apply to future shell sessions, set the variable in your shell startup file,\nfor example in the `~/.bashrc` or `~/.profile` file. \n\n### Linux or macOS\n\n```bash\nexport GOOGLE_APPLICATION_CREDENTIALS=\"\u003cvar translate=\"no\"\u003eKEY_PATH\u003c/var\u003e\"\n```\n\nReplace \u003cvar translate=\"no\"\u003eKEY_PATH\u003c/var\u003e with the path of the JSON file that contains your credentials.\n\nFor example: \n\n```bash\nexport GOOGLE_APPLICATION_CREDENTIALS=\"/home/user/Downloads/service-account-file.json\"\n```\n\n### Windows\n\nFor PowerShell: \n\n```bash\n$env:GOOGLE_APPLICATION_CREDENTIALS=\"\u003cvar translate=\"no\"\u003eKEY_PATH\u003c/var\u003e\"\n```\n\nReplace \u003cvar translate=\"no\"\u003eKEY_PATH\u003c/var\u003e with the path of the JSON file that contains your credentials.\n\nFor example: \n\n```bash\n$env:GOOGLE_APPLICATION_CREDENTIALS=\"C:\\Users\\username\\Downloads\\service-account-file.json\"\n```\n\nFor command prompt: \n\n set GOOGLE_APPLICATION_CREDENTIALS=\u003cvar translate=\"no\"\u003eKEY_PATH\u003c/var\u003e\n\nReplace \u003cvar translate=\"no\"\u003eKEY_PATH\u003c/var\u003e with the path of the JSON file that contains your credentials.\n\nFor more information, see\nthe [GCP authentication documentation](/docs/authentication/production).\n\nWhat's next\n-----------\n\nInstall a [client library](/talent-solution/job-search/docs/libraries) or see\nthe [create jobs and companies quickstart](/talent-solution/job-search/docs/quickstart-jobs-and-companies)\nto begin making API calls."]]