Operación del servicio CreateResponsiveAdRecommendation: Administración de campañas

Artículo
02/20/2025

Cree una recomendación de anuncio con capacidad de respuesta.

Elementos Request

El objeto CreateResponsiveAdRecommendationRequest define los elementos body y header de la solicitud de operación de servicio. Los elementos deben estar en el mismo orden que se muestra en la solicitud SOAP.

Nota:

A menos que se indique lo contrario a continuación, se requieren todos los elementos de solicitud.

Elementos del cuerpo de la solicitud

Elemento	Descripción	Tipo de datos
AdSubType	Subtipo de anuncio opcional para el que crear una recomendación.	AdSubType
FinalUrls	Matriz de direcciones URL de las páginas web usadas para crear recursos de anuncios recomendados.	matriz de cadenas
Prompt	Descripción opcional del producto o servicio al que desea dirigirse con la campaña específica.	string
TextTone	Tono opcional para los recursos de texto recomendados	AdRecommendationTextTone

Elementos de encabezado de solicitud

Elemento	Descripción	Tipo de datos
AuthenticationToken	Token de acceso de OAuth que representa las credenciales de un usuario que tiene permisos para cuentas de Microsoft Advertising. Para obtener más información, consulte Autenticación con OAuth.	string
CustomerAccountId	Identificador de la cuenta de anuncio que posee o está asociada a las entidades de la solicitud. Este elemento de encabezado debe tener el mismo valor que el elemento de cuerpo AccountId cuando ambos son necesarios. Este elemento es necesario para la mayoría de las operaciones de servicio y, como procedimiento recomendado, siempre debe establecerlo. Para obtener más información, consulte Obtención de su cuenta e identificadores de cliente.	string
CustomerId	Identificador de la cuenta de administrador (cliente) desde la que el usuario accede o funciona. Un usuario puede tener acceso a varias cuentas de administrador. Este elemento es necesario para la mayoría de las operaciones de servicio y, como procedimiento recomendado, siempre debe establecerlo. Para obtener más información, consulte Obtención de su cuenta e identificadores de cliente.	string
DeveloperToken	Token de desarrollador que se usa para acceder a Bing Ads API. Para obtener más información, consulte Obtención de un token de desarrollador.	string
Password	Este elemento está reservado para uso interno y se quitará de una versión futura de la API. Debe usar el elemento AuthenticationToken para establecer las credenciales de usuario.	string
UserName	Este elemento está reservado para uso interno y se quitará de una versión futura de la API. Debe usar el elemento AuthenticationToken para establecer las credenciales de usuario.	string

Elementos de respuesta

El objeto CreateResponsiveAdRecommendationResponse define los elementos body y header de la respuesta de la operación de servicio. Los elementos se devuelven en el mismo orden que se muestra en soap de respuesta.

Elementos del cuerpo de la respuesta

Elemento	Descripción	Tipo de datos
ImageSuggestions	Una matriz de imágenes recomendadas para incluirse en el anuncio con capacidad de respuesta.	Matriz AdRecommendationImageSuggestion
ResponsiveAd	Objeto de anuncio con capacidad de respuesta que contiene los recursos de texto recomendados.	ResponsiveAd
VideoSuggestions	Una matriz de vídeos recomendados para incluirse en el anuncio con capacidad de respuesta.	Matriz AdRecommendationVideoSuggestion

Elementos de encabezado de respuesta

Elemento	Descripción	Tipo de datos
Seguimiento del Id.	Identificador de la entrada de registro que contiene los detalles de la llamada API.	string

Solicitud de SOAP

Esta plantilla se generó mediante una herramienta para mostrar el orden del cuerpo y los elementos de encabezado de la solicitud SOAP. Para ver los tipos admitidos que puede usar con esta operación de servicio, consulte la referencia de elementos de cuerpo de solicitud anterior.

<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/CampaignManagement/v13">
    <Action mustUnderstand="1">CreateResponsiveAdRecommendation</Action>
    <AuthenticationToken i:nil="false">ValueHere</AuthenticationToken>
    <CustomerAccountId i:nil="false">ValueHere</CustomerAccountId>
    <CustomerId i:nil="false">ValueHere</CustomerId>
    <DeveloperToken i:nil="false">ValueHere</DeveloperToken>
  </s:Header>
  <s:Body>
    <CreateResponsiveAdRecommendationRequest xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
      <AdSubType i:nil="false">ValueHere</AdSubType>
      <FinalUrls i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <a1:string>ValueHere</a1:string>
      </FinalUrls>
      <Prompt i:nil="false">ValueHere</Prompt>
      <TextTone i:nil="false">ValueHere</TextTone>
    </CreateResponsiveAdRecommendationRequest>
  </s:Body>
