Cách liên kết với tài khoản người quản lý trong Google Ads

/**
* Gửi lời mời kết nối từ tài khoản người quản lý đến tài khoản khách hàng.
*
* @param int $managerCustomerId Mã tài khoản người quản lý.
* @param int $clientCustomerId Mã tài khoản khách hàng.
* @return string Tên tài nguyên của liên kết khách hàng được tạo ra cho lời mời.
*/
private static function createInvitation(
int $managerCustomerId,
int $clientCustomerId
) {
// Tạo một đối tượng khách hàng với mã khách hàng quản lý làm login customer ID.
$googleAdsClient = self::createGoogleAdsClient($managerCustomerId);

// Tạo một liên kết khách hàng mới.
$customerClientLink = new CustomerClientLink([
‘client_customer’ => ResourceNames::forCustomer($clientCustomerId),
‘status’ => ManagerLinkStatus::PENDING // Thiết lập trạng thái lời mời là PENDING.
]);

// Tạo thao tác liên kết khách hàng.
$customerClientLinkOperation = new CustomerClientLinkOperation();
$customerClientLinkOperation->setCreate($customerClientLink);

// Gửi yêu cầu mutate để tạo liên kết khách hàng.
$customerClientLinkServiceClient = $googleAdsClient->getCustomerClientLinkServiceClient();
$response = $customerClientLinkServiceClient->mutateCustomerClientLink(
MutateCustomerClientLinkRequest::build(
$managerCustomerId,
$customerClientLinkOperation
)
);

// In kết quả và trả về tên tài nguyên của liên kết khách hàng đã tạo.
$customerClientLinkResourceName = $response->getResult()->getResourceName();
printf(
“Đã gửi lời mời từ tài khoản người quản lý %d đến tài khoản khách hàng %d với tên tài nguyên liên kết ‘%s’.%s”,
$managerCustomerId,
$clientCustomerId,
$customerClientLinkResourceName,
PHP_EOL
);

return $customerClientLinkResourceName;
}

/**
* Truy vấn tên tài nguyên liên kết quản lý của liên kết khách hàng.
*
* @param int $managerCustomerId Mã tài khoản người quản lý.
* @param int $clientCustomerId Mã tài khoản khách hàng.
* @param string $customerClientLinkResourceName Tên tài nguyên của liên kết khách hàng.
* @return string Tên tài nguyên của liên kết quản lý.
*/
private static function getManagerLinkResourceName(
int $managerCustomerId,
int $clientCustomerId,
string $customerClientLinkResourceName
) {
// Tạo một đối tượng khách hàng với mã tài khoản người quản lý làm login customer ID.
$googleAdsClient = self::createGoogleAdsClient($managerCustomerId);

// Tạo truy vấn tìm mã liên kết quản lý.
$query = “SELECT customer_client_link.manager_link_id FROM customer_client_link” .
” WHERE customer_client_link.resource_name = ‘$customerClientLinkResourceName‘”;

// Gửi yêu cầu tìm kiếm.
$googleAdsServiceClient = $googleAdsClient->getGoogleAdsServiceClient();
$response = $googleAdsServiceClient->search(
SearchGoogleAdsRequest::build($managerCustomerId, $query)
);

// Lấy mã liên kết quản lý và tên tài nguyên tương ứng.
$managerLinkId = $response->getIterator()->current()
->getCustomerClientLink()
->getManagerLinkId();
$managerLinkResourceName = ResourceNames::forCustomerManagerLink(
$clientCustomerId,
$managerCustomerId,
$managerLinkId
);

// In kết quả.
printf(
“Đã truy vấn mã liên kết quản lý của liên kết khách hàng: mã ID là %d và tên tài nguyên là ‘%s’.%s”,
$managerLinkId,
$managerLinkResourceName,
PHP_EOL
);

return $managerLinkResourceName;
}

