Google Ads 管理員可以管理使用者存取 Google Ads 帳戶存取邀請。
邀請使用者
您可以在管理 Google Ads 帳戶存取權時傳送電子郵件邀請給新使用者。方法是使用 CustomerUserAccessInvitationService 的 MutateCustomerUserAccessInvitation 方法建立新的 CustomerUserAccessInvitation。您必須手動接受收到邀請的使用者接受電子郵件邀請。使用者也可利用備用電子郵件地址接受邀請。
下列程式碼片段說明如何傳送邀請：
Java
// Constructs an access invitation.
CustomerUserAccessInvitation invitation =
CustomerUserAccessInvitation.newBuilder()
.setEmailAddress(emailAddress)
.setAccessRole(accessRole)
.build();
// Constructs an operation to send the invitation.
CustomerUserAccessInvitationOperation operation =
CustomerUserAccessInvitationOperation.newBuilder().setCreate(invitation).build();
// Creates a CustomerUserAccessInvitationServiceClient.
try (CustomerUserAccessInvitationServiceClient client =
googleAdsClient.getLatestVersion().createCustomerUserAccessInvitationServiceClient()) {
// Issues the request.
MutateCustomerUserAccessInvitationResponse response =
client.mutateCustomerUserAccessInvitation(String.valueOf(customerId), operation);
// Prints some information about the result.
System.out.printf(
"Customer user access invitation was sent for customerId = "
+ "%d to email address = '%s' and access role = '%s'. The invitation resource "
+ "name is '%s'.%n",
customerId, emailAddress, accessRole, response.getResult().getResourceName());
}
C#
MutateCustomerUserAccessInvitationRequest invitationRequest =
new MutateCustomerUserAccessInvitationRequest()
{
CustomerId = customerId.ToString(),
Operation = new CustomerUserAccessInvitationOperation()
{
Create = new CustomerUserAccessInvitation()
{
EmailAddress = emailAddress,
AccessRole = accessRole
},
}
};
try
{
var response = service.MutateCustomerUserAccessInvitation(invitationRequest);
Console.WriteLine("Customer user access invitation was sent for customerId = " +
"{0} to email address = {1} and access role = {2}. The invitation resource " +
"name is {3}.", customerId, emailAddress, accessRole,
response.Result.ResourceName);
}
catch (GoogleAdsException e)
{
Console.WriteLine("Failure:");
Console.WriteLine($"Message: {e.Message}");
Console.WriteLine($"Failure: {e.Failure}");
Console.WriteLine($"Request ID: {e.RequestId}");
throw;
}
PHP
// Creates a customer user access invitation.
$customerUserAccessInvitation = new CustomerUserAccessInvitation([
'email_address' => $emailAddress,
'access_role' => AccessRole::value($accessRole)
]);
// Creates a customer user access invitation operation.
$customerUserAccessInvitationOperation = new CustomerUserAccessInvitationOperation();
$customerUserAccessInvitationOperation->setCreate($customerUserAccessInvitation);
// Issues a mutate request to send the customer user access invitation and prints its
// information.
$customerUserAccessInvitationServiceClient =
$googleAdsClient->getCustomerUserAccessInvitationServiceClient();
$response = $customerUserAccessInvitationServiceClient->mutateCustomerUserAccessInvitation(
MutateCustomerUserAccessInvitationRequest::build(
$customerId,
$customerUserAccessInvitationOperation
)
);
printf(
"Customer user access invitation with resource name '%s' was sent from customer "
. "ID %d to email address '%s' with access role '%s'.%s",
$response->getResult()->getResourceName(),
$customerId,
$emailAddress,
$accessRole,
PHP_EOL
);
Python
invitation_operation = client.get_type(
"CustomerUserAccessInvitationOperation"
)
invitation = invitation_operation.create
invitation.email_address = email_address
invitation.access_role = client.enums.AccessRoleEnum[access_role].value
response = service.mutate_customer_user_access_invitation(
customer_id=customer_id, operation=invitation_operation
)
print(
"Customer user access invitation was sent for "
f"customer ID: '{customer_id}', "
f"email address {email_address}, and "
f"access role {access_role}. The invitation resource name is: "
f"{response.result.resource_name}"
)
Ruby
operation = client.operation.create_resource.customer_user_access_invitation do |inv|
inv.email_address = email_address
inv.access_role = access_role
end
# Issues a mutate request to get the response.
response = client.service.customer_user_access_invitation.mutate_customer_user_access_invitation(
customer_id: customer_id,
operation: operation,
)
# Prints out information of the created invitation.
puts "Customer user access invitation was sent for customerId = #{customer_id} " \
"email address = '#{email_address}', " \
"access role = '#{access_role}'."
Perl
sub invite_user_with_access_role {
my ($api_client, $customer_id, $email_address, $access_role) = @_;
# Create the user access invitation.
my $user_access_invitation =
Google::Ads::GoogleAds::V16::Resources::CustomerUserAccessInvitation->new({
emailAddress => $email_address,
accessRole => $access_role
});
# Create the user access invitation operation.
my $invitation_operation =
Google::Ads::GoogleAds::V16::Services::CustomerUserAccessInvitationService::CustomerUserAccessInvitationOperation
->new({create => $user_access_invitation});
# Send the user access invitation.
my $invitation_response =
$api_client->CustomerUserAccessInvitationService()->mutate({
customerId => $customer_id,
operation => $invitation_operation
});
printf "Customer user access invitation was sent for customerId = %d " .
"to email address = '%s' and access role = '%s'. " .
"The invitation resource name is '%s'.\n",
$customer_id, $email_address, $access_role,
$invitation_response->{result}{resourceName};
return 1;
}
撤銷邀請
您可以使用 CustomerUserAccessInvitationService 的 MutateCustomerUserAccessInvitation 方法移除 CustomerUserAccessInvitation，藉此撤銷邀請。
擷取使用者邀請
如要擷取待處理使用者邀請的清單，您可以建立 Google Ads 查詢語言陳述式，查詢與客戶 ID 相關聯的所有 CustomerUserAccessInvitation 實體。以下是典型的查詢：
SELECT
customer_user_access_invitation.invitation_id,
customer_user_access_invitation.email_address,
customer_user_access_invitation.access_role,
customer_user_access_invitation.invitation_status,
customer_user_access_invitation.creation_date_time
FROM
customer_user_access_invitation
您可以新增其他篩選條件，擷取部分邀請。例如，常見的用途是擷取待處理使用者邀請的清單。實際做法為篩選 customer_user_access_invitation.invitation_status = PENDING：