</s:Envelope>

SOAP de respuesta

Esta plantilla se generó mediante una herramienta para mostrar el orden de los elementos body y header para la respuesta SOAP.

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
    <TrackingId d3p1:nil="false" xmlns:d3p1="http://www.w3.org/2001/XMLSchema-instance">ValueHere</TrackingId>
  </s:Header>
  <s:Body>
    <CreateResponsiveAdRecommendationResponse xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
      <ResponsiveAd d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <AdSubType d4p1:nil="false">ValueHere</AdSubType>
        <BusinessName d4p1:nil="false">ValueHere</BusinessName>
        <CallToAction d4p1:nil="false">ValueHere</CallToAction>
        <CallToActionLanguage d4p1:nil="false">ValueHere</CallToActionLanguage>
        <Descriptions d4p1:nil="false">
          <AssetLink>
            <Asset d4p1:nil="false" d4p1:type="-- derived type specified here with the appropriate prefix --">
              <Id d4p1:nil="false">ValueHere</Id>
              <Name d4p1:nil="false">ValueHere</Name>
              <Type d4p1:nil="false">ValueHere</Type>
              <!--This field is applicable if the derived type attribute is set to TextAsset-->
              <Text d4p1:nil="false">ValueHere</Text>
              <!--These fields are applicable if the derived type attribute is set to ImageAsset-->
              <CropHeight d4p1:nil="false">ValueHere</CropHeight>
              <CropWidth d4p1:nil="false">ValueHere</CropWidth>
              <CropX d4p1:nil="false">ValueHere</CropX>
              <CropY d4p1:nil="false">ValueHere</CropY>
              <SubType d4p1:nil="false">ValueHere</SubType>
              <TargetHeight d4p1:nil="false">ValueHere</TargetHeight>
              <TargetWidth d4p1:nil="false">ValueHere</TargetWidth>
              <!--These fields are applicable if the derived type attribute is set to VideoAsset-->
              <SubType d4p1:nil="false">ValueHere</SubType>
              <ThumbnailImage d4p1:nil="false">
                <CropHeight d4p1:nil="false">ValueHere</CropHeight>
                <CropWidth d4p1:nil="false">ValueHere</CropWidth>
                <CropX d4p1:nil="false">ValueHere</CropX>
                <CropY d4p1:nil="false">ValueHere</CropY>
                <SubType d4p1:nil="false">ValueHere</SubType>
                <TargetHeight d4p1:nil="false">ValueHere</TargetHeight>
                <TargetWidth d4p1:nil="false">ValueHere</TargetWidth>
              </ThumbnailImage>
            </Asset>
            <AssetPerformanceLabel d4p1:nil="false">ValueHere</AssetPerformanceLabel>
            <EditorialStatus d4p1:nil="false">ValueHere</EditorialStatus>
            <PinnedField d4p1:nil="false">ValueHere</PinnedField>
          </AssetLink>
        </Descriptions>
        <Headline d4p1:nil="false">ValueHere</Headline>
        <Headlines d4p1:nil="false">
          <AssetLink>
            <Asset d4p1:nil="false" d4p1:type="-- derived type specified here with the appropriate prefix --">
              <Id d4p1:nil="false">ValueHere</Id>
              <Name d4p1:nil="false">ValueHere</Name>
              <Type d4p1:nil="false">ValueHere</Type>
              <!--This field is applicable if the derived type attribute is set to TextAsset-->
              <Text d4p1:nil="false">ValueHere</Text>
              <!--These fields are applicable if the derived type attribute is set to ImageAsset-->
              <CropHeight d4p1:nil="false">ValueHere</CropHeight>
              <CropWidth d4p1:nil="false">ValueHere</CropWidth>
              <CropX d4p1:nil="false">ValueHere</CropX>
              <CropY d4p1:nil="false">ValueHere</CropY>
              <SubType d4p1:nil="false">ValueHere</SubType>
              <TargetHeight d4p1:nil="false">ValueHere</TargetHeight>
              <TargetWidth d4p1:nil="false">ValueHere</TargetWidth>
              <!--These fields are applicable if the derived type attribute is set to VideoAsset-->
              <SubType d4p1:nil="false">ValueHere</SubType>
              <ThumbnailImage d4p1:nil="false">
                <CropHeight d4p1:nil="false">ValueHere</CropHeight>
                <CropWidth d4p1:nil="false">ValueHere</CropWidth>
                <CropX d4p1:nil="false">ValueHere</CropX>
                <CropY d4p1:nil="false">ValueHere</CropY>
                <SubType d4p1:nil="false">ValueHere</SubType>
                <TargetHeight d4p1:nil="false">ValueHere</TargetHeight>
                <TargetWidth d4p1:nil="false">ValueHere</TargetWidth>
              </ThumbnailImage>
            </Asset>
            <AssetPerformanceLabel d4p1:nil="false">ValueHere</AssetPerformanceLabel>
            <EditorialStatus d4p1:nil="false">ValueHere</EditorialStatus>
            <PinnedField d4p1:nil="false">ValueHere</PinnedField>
          </AssetLink>
        </Headlines>
        <Images d4p1:nil="false">
          <AssetLink>
            <Asset d4p1:nil="false" d4p1:type="-- derived type specified here with the appropriate prefix --">
              <Id d4p1:nil="false">ValueHere</Id>
              <Name d4p1:nil="false">ValueHere</Name>
              <Type d4p1:nil="false">ValueHere</Type>
              <!--This field is applicable if the derived type attribute is set to TextAsset-->
              <Text d4p1:nil="false">ValueHere</Text>
              <!--These fields are applicable if the derived type attribute is set to ImageAsset-->
              <CropHeight d4p1:nil="false">ValueHere</CropHeight>
              <CropWidth d4p1:nil="false">ValueHere</CropWidth>
              <CropX d4p1:nil="false">ValueHere</CropX>
              <CropY d4p1:nil="false">ValueHere</CropY>
              <SubType d4p1:nil="false">ValueHere</SubType>
              <TargetHeight d4p1:nil="false">ValueHere</TargetHeight>
              <TargetWidth d4p1:nil="false">ValueHere</TargetWidth>
              <!--These fields are applicable if the derived type attribute is set to VideoAsset-->
              <SubType d4p1:nil="false">ValueHere</SubType>
              <ThumbnailImage d4p1:nil="false">
                <CropHeight d4p1:nil="false">ValueHere</CropHeight>
                <CropWidth d4p1:nil="false">ValueHere</CropWidth>
                <CropX d4p1:nil="false">ValueHere</CropX>
                <CropY d4p1:nil="false">ValueHere</CropY>
                <SubType d4p1:nil="false">ValueHere</SubType>
                <TargetHeight d4p1:nil="false">ValueHere</TargetHeight>
                <TargetWidth d4p1:nil="false">ValueHere</TargetWidth>
              </ThumbnailImage>
            </Asset>
            <AssetPerformanceLabel d4p1:nil="false">ValueHere</AssetPerformanceLabel>
            <EditorialStatus d4p1:nil="false">ValueHere</EditorialStatus>
            <PinnedField d4p1:nil="false">ValueHere</PinnedField>
          </AssetLink>
        </Images>
        <ImpressionTrackingUrls d4p1:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
          <a1:string>ValueHere</a1:string>
        </ImpressionTrackingUrls>
        <LongHeadline d4p1:nil="false">
          <Asset d4p1:nil="false" d4p1:type="-- derived type specified here with the appropriate prefix --">
            <Id d4p1:nil="false">ValueHere</Id>
            <Name d4p1:nil="false">ValueHere</Name>
            <Type d4p1:nil="false">ValueHere</Type>
            <!--This field is applicable if the derived type attribute is set to TextAsset-->
            <Text d4p1:nil="false">ValueHere</Text>
            <!--These fields are applicable if the derived type attribute is set to ImageAsset-->
            <CropHeight d4p1:nil="false">ValueHere</CropHeight>
            <CropWidth d4p1:nil="false">ValueHere</CropWidth>
            <CropX d4p1:nil="false">ValueHere</CropX>
            <CropY d4p1:nil="false">ValueHere</CropY>
            <SubType d4p1:nil="false">ValueHere</SubType>
            <TargetHeight d4p1:nil="false">ValueHere</TargetHeight>
            <TargetWidth d4p1:nil="false">ValueHere</TargetWidth>
            <!--These fields are applicable if the derived type attribute is set to VideoAsset-->
            <SubType d4p1:nil="false">ValueHere</SubType>
            <ThumbnailImage d4p1:nil="false">
              <CropHeight d4p1:nil="false">ValueHere</CropHeight>
              <CropWidth d4p1:nil="false">ValueHere</CropWidth>
              <CropX d4p1:nil="false">ValueHere</CropX>
              <CropY d4p1:nil="false">ValueHere</CropY>
              <SubType d4p1:nil="false">ValueHere</SubType>
              <TargetHeight d4p1:nil="false">ValueHere</TargetHeight>
              <TargetWidth d4p1:nil="false">ValueHere</TargetWidth>
            </ThumbnailImage>
          </Asset>
          <AssetPerformanceLabel d4p1:nil="false">ValueHere</AssetPerformanceLabel>
          <EditorialStatus d4p1:nil="false">ValueHere</EditorialStatus>
          <PinnedField d4p1:nil="false">ValueHere</PinnedField>
        </LongHeadline>
        <LongHeadlineString d4p1:nil="false">ValueHere</LongHeadlineString>
        <LongHeadlines d4p1:nil="false">
          <AssetLink>
            <Asset d4p1:nil="false" d4p1:type="-- derived type specified here with the appropriate prefix --">
              <Id d4p1:nil="false">ValueHere</Id>
              <Name d4p1:nil="false">ValueHere</Name>
              <Type d4p1:nil="false">ValueHere</Type>
              <!--This field is applicable if the derived type attribute is set to TextAsset-->
              <Text d4p1:nil="false">ValueHere</Text>
              <!--These fields are applicable if the derived type attribute is set to ImageAsset-->
              <CropHeight d4p1:nil="false">ValueHere</CropHeight>
              <CropWidth d4p1:nil="false">ValueHere</CropWidth>
              <CropX d4p1:nil="false">ValueHere</CropX>
              <CropY d4p1:nil="false">ValueHere</CropY>
              <SubType d4p1:nil="false">ValueHere</SubType>
              <TargetHeight d4p1:nil="false">ValueHere</TargetHeight>
              <TargetWidth d4p1:nil="false">ValueHere</TargetWidth>
              <!--These fields are applicable if the derived type attribute is set to VideoAsset-->
              <SubType d4p1:nil="false">ValueHere</SubType>
              <ThumbnailImage d4p1:nil="false">
                <CropHeight d4p1:nil="false">ValueHere</CropHeight>
                <CropWidth d4p1:nil="false">ValueHere</CropWidth>
                <CropX d4p1:nil="false">ValueHere</CropX>
                <CropY d4p1:nil="false">ValueHere</CropY>
                <SubType d4p1:nil="false">ValueHere</SubType>
                <TargetHeight d4p1:nil="false">ValueHere</TargetHeight>
                <TargetWidth d4p1:nil="false">ValueHere</TargetWidth>
              </ThumbnailImage>
            </Asset>
            <AssetPerformanceLabel d4p1:nil="false">ValueHere</AssetPerformanceLabel>
            <EditorialStatus d4p1:nil="false">ValueHere</EditorialStatus>
            <PinnedField d4p1:nil="false">ValueHere</PinnedField>
          </AssetLink>
        </LongHeadlines>
        <Text d4p1:nil="false">ValueHere</Text>
        <VerifiedTrackingSettings d4p1:nil="false">
          <Details xmlns:e295="http://schemas.datacontract.org/2004/07/System.Collections.Generic" d4p1:nil="false">
            <e295:ArrayOfKeyValuePairOfstringstring>
              <e295:KeyValuePairOfstringstring>
                <e295:key d4p1:nil="false">ValueHere</e295:key>
                <e295:value d4p1:nil="false">ValueHere</e295:value>
              </e295:KeyValuePairOfstringstring>
            </e295:ArrayOfKeyValuePairOfstringstring>
          </Details>
        </VerifiedTrackingSettings>
        <Videos d4p1:nil="false">
          <AssetLink>
            <Asset d4p1:nil="false" d4p1:type="-- derived type specified here with the appropriate prefix --">
              <Id d4p1:nil="false">ValueHere</Id>
              <Name d4p1:nil="false">ValueHere</Name>
              <Type d4p1:nil="false">ValueHere</Type>
              <!--This field is applicable if the derived type attribute is set to TextAsset-->
              <Text d4p1:nil="false">ValueHere</Text>
              <!--These fields are applicable if the derived type attribute is set to ImageAsset-->
              <CropHeight d4p1:nil="false">ValueHere</CropHeight>
              <CropWidth d4p1:nil="false">ValueHere</CropWidth>
              <CropX d4p1:nil="false">ValueHere</CropX>
              <CropY d4p1:nil="false">ValueHere</CropY>
              <SubType d4p1:nil="false">ValueHere</SubType>
              <TargetHeight d4p1:nil="false">ValueHere</TargetHeight>
              <TargetWidth d4p1:nil="false">ValueHere</TargetWidth>
              <!--These fields are applicable if the derived type attribute is set to VideoAsset-->
              <SubType d4p1:nil="false">ValueHere</SubType>
              <ThumbnailImage d4p1:nil="false">
                <CropHeight d4p1:nil="false">ValueHere</CropHeight>
                <CropWidth d4p1:nil="false">ValueHere</CropWidth>
                <CropX d4p1:nil="false">ValueHere</CropX>
                <CropY d4p1:nil="false">ValueHere</CropY>
                <SubType d4p1:nil="false">ValueHere</SubType>
                <TargetHeight d4p1:nil="false">ValueHere</TargetHeight>
                <TargetWidth d4p1:nil="false">ValueHere</TargetWidth>
              </ThumbnailImage>
            </Asset>
            <AssetPerformanceLabel d4p1:nil="false">ValueHere</AssetPerformanceLabel>
            <EditorialStatus d4p1:nil="false">ValueHere</EditorialStatus>
            <PinnedField d4p1:nil="false">ValueHere</PinnedField>
          </AssetLink>
        </Videos>
      </ResponsiveAd>
      <ImageSuggestions d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <AdRecommendationImageSuggestion>
          <AssetLink d4p1:nil="false">
            <Asset d4p1:nil="false" d4p1:type="-- derived type specified here with the appropriate prefix --">
              <Id d4p1:nil="false">ValueHere</Id>
              <Name d4p1:nil="false">ValueHere</Name>
              <Type d4p1:nil="false">ValueHere</Type>
              <!--This field is applicable if the derived type attribute is set to TextAsset-->
              <Text d4p1:nil="false">ValueHere</Text>
              <!--These fields are applicable if the derived type attribute is set to ImageAsset-->
              <CropHeight d4p1:nil="false">ValueHere</CropHeight>
              <CropWidth d4p1:nil="false">ValueHere</CropWidth>
              <CropX d4p1:nil="false">ValueHere</CropX>
              <CropY d4p1:nil="false">ValueHere</CropY>
              <SubType d4p1:nil="false">ValueHere</SubType>
              <TargetHeight d4p1:nil="false">ValueHere</TargetHeight>
              <TargetWidth d4p1:nil="false">ValueHere</TargetWidth>
              <!--These fields are applicable if the derived type attribute is set to VideoAsset-->
              <SubType d4p1:nil="false">ValueHere</SubType>
              <ThumbnailImage d4p1:nil="false">
                <CropHeight d4p1:nil="false">ValueHere</CropHeight>
                <CropWidth d4p1:nil="false">ValueHere</CropWidth>
                <CropX d4p1:nil="false">ValueHere</CropX>
                <CropY d4p1:nil="false">ValueHere</CropY>
                <SubType d4p1:nil="false">ValueHere</SubType>
                <TargetHeight d4p1:nil="false">ValueHere</TargetHeight>
                <TargetWidth d4p1:nil="false">ValueHere</TargetWidth>
              </ThumbnailImage>
            </Asset>
            <AssetPerformanceLabel d4p1:nil="false">ValueHere</AssetPerformanceLabel>
            <EditorialStatus d4p1:nil="false">ValueHere</EditorialStatus>
            <PinnedField d4p1:nil="false">ValueHere</PinnedField>
          </AssetLink>
          <Image d4p1:nil="false">
            <Data d4p1:nil="false">ValueHere</Data>
          </Image>
          <ImageUrl d4p1:nil="false">ValueHere</ImageUrl>
        </AdRecommendationImageSuggestion>
      </ImageSuggestions>
      <VideoSuggestions d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <AdRecommendationVideoSuggestion>
          <Video d4p1:nil="false">
            <AspectRatio d4p1:nil="false">ValueHere</AspectRatio>
            <CreatedDateTimeInUTC d4p1:nil="false">ValueHere</CreatedDateTimeInUTC>
            <Description d4p1:nil="false">ValueHere</Description>
            <DurationInMilliseconds d4p1:nil="false">ValueHere</DurationInMilliseconds>
            <FailureCode d4p1:nil="false">ValueHere</FailureCode>
            <Id d4p1:nil="false">ValueHere</Id>
            <ModifiedDateTimeInUTC d4p1:nil="false">ValueHere</ModifiedDateTimeInUTC>
            <SourceUrl d4p1:nil="false">ValueHere</SourceUrl>
            <Status d4p1:nil="false">ValueHere</Status>
            <ThumbnailUrl d4p1:nil="false">ValueHere</ThumbnailUrl>
            <Url d4p1:nil="false">ValueHere</Url>
          </Video>
        </AdRecommendationVideoSuggestion>
      </VideoSuggestions>
    </CreateResponsiveAdRecommendationResponse>
  </s:Body>
