UpdateUserRoles Hizmet İşlemi - Müşteri Yönetimi

Makale
12/21/2023

Belirtilen kullanıcının rollerini Güncelleştirmeler.

Not

Yalnızca Süper Yönetici veya Standart kimlik bilgilerine sahip bir kullanıcı kullanıcı rollerini güncelleştirebilir. Standart kullanıcı Süper Yönetici rolünü ayarlayamaz veya değiştiremez. Daha fazla bilgi için bkz. Kullanıcı Rolleri teknik kılavuzu.

Hesap rolüne sahip kullanıcılar için, kullanıcının erişimi olan hesapları ekleyebilir ve silebilirsiniz. Müşteri rolüne sahip kullanıcılar için, kullanıcının erişimi olan müşterileri ekleyebilir ve silebilirsiniz. Ayrıca bir kullanıcının hesap rolüne sahip olmasından müşteri rolüne (veya tersine) geçiş yapabilirsiniz.

İstek Öğeleri

UpdateUserRolesRequest nesnesi, hizmet işlemi isteğinin gövde ve üst bilgi öğelerini tanımlar. Öğelerin İstek SOAP'sinde gösterildiği gibi aynı sırada olması gerekir.

Not

Aşağıda aksi belirtilmedikçe, tüm istek öğeleri gereklidir.

İstek Gövdesi Öğeleri

Öğe	Açıklama	Veri Türü
Customerıd	Kullanıcının ait olduğu müşterinin tanımlayıcısı.	Uzun
DeleteAccountIds	Kullanıcının yönetebileceği hesaplar listesinden kaldırılacak hesapların tanımlayıcı dizisi. Kullanım için aşağıdaki Açıklamalar bölümüne bakın.	uzun dizi
DeleteCustomerIds	Kullanıcıların yönetebileceği müşteri listesinden kaldırılacak bir dizi tanımlayıcı. Kullanım için aşağıdaki Açıklamalar bölümüne bakın.	uzun dizi
DeleteRoleId	Ayarlanırsa DeleteAccountIds veya DeleteCustomerIds öğesinde belirtilen değerlerin uygulandığı rolün tanımlayıcısı. Olası değerler şunlardır: 16 - Kullanıcı Reklamveren Kampanya Yöneticisi rolüne sahiptir. 33 - Kullanıcı Toplayıcı rolüne sahiptir. 41 - Kullanıcı Süper Yönetici rolüne sahiptir. 100 - Kullanıcı Görüntüleyici rolüne sahiptir. 203 - Kullanıcı Standart Kullanıcı rolüne sahiptir. Daha fazla bilgi için bkz. Kullanıcı Rolleri teknik kılavuzu. Önemli: Yukarıdaki listede olası dönüş değerleri örnekleri verilmiştir. Diğer değerler döndürülebilir. Kullanım dışı veya iç roller yanıta dahil edilebilir.	Int
NewAccountIds	Kullanıcının kısıtlanması için hesapların tanımlayıcı dizisi. Kullanıcı yalnızca bu hesapları yönetebilir. Kullanıcı şu anda bir hesap kümesiyle sınırlıysa, bu öğeyi kullanıcının da yönetmesini istediğiniz yeni hesaplar olarak ayarlayın. Örneğin, kullanıcı şu anda 123 ve 456 hesaplarını yönetiyorsa ve kullanıcının 789 hesabını da yönetmesini istiyorsanız, bu öğeyi 789 olarak ayarlayın. Kullanım için aşağıdaki Açıklamalar bölümüne bakın.	uzun dizi
NewCustomerIds	Kullanıcının kısıtlanması için müşterilerin tanımlayıcı dizisi. Kullanıcı yalnızca bu müşterileri yönetebilir. Kullanım için aşağıdaki Açıklamalar bölümüne bakın.	uzun dizi
NewRoleId	NewAccountIds veya NewCustomerIds öğesinde belirtilen değerlerin uygulandığı rolün tanımlayıcısı (ayarlanırsa). Olası değerler şunlardır: 16 - Kullanıcı Reklamveren Kampanya Yöneticisi rolüne sahiptir. 33 - Kullanıcı Toplayıcı rolüne sahiptir. 41 - Kullanıcı Süper Yönetici rolüne sahiptir. 100 - Kullanıcı Görüntüleyici rolüne sahiptir. 203 - Kullanıcı Standart Kullanıcı rolüne sahiptir. Daha fazla bilgi için bkz. Kullanıcı Rolleri teknik kılavuzu. Önemli: Yukarıdaki listede olası dönüş değerleri örnekleri verilmiştir. Diğer değerler döndürülebilir. Kullanım dışı veya iç roller yanıta dahil edilebilir.	Int
Userıd	Rolünü güncelleştirmek istediğiniz kullanıcının tanımlayıcısı.	Uzun