/**
* Chấp nhận lời mời.
*
* @param int $clientCustomerId Mã tài khoản khách hàng.
* @param string $managerLinkResourceName Tên tài nguyên của liên kết quản lý cần chấp nhận.
*/
private static function acceptInvitation(
int $clientCustomerId,
string $managerLinkResourceName
) {
// Tạo một đối tượng khách hàng với mã khách hàng làm login customer ID.
$googleAdsClient = self::createGoogleAdsClient($clientCustomerId);

// Tạo liên kết người quản lý với trạng thái đã cập nhật.
$customerManagerLink = new CustomerManagerLink();
$customerManagerLink->setResourceName($managerLinkResourceName);
$customerManagerLink->setStatus(ManagerLinkStatus::ACTIVE); // Cập nhật trạng thái thành ACTIVE.

// Tạo thao tác cập nhật liên kết quản lý.
$customerManagerLinkOperation = new CustomerManagerLinkOperation();
$customerManagerLinkOperation->setUpdate($customerManagerLink);
$customerManagerLinkOperation->setUpdateMask(
FieldMasks::allSetFieldsOf($customerManagerLink)
);

// Gửi yêu cầu mutate để cập nhật liên kết quản lý.
$customerManagerLinkServiceClient =
$googleAdsClient->getCustomerManagerLinkServiceClient();
$response = $customerManagerLinkServiceClient->mutateCustomerManagerLink(
MutateCustomerManagerLinkRequest::build(
$clientCustomerId,
[$customerManagerLinkOperation]
)
);

// In kết quả sau khi chấp nhận lời mời.
printf(
“Tài khoản khách hàng %d đã chấp nhận lời mời với tên tài nguyên ‘%s’.%s”,
$clientCustomerId,
$response->getResults()[0]->getResourceName(),
PHP_EOL
);
}

response = customer_client_link_service.mutate_customer_client_link(
customer_id=manager_customer_id, operation=client_link_operation
)
resource_name = response.results[0].resource_name

print(
f’Đã gửi lời mời từ tài khoản người quản lý “{manager_customer_id}” đến ‘
f’tài khoản khách hàng “{customer_id}” với tên tài nguyên liên kết ‘
f'”{resource_name}“‘
)

# Tìm manager_link_id của liên kết vừa tạo để có thể xây dựng tên tài nguyên từ phía tài khoản khách hàng.
# Lưu ý rằng vì lọc theo resource_name, chỉ có một tài nguyên customer_client_link duy nhất sẽ được trả về.
query = f”’
SELECT
customer_client_link.manager_link_id
FROM
customer_client_link
WHERE
customer_client_link.resource_name = “{resource_name}“”’

ga_service = client.get_service(“GoogleAdsService”)

try:
response = ga_service.search(customer_id=manager_customer_id, query=query)
# Vì phương thức search trả về một iterator, chúng ta cần khởi tạo vòng lặp để lấy kết quả,
# mặc dù chúng ta biết rằng truy vấn này sẽ chỉ trả về một hàng dữ liệu duy nhất.
for row in response.result:
manager_link_id = row.customer_client_link.manager_link_id
except GoogleAdsException as ex:
handle_googleads_exception(ex)

customer_manager_link_service = client.get_service(“CustomerManagerLinkService”)
manager_link_operation = client.get_type(“CustomerManagerLinkOperation”)
manager_link = manager_link_operation.update
manager_link.resource_name = (
customer_manager_link_service.customer_manager_link_path(
customer_id,
manager_customer_id,
manager_link_id,
)
)

manager_link.status = client.enums.ManagerLinkStatusEnum.ACTIVE
client.copy_from(
manager_link_operation.update_mask,
protobuf_helpers.field_mask(None, manager_link._pb),
)

response = customer_manager_link_service.mutate_customer_manager_link(
customer_id=customer_id, operations=[manager_link_operation]
)
print(
“Tài khoản khách hàng đã chấp nhận lời mời với tên tài nguyên liên kết: “
f'”{response.results[0].resource_name}“‘
)