ImportJob データ オブジェクト - キャンペーン管理

  • [アーティクル]

インポート ジョブの基本オブジェクトを定義します。

注:

  • 拡張テキスト広告を、2023 年 2 月 1 日までにレスポンシブ検索広告にアップグレードします。 この日付を過ぎると、新しいテキスト広告を作成したり、既存の拡張テキスト広告を編集したりできなくなります。 詳細については、「 レスポンシブ検索広告について」を参照してください。
  • 既存の拡張テキスト広告は引き続き配信され、そのパフォーマンスに関するレポートを表示できます。
  • 拡張テキスト広告は引き続き一時停止、有効化、または削除できます。
  • この変更の詳細については、こちらをご覧ください。

ImportJob をインスタンス化しないでください。 次のオブジェクトから派生する 1 つ以上のオブジェクトを作成できます。

構文

<xs:complexType name="ImportJob" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="CreatedByUserId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="CreatedByUserName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="CreatedDateTimeInUTC" nillable="true" type="xs:dateTime" />
    <xs:element minOccurs="0" name="Frequency" nillable="true" type="tns:Frequency" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="ImportOption" nillable="true" type="tns:ImportOption" />
    <xs:element minOccurs="0" name="LastRunTimeInUTC" nillable="true" type="xs:dateTime" />
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="NotificationEmail" nillable="true" type="xs:string">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="NotificationType" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Type" nillable="true" type="xs:string" />
  </xs:sequence>
</xs:complexType>

要素

ImportJob オブジェクトには、CreatedByUserId、CreatedByUserName、CreatedDateTimeInUTC、Frequency、Id、ImportOption、LastRunTimeInUTC、Name、NotificationEmail、NotificationType、Status、Type という要素があります。

要素 説明 データ型
CreatedByUserId インポート ジョブを作成した Microsoft Advertising ユーザーの一意識別子。 long
CreatedByUserName インポート ジョブを作成した Microsoft Advertising ユーザーのログイン ユーザー名。 string
CreatedDateTimeInUTC インポート ジョブが作成された日時。

日付と時刻は協定世界時 (UTC) で表されます。		 dateTime
Frequency インポート ジョブを 1 回実行するか、定期的にスケジュールするかを決定します。

インポート ジョブを今すぐ実行するには、この要素を nil または空にする必要があります。		 Frequency
Id インポート ジョブの一意の Microsoft Advertising 識別子。 long
ImportOption API を使用して使用できるインポート オプション。 ImportOption
LastRunTimeInUTC このジョブの最新のインポート日時。

日付と時刻は協定世界時 (UTC) で表されます。		 dateTime
名前 インポート ジョブの名前 string
NotificationEmail インポート結果を送信する電子メール アドレス。

この要素は既定では返されません。 この要素を取得するには、 GetImportJobsByIds および GetImportResults サービス操作を呼び出すときに、ReturnAdditionalFields 要素に NotificationEmail 値 を 含めます。		 string
NotificationType インポート ジョブの結果に関する電子メール通知を受信するかどうかを決定します。 string
Status インポート ジョブの状態。

使用可能な値は 、アクティブ、 一時停止 、 削除です。 スケジュールされたインポートは、ジョブが 1 回スケジュールされているか、将来定期的にスケジュールされているかに関係なく、 アクティブ な状態になります。 一時停止されたインポート ジョブの状態は [一時停止] になります。 1 回だけ実行されるインポート ジョブの状態は、インポート後に [削除済み] に設定されます。

追加： 読み 取り 専用
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。		 string
型 インポート ジョブの種類。

インポート ジョブの種類の詳細については、「 解説」を参照してください。		 string

注釈

SOAP を手動で生成する場合は、次の例に示すようにノードの <ImportJob>type 属性を使用して、インポート スケジュールの種類を指定します。

<ImportJob i:type="GoogleImportJob" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
    <Id i:nil="true" />
    <Status i:nil="true" />
      . . .
</ImportJob>

要件

サービス: CampaignManagementService.svc v13
名前 空間： https://bingads.microsoft.com/CampaignManagement/v13

Used By

AddImportJobs
GetImportJobsByIds
ImportResult
UpdateImportJobs