İstek Üst Bilgisi Öğeleri

Öğe	Açıklama	Veri Türü
AuthenticationToken	Microsoft Advertising hesaplarına izinleri olan bir kullanıcının kimlik bilgilerini temsil eden OAuth erişim belirteci. Daha fazla bilgi için bkz. OAuth ile kimlik doğrulaması.	Dize
DeveloperToken	Bing Ads API'sine erişmek için kullanılan geliştirici belirteci. Daha fazla bilgi için bkz . Geliştirici Belirteci Alma.	Dize
Password	Bu öğe iç kullanım için ayrılmıştır ve API'nin gelecekteki bir sürümünden kaldırılacaktır. Kullanıcı kimlik bilgilerini ayarlamak için AuthenticationToken öğesini kullanmanız gerekir.	Dize
Username	Bu öğe iç kullanım için ayrılmıştır ve API'nin gelecekteki bir sürümünden kaldırılacaktır. Kullanıcı kimlik bilgilerini ayarlamak için AuthenticationToken öğesini kullanmanız gerekir.	Dize

Yanıt Öğeleri

UpdateUserRolesResponse nesnesi, hizmet işlemi yanıtının gövde ve üst bilgi öğelerini tanımlar. Öğeler , Yanıt SOAP'sinde gösterildiği gibi aynı sırada döndürülür.

Yanıt Gövdesi Öğeleri

Öğe	Açıklama	Veri Türü
LastModifiedTime	Kullanıcı rollerinin son güncelleştirildiği tarih ve saat. Değer Eşgüdümlü Evrensel Saat (UTC) içindedir. Tarih ve saat değeri, istemcide değil sunucudaki tarih ve saati yansıtır. Tarih ve saatin biçimi hakkında bilgi için temel XML Veri Türleri'ndeki dateTime girdisine bakın.	Datetime

Yanıt Üst Bilgisi Öğeleri

Öğe	Açıklama	Veri Türü
TrackingId	API çağrısının ayrıntılarını içeren günlük girdisinin tanımlayıcısı.	Dize

SOAP isteme

Bu şablon, SOAP isteği için gövde ve üst bilgi öğelerinin sırasını gösteren bir araç tarafından oluşturulmuştur. Bu hizmet işlemiyle kullanabileceğiniz desteklenen türler için yukarıdaki İstek Gövdesi Öğeleri başvurusuna bakın.

<s:Envelope xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header xmlns="https://bingads.microsoft.com/Customer/v13">
    <Action mustUnderstand="1">UpdateUserRoles</Action>
    <AuthenticationToken i:nil="false">ValueHere</AuthenticationToken>
    <DeveloperToken i:nil="false">ValueHere</DeveloperToken>
  </s:Header>
  <s:Body>
    <UpdateUserRolesRequest xmlns="https://bingads.microsoft.com/Customer/v13">
      <CustomerId>ValueHere</CustomerId>
      <UserId>ValueHere</UserId>
      <NewRoleId i:nil="false">ValueHere</NewRoleId>
      <NewAccountIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <a1:long>ValueHere</a1:long>
      </NewAccountIds>
      <NewCustomerIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <a1:long>ValueHere</a1:long>
      </NewCustomerIds>
      <DeleteRoleId i:nil="false">ValueHere</DeleteRoleId>
      <DeleteAccountIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <a1:long>ValueHere</a1:long>
      </DeleteAccountIds>
      <DeleteCustomerIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <a1:long>ValueHere</a1:long>
      </DeleteCustomerIds>
    </UpdateUserRolesRequest>
  </s:Body>
</s:Envelope>

Yanıt SOAP

Bu şablon, SOAP yanıtı için gövde ve üst bilgi öğelerinin sırasını gösteren bir araç tarafından oluşturulmuştur.

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header xmlns="https://bingads.microsoft.com/Customer/v13">
    <TrackingId d3p1:nil="false" xmlns:d3p1="http://www.w3.org/2001/XMLSchema-instance">ValueHere</TrackingId>
  </s:Header>
  <s:Body>
    <UpdateUserRolesResponse xmlns="https://bingads.microsoft.com/Customer/v13">
      <LastModifiedTime>ValueHere</LastModifiedTime>
    </UpdateUserRolesResponse>
  </s:Body>
</s:Envelope>

Kod Söz Dizimi

Örnek söz dizimi Bing Reklam SDK'ları ile kullanılabilir. Daha fazla örnek için bkz . Bing Ads API Kod Örnekleri .