</s:Envelope>

Sintaxis de código

La sintaxis de ejemplo se puede usar con los SDK de Bing Ads. Consulte Ejemplos de código de API de Bing Ads para obtener más ejemplos.

public async Task<CreateResponsiveAdRecommendationResponse> CreateResponsiveAdRecommendationAsync(
	AdSubType? adSubType,
	IList<string> finalUrls,
	string prompt,
	AdRecommendationTextTone? textTone)
{
	var request = new CreateResponsiveAdRecommendationRequest
	{
		AdSubType = adSubType,
		FinalUrls = finalUrls,
		Prompt = prompt,
		TextTone = textTone
	};

	return (await CampaignManagementService.CallAsync((s, r) => s.CreateResponsiveAdRecommendationAsync(r), request));
}

static CreateResponsiveAdRecommendationResponse createResponsiveAdRecommendation(
	ArrayList<AdSubType> adSubType,
	ArrayOfstring finalUrls,
	java.lang.String prompt,
	AdRecommendationTextTone textTone) throws RemoteException, Exception
{
	CreateResponsiveAdRecommendationRequest request = new CreateResponsiveAdRecommendationRequest();

	request.setAdSubType(adSubType);
	request.setFinalUrls(finalUrls);
	request.setPrompt(prompt);
	request.setTextTone(textTone);

	return CampaignManagementService.getService().createResponsiveAdRecommendation(request);
}

