資産グループリスト グループ レコード - 一括
一括ファイルでアップロードおよびダウンロードできる資産グループ一覧グループを定義します。
次に説明するように検証規則が満たされている限り、同じ一括ファイル内の複数の広告グループの アセット グループ登録情報グループ レコードをアップロードできます。
少なくとも、製品パーティション グループ ツリー構造のルート ノードを少なくとも指定する必要があります。 製品パーティション グループのルート ノードには、 Product Condition 1 フィールドが "All" に設定され、 Product Value 1 が null または空である必要があります。 カタログ内のすべての製品に均等に入札する場合は、[ サブタイプ ] フィールドを [単位] に設定します。 特定の製品条件に基づいて入札をパーティション分割する場合は、[ サブタイプ ] フィールドを [サブディビジョン] に、 親基準 ID を null または空に、 ID を 負の値に設定します。 負の値は、任意の子ノードの 親基準 ID として使用します。
ルート ノードはレベル 0 と見なされ、ツリーの深さは最大 7 レベルまで分岐できます。
アップロード要求ごとに、広告グループごとに最大 20,000 個の製品パーティション ツリー ノードを含めることができます。 広告グループの製品パーティション ツリー ノードの数全体が 20,000 を超えることはできません。
同じツリー (同じ広告グループ) の製品パーティション ツリー ノードは、ファイル内でグループ化する必要があります。
製品パーティション ノードの順序はダウンロード中に保証されず、親ノードは子ノードの後に提供される場合があります。ただし、同じ広告グループのすべてのノードがファイルにグループ化されます。
ツリー構造を作成または変更する場合は、親製品パーティション ツリー ノードを子製品パーティション ツリー ノードの前に並べ替える必要があります。ただし、注文は、入札の更新などの構造以外の変更には関係ありません。 たとえば、ツリー構造を追加、削除、更新せずに入札を更新する場合は、 ID、 親 ID、 入札 フィールドのみをアップロードする必要があります。
[Product Condition 1]、[Product Value 1]、[Is Excluded]\(製品条件 1\) フィールドを更新するには、既存の製品パーティション ツリー ノードを削除し、新しい製品パーティション ツリー ノードをアップロードして、新しい識別子を取得する必要があります。
いずれかのアクションが失敗した場合、それ以外の場合に成功した可能性がある残りのアクションもすべて失敗します。
すべての製品パーティション ノードの追加および削除アクションは、完全なツリー構造になる必要があります。
ルート ノードからブランチの末尾までのすべてのパスは、リーフ ノード (Sub Type=Unit) で終了する必要があります。 [除外される] フィールド が TRUE でない限り、すべてのユニットに入札が必要です。これは、ノードが負の広告グループ条件であることを意味します。
各サブディビジョンには、サブディビジョンの条件の残りの部分に入札するリーフ ノードが少なくとも 1 つ必要です。つまり、その兄弟単位と同じオペランドを使用し、 Product Value 1 null または empty を設定します。
親と子の両方がまだ存在しない複数のレベルのパーティションを追加する場合は、負の int 値を参照として使用して親を識別します。 たとえば、親の ID と子の 親基準 ID フィールドの両方を同じ負の値に設定します。 負の ID は、呼び出しの期間中のみ有効です。 正常に追加された広告グループの条件ごとに一意のシステム識別子がアップロード結果ファイルに返されます。
製品パーティションを一時停止するには、広告グループの [状態] フィールドを [一時停止] に更新して 、広告グループ 全体を一時停止する必要があります。 キャンペーン全体を一時停止するには、[キャンペーン] の [状態] フィールドを [一時停止] に更新します。
削除済みアクションの場合は、ID と親 ID のみを指定する必要があります。
親製品パーティションを削除すると、そのすべての子と子孫も削除されます。
ブランチで重複する製品条件を指定することはできません。
DownloadCampaignsByAccountIds またはDownloadCampaignsByCampaignIds サービス要求に AssetGroupListingGroups の DownloadEntity 値を含めることで、アカウント内のすべての資産グループ 登録情報グループ レコードをダウンロードできます。 さらに、ダウンロード要求には EntityData スコープを含める必要があります。 ベスト プラクティスを含む一括サービスの詳細については、「 一括ダウンロードとアップロード」を参照してください。
.NET、Java、または Python 用 の Bing Ads SDK を 使用している場合は、 BulkServiceManager を使用して BulkAssetGroupListingGroup オブジェクトを アップロードしてダウンロードする時間を節約できます。サービス操作を直接呼び出し、カスタム コードを記述して一括ファイル内の各フィールドを解析する代わりにします。
資産グループ リスト グループ レコードの場合、一括ファイル スキーマでは、次の属性フィールドを使用できます。
資産グループ
資産グループ一覧グループが属する資産グループの名前。
追加、更新、削除を行うには、[ 親 ID] フィールドまたは [ アセット グループ と キャンペーン ] フィールドを指定する必要があります。
追加： 読み取り専用と必須
更新： 読み取り専用と必須
削除： 読み取り専用と必須
キャンペーン
資産グループと登録情報グループを含むキャンペーンの名前。
追加、更新、削除を行うには、[ 親 ID] フィールドまたは [ アセット グループ と キャンペーン ] フィールドを指定する必要があります。
追加： 読み取り専用と必須
更新： 読み取り専用と必須
削除： 読み取り専用と必須
クライアント ID
一括アップロード ファイル内のレコードを結果ファイル内のレコードに関連付けるために使用されます。 このフィールドの値は、サーバーによって使用または格納されません。アップロードされたレコードから対応する結果レコードにコピーされます。 最大 100 の長さの任意の有効な文字列を指定できます。
追加： オプション
更新： オプション
削除： 読み 取り 専用
Id
資産グループ一覧グループのシステム生成識別子。
追加： オプション。 このフィールドは空のままにするか、負の識別子を指定する必要があります。 その後、資産グループ登録情報グループに対して設定された負の識別子は、広告、キーワード、条件などの依存レコードタイプの [親 ID] フィールドで参照できます。 これは、同じ Bulk ファイルに新しい資産グループ一覧グループと新しい依存レコードを追加する場合に推奨されます。 詳細については、「 一括ファイル スキーマ参照キー」を参照してください。
更新： 読み取り専用と必須
削除： 読み取り専用と必須
除外されます
サービスを提供するときに、製品がリスト グループに属しているかどうかを除外するかどうかを決定します。
true に設定すると負の条件になり、false の場合は正の条件になります。
追加： 必須
更新： 読み 取り 専用
削除： 読み 取り 専用
変更時刻
エンティティが最後に更新された日付と時刻。 値は、世界協定時刻 (UTC) です。
注:
日付と時刻の値は、クライアントではなく、サーバーでの日付と時刻を反映します。 日付と時刻の形式については、「 プリミティブ XML データ型」の dateTime エントリを参照してください。
追加： 読み 取り 専用
更新： 読み 取り 専用
削除： 読み 取り 専用
Parent Id
リスト グループを含む資産グループの ID。
追加、更新、削除を行うには、[ 親 ID ] フィールドまたは [ アセット グループ ] フィールドと [キャンペーン ] フィールドを指定する必要があります。
追加： 読み取り専用と必須
更新： 読み取り専用と必須
削除： 読み取り専用と必須
親リスト グループ ID
少なくとも、ツリー構造のルート ノードを少なくとも指定する必要があります。
登録情報グループのルート ノードの [Product Condition 1]\(製品条件 1\) フィールドを [すべて ] と [Product Value 1]\(製品値 1 \) に null または 空に設定する必要があります。
カタログ内のすべての製品に均等に入札する場合は、[サブタイプ] フィールドを [単位] に設定します。
より具体的な製品条件に基づいて製品をパーティション分割する場合は、[サブタイプ] フィールドを [サブ分類] に、親登録情報グループ ID を null または 空に設定し、ID を負の値に設定します。 負の値は、任意の子ノードの親リスト グループ ID として使用します。
追加： 必須
更新： 読み取り専用と必須
削除： 読み取り専用と必須
製品条件 1
条件のオペランド。 オペランドには、equal 演算子が暗黙的に含まれます。 たとえば、「 Brand as Brand=」と読むことができます。
Product Value 1 のオペランドとして Product Condition 1 を使用します。
Microsoft Performance Max 資産グループごとに、複数の製品条件を指定できます。 各条件は、製品の属性値がオペランドの属性値と等しい場合に満たされます。 たとえば、オペランドが Brand に設定され、属性が Contoso に設定されている場合、製品カタログの Brand 属性の値が Contoso と等しい場合、条件が満たされます。
Performance Max キャンペーンでは、製品条件は資産グループ レベルでのみ設定できます。 次の表では、 資産グループ AssetGroupListingGroup オブジェクトの製品条件 (オペランド) と Product Value (属性) ビジネス ルールについて説明します。
| 製品条件 (オペランド) | 製品値 (属性) 説明 | 資産グループの製品パーティションルール |
|---|---|---|
| すべて | null にする必要があります。 | 資産グループの製品パーティションの場合、ルート ノードはオペランドを All に設定し、属性を null または空に設定する必要があります。 |
| ブランド | 製品の製造元、ブランド、または発行元。 最大 1,000 文字。 |
資産グループの製品パーティションの場合、ルート ノードはオペランドを All に設定し、属性を null または空に設定する必要があります。 |
| CategoryL1-5 CategoryL1、CategoryL2、CategoryL3、CategoryL4、CategoryL5 の 5 つのカテゴリ オペランド値を使用できます。 |
Microsoft Merchant Center ストアによって定義された製品カテゴリ。 有効な カテゴリ 値と分類については、Bingカテゴリ分類に関するページを参照してください。 CategoryL0 は最上位のカテゴリで、CategoryL4 は最も低いレベルまたは最も詳細なカテゴリです。 最大 100 文字。 |
CategoryL オペランドのそれぞれは、複数のブランチで使用できます。 CategoryL オペランドはそれぞれ複数のブランチで使用できますが、ブランチごとに 1 回だけ指定できます。 たとえば、あるブランチには CategoryL1 と CategoryL2 が含まれている場合がありますが、CategoryL2 オペランドを持つ別のノードが含まれていない場合があります。 オペランドを 1 から 5 までの製品カテゴリに設定する場合は、昇順で指定する必要があります。 たとえば、上位レベルの製品パーティションに属性 Animals & Pet Supplies を持つオペランド CategoryL1 がある場合、オペランドは属性 Pet Supplies で CategoryL2 に設定できます。 前のレベルの製品カテゴリ オペランドは、直接の親パーティションで指定する必要はありません。 たとえば、親の親が CategoryL1 条件を指定した場合、製品パーティションに CategoryL2 条件を指定できます。 |
| チャネル | ローカル インベントリ広告 (LIA) チャネル。 使用可能な値には、"ローカル ストア" と "オンライン" があります。 キャンペーンが ローカル インベントリ広告にオプトインしていない場合、すべてのオファーは既定でオンラインのみ (Channel=Online) と単一チャネル (ChannelExclusivity=単一チャネル) になります。 詳細については、 ローカル インベントリ広告 のヘルプ ページを参照してください。 |
Channel オペランドは複数のブランチで使用できますが、ブランチごとに 1 回だけ指定できます。 |
| ChannelExclusivity | ローカル インベントリ広告 (LIA) チャネルの排他性。 指定できる値には、"単一チャネル" と "マルチチャネル" があります。 キャンペーンが ローカル インベントリ広告にオプトインしていない場合、すべてのオファーは既定でオンラインのみ (Channel=Online) と単一チャネル (ChannelExclusivity=単一チャネル) になります。 詳細については、 ローカル インベントリ広告 のヘルプ ページを参照してください。 |
ChannelExclusivity オペランドは複数のブランチで使用できますが、ブランチごとに 1 回だけ指定できます。 |
| 条件 | 製品の条件。 オペランドが Condition に設定されている場合、指定できるサポートされる属性値は New、 Used、および Refurbished です。 |
Condition オペランドは複数のブランチで使用できますが、ブランチごとに 1 回だけ指定できます。 |
| CustomLabel0-4 CustomLabel0、CustomLabel1、CustomLabel2、CustomLabel3、CustomLabel4 など、5 つのカスタム ラベル オペランド値を使用できます。 |
マーチャントによって定義されたカスタム ラベル。 CustomLabel0 や CustomLabel4 などのカスタム ラベルは、どの階層にも基づいて検証されません。 最大 100 文字。 |
各 CustomLabel オペランドは複数のブランチで使用できますが、ブランチごとに 1 回だけ指定できます。 たとえば、あるブランチには CustomLabel0 と CustomLabel1 が含まれている場合がありますが、CustomLabel1 オペランドを持つ別のノードは含まれません。 |
| Id | マーチャントによって定義された製品識別子。 最大 1,000 文字。 |
Id オペランドは複数のブランチで使用できますが、ブランチごとに 1 回だけ指定できます。 |
| ProductType1-5 ProductType1、ProductType2、ProductType3、ProductType4、ProductType5 の 5 つの製品型オペランド値を使用できます。 |
マーチャントによって定義された製品の種類またはカテゴリ。 ProductType1 は最高レベルの製品タイプで、ProductType5 は最も低いレベルまたは最も細かい製品の種類です。 最大 100 文字。 |
各 ProductType オペランドは複数のブランチで使用できますが、ブランチごとに 1 回だけ指定できます。 たとえば、1 つのブランチに ProductType1 と ProductType2 が含まれている場合がありますが、 ProductType2 オペランドを持つ別のノードが含まれていない場合があります。 オペランドを 1 から 5 までの製品の種類に設定する場合は、昇順で指定する必要があります。 たとえば、上位レベルの製品パーティションに属性 Animals & Pet Supplies を持つオペランド ProductType1 がある場合は、オペランドを属性 Pet Supplies で ProductType2 に設定できます。 前のレベルの積の種類のオペランドは、直接の親パーティションで指定する必要はありません。 たとえば、親の親が ProductType1 条件を指定した場合、 ProductType2 条件を製品パーティションに指定できます。 |
追加： 必須
更新： 読み 取り 専用。 条件フィールドまたは値フィールドを更新することはできません。 条件を更新するには、製品パーティションを削除し、新しいパーティションを追加する必要があります。
削除： 読み 取り 専用
製品価値 1
条件の属性値。
属性の値は、顧客の Microsoft Merchant Center カタログ ファイルで指定された値と完全に一致している必要があります。
追加： 必須
更新： 読み 取り 専用。 条件フィールドまたは値フィールドを更新することはできません。 条件を更新するには、製品パーティションを削除し、新しいパーティションを追加する必要があります。
削除： 読み 取り 専用
状態
資産グループ一覧グループの状態。
使用可能な値は [アクティブ]、[ 削除済み]です。
追加： オプション。
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 必須。 [状態] を [削除済み] に設定する必要があります。
Sub Type
資産グループ登録情報グループの種類。
可能な値は 、サブディビジョン と ユニットです。
追加： 必須
更新： 読み 取り 専用
削除： 読み 取り 専用