public async Task<UpdateUserRolesResponse> UpdateUserRolesAsync(
	long customerId,
	long userId,
	int? newRoleId,
	IList<long> newAccountIds,
	IList<long> newCustomerIds,
	int? deleteRoleId,
	IList<long> deleteAccountIds,
	IList<long> deleteCustomerIds)
{
	var request = new UpdateUserRolesRequest
	{
		CustomerId = customerId,
		UserId = userId,
		NewRoleId = newRoleId,
		NewAccountIds = newAccountIds,
		NewCustomerIds = newCustomerIds,
		DeleteRoleId = deleteRoleId,
		DeleteAccountIds = deleteAccountIds,
		DeleteCustomerIds = deleteCustomerIds
	};

	return (await CustomerManagementService.CallAsync((s, r) => s.UpdateUserRolesAsync(r), request));
}

static UpdateUserRolesResponse updateUserRoles(
	java.lang.Long customerId,
	java.lang.Long userId,
	int newRoleId,
	ArrayOflong newAccountIds,
	ArrayOflong newCustomerIds,
	int deleteRoleId,
	ArrayOflong deleteAccountIds,
	ArrayOflong deleteCustomerIds) throws RemoteException, Exception
{
	UpdateUserRolesRequest request = new UpdateUserRolesRequest();

	request.setCustomerId(customerId);
	request.setUserId(userId);
	request.setNewRoleId(newRoleId);
	request.setNewAccountIds(newAccountIds);
	request.setNewCustomerIds(newCustomerIds);
	request.setDeleteRoleId(deleteRoleId);
	request.setDeleteAccountIds(deleteAccountIds);
	request.setDeleteCustomerIds(deleteCustomerIds);

	return CustomerManagementService.getService().updateUserRoles(request);
}

static function UpdateUserRoles(
	$customerId,
	$userId,
	$newRoleId,
	$newAccountIds,
	$newCustomerIds,
	$deleteRoleId,
	$deleteAccountIds,
	$deleteCustomerIds)
{

	$GLOBALS['Proxy'] = $GLOBALS['CustomerManagementProxy'];

	$request = new UpdateUserRolesRequest();

	$request->CustomerId = $customerId;
	$request->UserId = $userId;
	$request->NewRoleId = $newRoleId;
	$request->NewAccountIds = $newAccountIds;
	$request->NewCustomerIds = $newCustomerIds;
	$request->DeleteRoleId = $deleteRoleId;
	$request->DeleteAccountIds = $deleteAccountIds;
	$request->DeleteCustomerIds = $deleteCustomerIds;

	return $GLOBALS['CustomerManagementProxy']->GetService()->UpdateUserRoles($request);
}

response=customermanagement_service.UpdateUserRoles(
	CustomerId=CustomerId,
	UserId=UserId,
	NewRoleId=NewRoleId,
	NewAccountIds=NewAccountIds,
	NewCustomerIds=NewCustomerIds,
	DeleteRoleId=DeleteRoleId,
	DeleteAccountIds=DeleteAccountIds,
	DeleteCustomerIds=DeleteCustomerIds)

Açıklamalar

Örneğin, bir reklamveren kampanya yöneticisi 123, 456 ve 789 hesaplarını yönetmekle sınırlıysa ve kullanıcının 456'yı yönetmesini istemiyorsanız aşağıdaki öğeleri uygun şekilde ayarlayın:

NewRoleId öğesini 16 (reklamveren kampanya yöneticisi rolü) olarak ayarlayın.
NewAccountIds öğesini 123 ve 789 içeren bir dizi olarak ayarlayın.
DeleteRoleId öğesini 16 (reklamveren kampanya yöneticisi rolü) olarak ayarlayın.
DeleteAccountIds öğesini 456 içeren bir dizi olarak ayarlayın.

Bir reklamveren kampanya yöneticisi 123 ve 789 hesaplarını yönetmekle sınırlıysa ve artık kullanıcının tüm hesapları yönetmesini istiyorsanız aşağıdaki öğeleri uygun şekilde ayarlayın:

NewRoleId öğesini 16 (reklamveren kampanya yöneticisi rolü) olarak ayarlayın.
NewAccountIds öğesini NULL olarak ayarlayın.
DeleteRoleId öğesini 16 (reklamveren kampanya yöneticisi rolü) olarak ayarlayın.
DeleteAccountIds öğesini 123, 456 ve 789 içeren bir dizi olarak ayarlayın.

Hesap düzeyinde rolleri olan kullanıcılar belirli hesaplarla sınırlandırılabilir. Müşteri düzeyinde rolleri olan kullanıcılar kullanıcının müşterisi içindeki tüm hesaplara erişebilir ve erişimleri belirli hesaplarla kısıtlanamaz.

Not

Müşteri düzeyindeki kullanıcı rollerini belirli hesaplara kısıtlamaya çalışırken UpdateUserRoles işlemi başarısız olmaz ve kullanıcı, kullanıcının müşterisi içindeki tüm hesaplar için erişimi korur.

Gereksinimler

Hizmet: CustomerManagementService.svc v13
Ad alanı: https://bingads.microsoft.com/Customer/v13

Aracılığıyla paylaş