SendUserInvitation Hizmeti İşlemi - Müşteri Yönetimi

Makale
12/21/2023

Kullanıcının Microsoft Advertising'e kaydolması için bir e-posta daveti gönderir. Davet, hesap erişimini ve izinleri sınırlar.

Not

Yalnızca Süper Yönetici veya Standart kimlik bilgilerine sahip bir kullanıcı kullanıcı davetleri gönderebilir. Standart kullanıcı Bir Süper Yönetici davet edemez. Daha fazla bilgi için bkz. Kullanıcı Rolleri teknik kılavuzu.

Önemli

Davet gönderildiğinde, kullanıcı erişimini doğrudan müşterinizin altındaki reklamveren hesaplarının bir alt kümesiyle sınırlamayı tercih edebilirsiniz. Bir ajans hiyerarşisi kullanıcının davet edildiği müşterinin altında ayarlanırsa (şimdi veya gelecekte) ve erişimi belirli hesaplara sınırlamazsanız, kullanıcının hiyerarşideki tüm hesaplara erişimi olur.

Süresi henüz dolmamış olan aynı e-posta adresine birden fazla bekleyen davet gönderilmesi mümkündür. Bu davetlerin farklı kullanıcı rolleri belirtmesi de mümkündür. Örneğin, yanlış kullanıcı rolüne sahip bir davet gönderdiyseniz ve ardından doğru kullanıcı rolüne sahip ikinci bir davet gönderdiyseniz. Alıcı davetlerden herhangi birini kabul edebilir ve davet e-posta adresinden farklı kimlik bilgileriyle kaydolabilir. Microsoft Advertising kullanıcıları, aynı kimlik bilgilerine sahip birden çok müşteriye davet kabul edebilir. Daha fazla bilgi için Çok Kullanıcılı Kimlik Bilgileri teknik kılavuzuna bakın.

Bekleyen davetleri davet kimliğine göre arayabilir ve davetin kabul edilip edilmediğini veya süresinin dolduğunu öğrenebilirsiniz. SearchUserInvitations işlemi, süresi dolmuş olsun veya olmasın tüm bekleyen davetleri döndürür. Kabul edilen davetler SearchUserInvitations yanıtına dahil değildir.

Davet kabul edildikten sonra, Microsoft Advertising kullanıcı ayrıntılarına erişmek için GetUsersInfo ve GetUser'ı çağırabilirsiniz. Ancak, bir alıcı daveti kabul edip davet e-posta adresinden farklı kimlik bilgileriyle kaydolabildiğinden, UserInvitation'dan User veya UserInfo nesnesine eşlemeyi kesin olarak belirleyemezsiniz. GetUsersInfo veya GetUser tarafından döndürülen kullanıcı kimliğiyle, kullanıcıyı gerektiği gibi kaldırmak için DeleteUser'ı çağırabilirsiniz. Bing Ads API'sinde bekleyen kullanıcı davetlerini silme işlemi desteklenmez. Bir kullanıcıyı davet ettikten sonra daveti iptal etmenin tek yolu Microsoft Advertising web uygulamasıdır. Hem bekleyen hem de kabul edilen davetleri Hesaplar & Faturalama'nınKullanıcılar bölümünde bulabilirsiniz.

İstek Öğeleri

SendUserInvitationRequest 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ü
UserInvitation	Gönderilecek kullanıcı daveti.	UserInvitation

İ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

SendUserInvitationResponse 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ü
UserInvitationId	Gönderilen kullanıcı daveti için sistem tarafından oluşturulan tanımlayıcı.	Uzun

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">SendUserInvitation</Action>
    <AuthenticationToken i:nil="false">ValueHere</AuthenticationToken>
    <DeveloperToken i:nil="false">ValueHere</DeveloperToken>
  </s:Header>
  <s:Body>
    <SendUserInvitationRequest xmlns="https://bingads.microsoft.com/Customer/v13">
      <UserInvitation xmlns:e263="https://bingads.microsoft.com/Customer/v13/Entities" i:nil="false">
        <e263:Id>ValueHere</e263:Id>
        <e263:FirstName i:nil="false">ValueHere</e263:FirstName>
        <e263:LastName i:nil="false">ValueHere</e263:LastName>
        <e263:Email i:nil="false">ValueHere</e263:Email>
        <e263:CustomerId>ValueHere</e263:CustomerId>
        <e263:RoleId>ValueHere</e263:RoleId>
        <e263:AccountIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
          <a1:long>ValueHere</a1:long>
        </e263:AccountIds>
        <e263:ExpirationDate>ValueHere</e263:ExpirationDate>
        <e263:Lcid>ValueHere</e263:Lcid>
      </UserInvitation>
    </SendUserInvitationRequest>
  </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>
    <SendUserInvitationResponse xmlns="https://bingads.microsoft.com/Customer/v13">
      <UserInvitationId>ValueHere</UserInvitationId>
    </SendUserInvitationResponse>
  </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<SendUserInvitationResponse> SendUserInvitationAsync(
	UserInvitation userInvitation)
{
	var request = new SendUserInvitationRequest
	{
		UserInvitation = userInvitation
	};

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

static SendUserInvitationResponse sendUserInvitation(
	UserInvitation userInvitation) throws RemoteException, Exception
{
	SendUserInvitationRequest request = new SendUserInvitationRequest();

	request.setUserInvitation(userInvitation);

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

static function SendUserInvitation(
	$userInvitation)
{

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

	$request = new SendUserInvitationRequest();

	$request->UserInvitation = $userInvitation;

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

response=customermanagement_service.SendUserInvitation(
	UserInvitation=UserInvitation)

Gereksinimler

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

Aracılığıyla paylaş