static function CreateResponsiveAdRecommendation(
	$adSubType,
	$finalUrls,
	$prompt,
	$textTone)
{

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

	$request = new CreateResponsiveAdRecommendationRequest();

	$request->AdSubType = $adSubType;
	$request->FinalUrls = $finalUrls;
	$request->Prompt = $prompt;
	$request->TextTone = $textTone;

	return $GLOBALS['CampaignManagementProxy']->GetService()->CreateResponsiveAdRecommendation($request);
}

response=campaignmanagement_service.CreateResponsiveAdRecommendation(
	AdSubType=AdSubType,
	FinalUrls=FinalUrls,
	Prompt=Prompt,
	TextTone=TextTone)

Requisitos

Servicio: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13

https://campaign.api.bingads.microsoft.com/CampaignManagement/v13/ResponsiveAdRecommendation/Create

https://campaign.api.sandbox.bingads.microsoft.com/CampaignManagement/v13/ResponsiveAdRecommendation/Create

Elementos Request

El objeto CreateResponsiveAdRecommendationRequest define los elementos body y header de la solicitud de operación de servicio.

Nota:

A menos que se indique lo contrario a continuación, se requieren todos los elementos de solicitud.

Elementos del cuerpo de la solicitud

Elemento	Descripción	Tipo de datos
AdSubType	Subtipo de anuncio opcional para el que crear una recomendación.	AdSubType
FinalUrls	Matriz de direcciones URL de las páginas web usadas para crear recursos de anuncios recomendados.	matriz de cadenas
Prompt	Descripción opcional del producto o servicio al que desea dirigirse con la campaña específica.	string
TextTone	Tono opcional para los recursos de texto recomendados	AdRecommendationTextTone

