ব্যবহারকারীর অ্যাক্সেসের আমন্ত্রণগুলি পরিচালনা করা

একজন Google বিজ্ঞাপন প্রশাসক হিসাবে, আপনি একটি Google বিজ্ঞাপন অ্যাকাউন্টে ব্যবহারকারী অ্যাক্সেসের আমন্ত্রণগুলি পরিচালনা করতে পারেন।

ব্যবহারকারীদের আমন্ত্রণ জানান

আপনি একটি Google বিজ্ঞাপন অ্যাকাউন্টে অ্যাক্সেস পরিচালনার অংশ হিসাবে একজন নতুন ব্যবহারকারীকে একটি ইমেল আমন্ত্রণ পাঠাতে পারেন৷ CustomerUserAccessInvitationService এর MutateCustomerUserAccessInvitation পদ্ধতি ব্যবহার করে একটি নতুন CustomerUserAccessInvitation তৈরি করে এটি করা হয়। যে ব্যবহারকারী আমন্ত্রণ পেয়েছেন তাকে ইমেল আমন্ত্রণ ম্যানুয়ালি গ্রহণ করতে হবে। আমন্ত্রণটি একটি বিকল্প ইমেল ঠিকানা ব্যবহার করে ব্যবহারকারী দ্বারা গ্রহণ করা যেতে পারে। একবার আমন্ত্রণ গৃহীত হলে মুলতুবি থেকে স্থিতি পরিবর্তন হতে 24 ঘন্টা পর্যন্ত সময় লাগতে পারে।

এই কোড স্নিপেট দেখায় কিভাবে একটি আমন্ত্রণ পাঠাতে হয়:

জাভা

// 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());
}
      

সি#

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;
}
      

পিএইচপি

// 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
);
      

পাইথন

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}"
)
      

রুবি

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}'."
      

পার্ল

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::V17::Resources::CustomerUserAccessInvitation->new({
      emailAddress => $email_address,
      accessRole   => $access_role
    });

  # Create the user access invitation operation.
  my $invitation_operation =
    Google::Ads::GoogleAds::V17::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 সরিয়ে একটি আমন্ত্রণ প্রত্যাহার করতে পারেন।

ব্যবহারকারীর আমন্ত্রণগুলি পুনরুদ্ধার করুন৷

আপনি একটি গ্রাহক আইডির সাথে যুক্ত সমস্ত CustomerUserAccessInvitation সত্তাকে জিজ্ঞাসা করার জন্য Google Ads Query Language স্টেটমেন্ট তৈরি করে মুলতুবি থাকা ব্যবহারকারীর আমন্ত্রণের তালিকা পুনরুদ্ধার করতে পারেন। এখানে একটি সাধারণ প্রশ্ন আছে:

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 এর জন্য ফিল্টার করে এটি অর্জন করা যেতে পারে: