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