Elementos de encabezado de solicitud

Elemento	Descripción	Tipo de datos
Autorización	Token de acceso de OAuth que representa las credenciales de un usuario que tiene permisos para cuentas de Microsoft Advertising. Asegúrese de que el token tiene el prefijo "Portador", esto es necesario para la autenticación adecuada. Para obtener más información, consulte Autenticación con OAuth.	string
CustomerAccountId	Identificador de la cuenta de anuncio que posee o está asociada a las entidades de la solicitud. Este elemento de encabezado debe tener el mismo valor que el elemento de cuerpo AccountId cuando ambos son necesarios. Este elemento es necesario para la mayoría de las operaciones de servicio y, como procedimiento recomendado, siempre debe establecerlo. Para obtener más información, consulte Obtención de su cuenta e identificadores de cliente.	string
CustomerId	Identificador de la cuenta de administrador (cliente) desde la que el usuario accede o funciona. Un usuario puede tener acceso a varias cuentas de administrador. Este elemento es necesario para la mayoría de las operaciones de servicio y, como procedimiento recomendado, siempre debe establecerlo. Para obtener más información, consulte Obtención de su cuenta e identificadores de cliente.	string
DeveloperToken	Token de desarrollador que se usa para acceder a Bing Ads API. Para obtener más información, consulte Obtención de un token de desarrollador.	string
Password	Este elemento está reservado para uso interno y se quitará de una versión futura de la API. Debe usar el elemento AuthenticationToken para establecer las credenciales de usuario.	string
UserName	Este elemento está reservado para uso interno y se quitará de una versión futura de la API. Debe usar el elemento AuthenticationToken para establecer las credenciales de usuario.	string

Elementos de respuesta

Elementos del cuerpo de la respuesta

Elemento	Descripción	Tipo de datos
ImageSuggestions	Una matriz de imágenes recomendadas para incluirse en el anuncio con capacidad de respuesta.	Matriz AdRecommendationImageSuggestion
ResponsiveAd	Objeto de anuncio con capacidad de respuesta que contiene los recursos de texto recomendados.	ResponsiveAd
VideoSuggestions	Una matriz de vídeos recomendados para incluirse en el anuncio con capacidad de respuesta.	Matriz AdRecommendationVideoSuggestion

Elementos de encabezado de respuesta

Elemento	Descripción	Tipo de datos
Seguimiento del Id.	Identificador de la entrada de registro que contiene los detalles de la llamada API.	string

Solicitud de JSON

Esta plantilla se generó mediante una herramienta para mostrar los elementos body y header de la solicitud JSON. Para ver los tipos admitidos que puede usar con esta operación de servicio, consulte la referencia de elementos de cuerpo de solicitud anterior.

{
  "AdSubType": "ValueHere",
  "FinalUrls": [
    "ValueHere"
  ],
  "Prompt": "ValueHere",
  "TextTone": "ValueHere"
}

JSON de respuesta

Esta plantilla se generó mediante una herramienta para mostrar los elementos body y header de la respuesta JSON.

A continuación se muestra un ejemplo que es aplicable si el tipo de recurso es ImageAsset.

{
  "ResponsiveAd": {
    "AdSubType": "ValueHere",
    "BusinessName": "ValueHere",
    "CallToAction": "ValueHere",
    "CallToActionLanguage": "ValueHere",
    "Descriptions": [
      {
        "Asset": {
          "Id": "LongValueHere",
          "Name": "ValueHere",
          "Type": "ImageAsset",
          "CropHeight": IntValueHere,
          "CropWidth": IntValueHere,
          "CropX": IntValueHere,
          "CropY": IntValueHere,
          "SubType": "ValueHere",
          "TargetHeight": IntValueHere,
          "TargetWidth": IntValueHere
        },
        "AssetPerformanceLabel": "ValueHere",
        "EditorialStatus": "ValueHere",
        "PinnedField": "ValueHere"
      }
    ],
    "Headline": "ValueHere",
    "Headlines": [
      {
        "Asset": {
          "Id": "LongValueHere",
          "Name": "ValueHere",
          "Type": "ImageAsset",
          "CropHeight": IntValueHere,
          "CropWidth": IntValueHere,
          "CropX": IntValueHere,
          "CropY": IntValueHere,
          "SubType": "ValueHere",
          "TargetHeight": IntValueHere,
          "TargetWidth": IntValueHere
        },
        "AssetPerformanceLabel": "ValueHere",
        "EditorialStatus": "ValueHere",
        "PinnedField": "ValueHere"
      }
    ],
    "Images": [
      {
        "Asset": {
          "Id": "LongValueHere",
          "Name": "ValueHere",
          "Type": "ImageAsset",
          "CropHeight": IntValueHere,
          "CropWidth": IntValueHere,
          "CropX": IntValueHere,
          "CropY": IntValueHere,
          "SubType": "ValueHere",
          "TargetHeight": IntValueHere,
          "TargetWidth": IntValueHere
        },
        "AssetPerformanceLabel": "ValueHere",
        "EditorialStatus": "ValueHere",
        "PinnedField": "ValueHere"
      }
    ],
    "ImpressionTrackingUrls": [
      "ValueHere"
    ],
    "LongHeadline": {
      "Asset": {
        "Id": "LongValueHere",
        "Name": "ValueHere",
        "Type": "ImageAsset",
        "CropHeight": IntValueHere,
        "CropWidth": IntValueHere,
        "CropX": IntValueHere,
        "CropY": IntValueHere,
        "SubType": "ValueHere",
        "TargetHeight": IntValueHere,
        "TargetWidth": IntValueHere
      },
      "AssetPerformanceLabel": "ValueHere",
      "EditorialStatus": "ValueHere",
      "PinnedField": "ValueHere"
    },
    "LongHeadlines": [
      {
        "Asset": {
          "Id": "LongValueHere",
          "Name": "ValueHere",
          "Type": "ImageAsset",
          "CropHeight": IntValueHere,
          "CropWidth": IntValueHere,
          "CropX": IntValueHere,
          "CropY": IntValueHere,
          "SubType": "ValueHere",
          "TargetHeight": IntValueHere,
          "TargetWidth": IntValueHere
        },
        "AssetPerformanceLabel": "ValueHere",
        "EditorialStatus": "ValueHere",
        "PinnedField": "ValueHere"
      }
    ],
    "LongHeadlineString": "ValueHere",
    "Text": "ValueHere",
    "VerifiedTrackingSettings": {
      "Details": [
        {
          "key": "ValueHere",
          "value": "ValueHere"
        }
      ]
    },
    "Videos": [
      {
        "Asset": {
          "Id": "LongValueHere",
          "Name": "ValueHere",
          "Type": "ImageAsset",
          "CropHeight": IntValueHere,
          "CropWidth": IntValueHere,
          "CropX": IntValueHere,
          "CropY": IntValueHere,
          "SubType": "ValueHere",
          "TargetHeight": IntValueHere,
          "TargetWidth": IntValueHere
        },
        "AssetPerformanceLabel": "ValueHere",
        "EditorialStatus": "ValueHere",
        "PinnedField": "ValueHere"
      }
    ]
  },
  "ImageSuggestions": [
    {
      "AssetLink": {
        "Asset": {
          "Id": "LongValueHere",
          "Name": "ValueHere",
          "Type": "ImageAsset",
          "CropHeight": IntValueHere,
          "CropWidth": IntValueHere,
          "CropX": IntValueHere,
          "CropY": IntValueHere,
          "SubType": "ValueHere",
          "TargetHeight": IntValueHere,
          "TargetWidth": IntValueHere
        },
        "AssetPerformanceLabel": "ValueHere",
        "EditorialStatus": "ValueHere",
        "PinnedField": "ValueHere"
      },
      "Image": {
        "Data": "ValueHere"
      },
      "ImageUrl": "ValueHere"
    }
  ],
  "VideoSuggestions": [
    {
      "Video": {
        "AspectRatio": "ValueHere",
        "CreatedDateTimeInUTC": "ValueHere",
        "Description": "ValueHere",
        "DurationInMilliseconds": IntValueHere,
        "FailureCode": "ValueHere",
        "Id": "LongValueHere",
        "ModifiedDateTimeInUTC": "ValueHere",
        "SourceUrl": "ValueHere",
        "Status": "ValueHere",
        "ThumbnailUrl": "ValueHere",
        "Url": "ValueHere"
      }
    }
  ]
}

Sintaxis de código

Para llamar a la API REST a través de SDK, debe actualizar el SDK a una versión determinada y configurar los parámetros del sistema. La sintaxis de ejemplo se puede usar con los SDK de Bing Ads. Consulte Ejemplos de código de API de Bing Ads para obtener más ejemplos.

public async Task<CreateResponsiveAdRecommendationResponse> CreateResponsiveAdRecommendationAsync(
	AdSubType? adSubType,
	IList<string> finalUrls,
	string prompt,
	AdRecommendationTextTone? textTone)
{
	var request = new CreateResponsiveAdRecommendationRequest
	{
		AdSubType = adSubType,
		FinalUrls = finalUrls,
		Prompt = prompt,
		TextTone = textTone
	};

	return (await CampaignManagementService.CallAsync((s, r) => s.CreateResponsiveAdRecommendationAsync(r), request));
}

static CreateResponsiveAdRecommendationResponse createResponsiveAdRecommendation(
	ArrayList<AdSubType> adSubType,
	ArrayOfstring finalUrls,
	java.lang.String prompt,
	AdRecommendationTextTone textTone) throws RemoteException, Exception
{
	CreateResponsiveAdRecommendationRequest request = new CreateResponsiveAdRecommendationRequest();

	request.setAdSubType(adSubType);
	request.setFinalUrls(finalUrls);
	request.setPrompt(prompt);
	request.setTextTone(textTone);

	return CampaignManagementService.getService().createResponsiveAdRecommendation(request);
}

static function CreateResponsiveAdRecommendation(
	$adSubType,
	$finalUrls,
	$prompt,
	$textTone)
{

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

	$request = new CreateResponsiveAdRecommendationRequest();

	$request->AdSubType = $adSubType;
	$request->FinalUrls = $finalUrls;
	$request->Prompt = $prompt;
	$request->TextTone = $textTone;

	return $GLOBALS['CampaignManagementProxy']->GetService()->CreateResponsiveAdRecommendation($request);
}

response=campaignmanagement_service.CreateResponsiveAdRecommendation(
	AdSubType=AdSubType,
	FinalUrls=FinalUrls,
	Prompt=Prompt,
	TextTone=TextTone)

Compartir vía

Operación del servicio CreateResponsiveAdRecommendation: Administración de campañas

Elementos Request

Elementos del cuerpo de la solicitud

Elementos de encabezado de solicitud

Elementos de respuesta

Elementos del cuerpo de la respuesta

Elementos de encabezado de respuesta

Solicitud de SOAP

SOAP de respuesta

Sintaxis de código

Requisitos

Dirección URL de solicitud

Elementos Request

Elementos del cuerpo de la solicitud

Elementos de encabezado de solicitud

Elementos de respuesta

Elementos del cuerpo de la respuesta

Elementos de encabezado de respuesta

Solicitud de JSON

JSON de respuesta

Sintaxis de código

Comentarios

Recursos adicionales